Assistant Panel

The assistant panel provides you with a way to interact with large language models. The assistant is useful for various tasks, such as generating code, asking questions about existing code, and even writing plaintext, such as emails and documentation.

To open the assistant panel, toggle the right dock by using the workspace: toggle right dock action in the command palette or by using the cmd-r|ctrl-alt-b shortcut.

Note: A custom key binding can be set to toggle the right dock.

Once you have configured a provider, you can interact with the provider's language models in a context editor.

To create a new context editor, press cmd-n|ctrl-n or use the menu in the top right of the assistant panel and select the New Context option.

In the context editor, select a model from one of the configured providers, type a message in the You block, and submit with cmd-enter|ctrl-enter.

Interacting with the Assistant

The context editor in Zed functions similarly to any other editor. You can use custom key bindings and work with multiple cursors, allowing for seamless transitions between coding and engaging in discussions with the language models.

However, the assistant editor differs with the inclusion of message blocks. These blocks serve as containers for text that correspond to different roles within the context. These roles include:

• You
• Assistant
• System

To begin, select a model and type a message in a You block.

As you type, the remaining tokens count for the selected model is updated.

Inserting text from an editor is as simple as highlighting the text and running assistant: quote selection (cmd->|ctrl->); Zed will wrap it in a fenced code block if it is code.

To submit a message, use cmd-enter|ctrl-enter(assistant: assist). Unlike typical chat applications where pressing enter would submit the message, in the assistant editor, our goal was to make it feel as close to a regular editor as possible. So, pressing enter|enter simply inserts a new line.

After submitting a message, the assistant's response will be streamed below, in an Assistant message block.

The stream can be canceled at any point with escape. This is useful if you realize early on that the response is not what you were looking for.

If you want to start a new conversation at any time, you can hit cmd-n|ctrl-n or use the New Context menu option in the hamburger menu at the top left of the panel.

Simple back-and-forth conversations work well with the assistant. However, there may come a time when you want to modify the previous text in the conversation and steer it in a different direction.

Editing a Context

Note: Wondering about Context vs. Conversation? Read more here.

The assistant gives you the flexibility to have control over the context. You can freely edit any previous text, including the responses from the assistant. If you want to remove a message block entirely, simply place your cursor at the beginning of the block and use the delete key. A typical workflow might involve making edits and adjustments throughout the context to refine your inquiry or provide additional information. Here's an example:

1. Write text in a You block.
2. Submit the message with cmd-enter|ctrl-enter.
3. Receive an Assistant response that doesn't meet your expectations.
4. Cancel the response with escape.
5. Erase the content of the Assistant message block and remove the block entirely.
6. Add additional context to your original message.
7. Submit the message with cmd-enter|ctrl-enter.

Being able to edit previous messages gives you control over how tokens are used. You don't need to start up a new context to correct a mistake or to add additional information, and you don't have to waste tokens by submitting follow-up corrections.

Note: The act of editing past messages is often referred to as "Rewriting History" in the context of the language models.

Some additional points to keep in mind:

• You are free to change the model type at any point in the conversation.
• You can cycle the role of a message block by clicking on the role, which is useful when you receive a response in an Assistant block that you want to edit and send back up as a You block.