How to edit your agent's prompt with the Brief

The Brief is an assistant inside your agent's configuration. Tell it what to include in your prompt, with your own words, and it writes the new version for you. If you already wrote a prompt in the editor, nothing changes until you apply what was proposed.

Step 1: Open the Brief

In your agent's configuration, open the floating Brief panel. Under its name, the panel shows which part of the agent it's working on, for example Talking about: Prompt. In that case, when you talk about the prompt, the Brief takes you to Main › Prompt and highlights it.

Step 2: Ask for the change

Write what you want in the Type your answer… box, as you would ask a teammate. For example: "Rewrite the prompt: ask for the name and phone number before booking, and don't give prices."

You can also record a voice note. The Brief transcribes it and shows you the text before it sends anything, so you can fix it first.

Step 3: Review the proposal

The Brief answers with a Proposed by Brief card that shows the new prompt. Read it before you apply it. From the card, you can:

• Apply the new prompt.

• Request changes, and the Brief adjusts the proposal.

• Dismiss, and nothing changes.

• Go to field, to see the prompt the agent has now.

Step 4: Apply the change

Click Apply. If your agent already has a prompt, the Brief asks you to confirm because the new version replaces it. Click Replace prompt to continue.

The card changes to Applied, and your agent starts using the new prompt.

Common problems

Done

Your agent now uses the updated prompt. Test it with a few real questions to verify the adjustments. To start a new conversation with the Brief, use Start over at the top of the panel. It resets the conversation, not your prompt.