Skip to content

Commit 531dae1

Browse files
committed
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. 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 The "replace the content of a page" entry notes the AI-authored note that update_page_content appends, matching nextcloud/context_agent#159. Signed-off-by: Pavlinchen <69079839+Pavlinchen@users.noreply.github.com>
1 parent cb7b633 commit 531dae1

1 file changed

Lines changed: 57 additions & 0 deletions

File tree

‎admin_manual/ai/app_context_agent.rst‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -110,6 +110,63 @@ Circles/teams tools
110110
* Example prompt: *"Share my Hiking plans.md file with the Hiking group team."*
111111

112112

113+
Collectives tools (require `Collectives <https://apps.nextcloud.com/apps/collectives>`_)
114+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
115+
116+
* List the user's collectives
117+
118+
* Example prompt: *"List my collectives."*
119+
120+
* List the pages in a collective
121+
122+
* Example prompt: *"List the pages in my Engineering collective."*
123+
124+
* Get metadata about a page in a collective
125+
126+
* Example prompt: *"Show me the details of the 'Onboarding' page in my Engineering collective."*
127+
128+
* Get the markdown content of a page
129+
130+
* Example prompt: *"Fetch the content of the 'Onboarding' page in my Engineering collective."*
131+
132+
* List trashed pages in a collective
133+
134+
* Example prompt: *"List the trashed pages in my Engineering collective."*
135+
136+
* Create a new page in a collective under a given parent
137+
138+
* Example prompt: *"Create a new 'Q3 retro' page in my Engineering collective under the 'Retros' page."*
139+
140+
* Replace the content of a page (a note saying the page was edited with the help of the AI Assistant is
141+
appended automatically)
142+
143+
* Example prompt: *"Update the 'Q3 retro' page in my Engineering collective with the meeting notes."*
144+
145+
* Rename a page
146+
147+
* Example prompt: *"Rename the 'Q3 retro' page in my Engineering collective to 'Q3 2026 retro'."*
148+
149+
* Move a page to a different parent
150+
151+
* Example prompt: *"Move the 'Q3 2026 retro' page under the 'Archive' page in my Engineering collective."*
152+
153+
* Set the emoji icon of a page
154+
155+
* Example prompt: *"Set the emoji of the 'Onboarding' page in my Engineering collective to 🚀."*
156+
157+
* Move a page to the collective's trash
158+
159+
* Example prompt: *"Trash the 'Old draft' page in my Engineering collective."*
160+
161+
* Restore a page from the collective's trash
162+
163+
* Example prompt: *"Restore the 'Old draft' page from the trash of my Engineering collective."*
164+
165+
* Permanently delete a page
166+
167+
* Example prompt: *"Permanently delete the 'Old draft' page in my Engineering collective."*
168+
169+
113170
Contacts tools
114171
~~~~~~~~~~~~~~
115172

0 commit comments

Comments
 (0)