From c4143c8f695559734d4d155622f48eeed9180f40 Mon Sep 17 00:00:00 2001
From: Pavlinchen <69079839+Pavlinchen@users.noreply.github.com>
Date: Mon, 15 Jun 2026 14:48:07 +0200
Subject: [PATCH] docs(context_agent): document the 13 Collectives tools

The context_agent ExApp ships these Collectives tools but they are not listed in
the "Currently implemented tools" section. This documents the resulting tool
surface; PR nextcloud/context_agent#159 is in flight and may further refine
update_page_content.

Adds a new "Collectives tools" section covering:
  - Collectives & pages: list
  - Pages: get metadata, get content, list trash
  - Pages: create, update content, rename, move, set emoji
  - Page lifecycle: trash, restore, delete permanently

Signed-off-by: Pavlinchen <69079839+Pavlinchen@users.noreply.github.com>
---
 admin_manual/ai/app_context_agent.rst | 56 +++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)

diff --git a/admin_manual/ai/app_context_agent.rst b/admin_manual/ai/app_context_agent.rst
index b70fe50da27..4eaef7a2f8f 100644
--- a/admin_manual/ai/app_context_agent.rst
+++ b/admin_manual/ai/app_context_agent.rst
@@ -110,6 +110,62 @@ Circles/teams tools
   * Example prompt: *"Share my Hiking plans.md file with the Hiking group team."*
 
 
+Collectives tools (require `Collectives <https://apps.nextcloud.com/apps/collectives>`_)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* List the user's collectives
+
+  * Example prompt: *"List my collectives."*
+
+* List the pages in a collective
+
+  * Example prompt: *"List the pages in my Engineering collective."*
+
+* Get metadata about a page in a collective
+
+  * Example prompt: *"Show me the details of the 'Onboarding' page in my Engineering collective."*
+
+* Get the markdown content of a page
+
+  * Example prompt: *"Fetch the content of the 'Onboarding' page in my Engineering collective."*
+
+* List trashed pages in a collective
+
+  * Example prompt: *"List the trashed pages in my Engineering collective."*
+
+* Create a new page in a collective under a given parent
+
+  * Example prompt: *"Create a new 'Q3 retro' page in my Engineering collective under the 'Retros' page."*
+
+* Replace the content of a page
+
+  * Example prompt: *"Update the 'Q3 retro' page in my Engineering collective with the meeting notes."*
+
+* Rename a page
+
+  * Example prompt: *"Rename the 'Q3 retro' page in my Engineering collective to 'Q3 2026 retro'."*
+
+* Move a page to a different parent
+
+  * Example prompt: *"Move the 'Q3 2026 retro' page under the 'Archive' page in my Engineering collective."*
+
+* Set the emoji icon of a page
+
+  * Example prompt: *"Set the emoji of the 'Onboarding' page in my Engineering collective to 🚀."*
+
+* Move a page to the collective's trash
+
+  * Example prompt: *"Trash the 'Old draft' page in my Engineering collective."*
+
+* Restore a page from the collective's trash
+
+  * Example prompt: *"Restore the 'Old draft' page from the trash of my Engineering collective."*
+
+* Permanently delete a page
+
+  * Example prompt: *"Permanently delete the 'Old draft' page in my Engineering collective."*
+
+
 Contacts tools
 ~~~~~~~~~~~~~~