From d403422ddbc6df5eceb9d13d4471e6ed879b713b Mon Sep 17 00:00:00 2001
From: Pavlinchen <69079839+Pavlinchen@users.noreply.github.com>
Date: Mon, 15 Jun 2026 14:04:32 +0200
Subject: [PATCH] docs(context_agent): document the 11 missing Talk tools

The context_agent ExApp ships these Talk tools but they are not listed
in the "Currently implemented tools" section. PR nextcloud/context_agent#157
merged some, and others (reactions, polls, file sharing, shared-items
listings) were already shipped earlier and never made it into the docs.

Adds:
  - Reactions: add, remove, list
  - Reply to a specific message
  - Polls: create, get, vote, close
  - Share a file to a conversation
  - List shared items (by type, and overview)
Signed-off-by: Pavlinchen <69079839+Pavlinchen@users.noreply.github.com>
---
 admin_manual/ai/app_context_agent.rst | 57 ++++++++++++++++++++++++---
 1 file changed, 51 insertions(+), 6 deletions(-)

diff --git a/admin_manual/ai/app_context_agent.rst b/admin_manual/ai/app_context_agent.rst
index b70fe50da27..ca3effbbabe 100644
--- a/admin_manual/ai/app_context_agent.rst
+++ b/admin_manual/ai/app_context_agent.rst
@@ -313,25 +313,70 @@ Share tools
  * Example prompt: *"Does martin have write access to the Design/Ideas.md file I shared with him?"*
 
 
-Talk tools
-~~~~~~~~~~
+Talk tools (require `Talk <https://apps.nextcloud.com/apps/spreed>`_)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-* List the user's talk conversations (requires `Talk <https://apps.nextcloud.com/apps/spreed>`_)
+* List the user's talk conversations
 
   * Example prompt: *"List my talk conversations"*
 
-* List messages in a talk conversation (requires `Talk <https://apps.nextcloud.com/apps/spreed>`_)
+* List messages in a talk conversation
 
   * Example prompt: *"List the latest messages in my conversation with Andrew"*
 
-* Send a message to a talk conversation (requires `Talk <https://apps.nextcloud.com/apps/spreed>`_)
+* Send a message to a talk conversation
 
   * Example prompt: *"Can you send a joke to Andrew in talk?"*
 
-* Create a public talk conversation (requires `Talk <https://apps.nextcloud.com/apps/spreed>`_)
+* Create a public talk conversation
 
   * Example prompt: *"Can you create a new public talk conversation titled 'Press conference'?"*
 
+* Reply to a specific message in a talk conversation
+
+  * Example prompt: *"Reply to Andrew's last message in our talk conversation with 'Got it, thanks!'"*
+
+* Add an emoji reaction to a message in a talk conversation
+
+  * Example prompt: *"React with 👍 to Andrew's last message in our talk conversation"*
+
+* Remove an emoji reaction from a message in a talk conversation
+
+  * Example prompt: *"Remove my 👍 reaction from Andrew's last message"*
+
+* List the reactions on a message in a talk conversation
+
+  * Example prompt: *"Who reacted to Andrew's last message in our talk conversation?"*
+
+* Create a poll in a talk conversation
+
+  * Example prompt: *"Create a poll in the 'Team standup' conversation asking 'Which day works for the offsite?'
+    with options Monday, Tuesday, Wednesday"*
+
+* Get the question, options, and current results of a poll in a talk conversation
+
+  * Example prompt: *"Show the current results of the offsite poll in the 'Team standup' conversation"*
+
+* Cast a vote on a poll in a talk conversation
+
+  * Example prompt: *"Vote for Tuesday on the offsite poll in the 'Team standup' conversation"*
+
+* Close a poll in a talk conversation
+
+  * Example prompt: *"Close the offsite poll in the 'Team standup' conversation"*
+
+* Share a Nextcloud Files item to a talk conversation
+
+  * Example prompt: *"Share the file 'Q3 plan.pdf' to my conversation with Andrew"*
+
+* List items of a given type (e.g. file, location, poll) that were shared in a talk conversation
+
+  * Example prompt: *"List the files shared in my conversation with Andrew"*
+
+* Get an overview of items shared in a talk conversation across all types
+
+  * Example prompt: *"Give me an overview of what's been shared in my conversation with Andrew"*
+
 
 Mail tools (require `Mail <https://apps.nextcloud.com/apps/mail>`_)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~