From 7e065aedec7f0b8857ae71b92b0ad6d2c5cf4fa9 Mon Sep 17 00:00:00 2001
From: Danilo Leal <67129314+danilo-leal@users.noreply.github.com>
Date: Wed, 28 Jan 2026 17:03:45 -0300
Subject: [PATCH] docs: Update AI docs with new features that went out (#47898)

Release Notes:

- N/A
---
 docs/src/ai/agent-panel.md | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/docs/src/ai/agent-panel.md b/docs/src/ai/agent-panel.md
index f17d09891dd696699ef5c1687ed2233fdf596428..75b4e32b859776ef72c624cda1cdb26b6f598cf2 100644
--- a/docs/src/ai/agent-panel.md
+++ b/docs/src/ai/agent-panel.md
@@ -36,8 +36,12 @@ You can click on the card that contains your message and re-submit it with an ad
 
 ### Queueing Messages
 
-If you want to queue a message while the agent is going through a generation, you can do so through the `cmd/ctrl-shift-enter` keybinding.
-A queued up message gets sent as soon as the current generation wraps up.
+Messages sent while the agent is in the generating state get, by default, queued.
+
+For the Zed agent, queued messages get sent at the next turn boundary, which is usually between a tool call and a response, whereas for external agents, the message gets sent at the end of the generation.
+
+You can edit or remove (an individual or all) queued messages.
+You can also still interrupt the agent immediately if you want by either clicking on the stop button or by clicking the "Send Now" (double-enter) on a queued message.
 
 ### Checkpoints {#checkpoints}
 
@@ -156,6 +160,8 @@ Zed's Agent Panel surfaces the `agent.always_allow_tool_actions` setting that, i
 
 You can change that by setting this key to `true` in either your `settings.json` or via the Agent Panel's settings view.
 
+You can also give more granular permissions through the dropdown that appears in the UI whenever the agent requests authorization to run a tool call.
+
 ### Model Support {#model-support}
 
 Tool calling needs to be individually supported by each model and model provider.