Wiki source code of Tool Policies
Last modified by Vincent Massol on 2026/09/04 16:03
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Default policies for tool enablement per wiki and special tool categories. | ||
| 2 | |||
| 3 | When the {{code}}enabledTools{{/code}} list is empty (the default after installation), every non-write tool is enabled and every write tool is off: | ||
| 4 | |||
| 5 | |=Category |=Tools |=Enabled by default | ||
| 6 | |Help |{{code}}man{{/code}} |Always (mandatory) | ||
| 7 | |Search & Navigation |{{code}}query_documents{{/code}}, {{code}}get_document{{/code}}, {{code}}get_tree{{/code}}, {{code}}get_history{{/code}}, {{code}}get_links{{/code}}, {{code}}get_attachment{{/code}} |Yes | ||
| 8 | |Structured Data (read) |{{code}}query_objects{{/code}}, {{code}}get_schema{{/code}} |Yes | ||
| 9 | |Authoring (write) |{{code}}edit_document{{/code}}, {{code}}write_document{{/code}}, {{code}}delete_document{{/code}}, {{code}}write_attachment{{/code}}, {{code}}delete_attachment{{/code}} |No | ||
| 10 | |Structured Data (write) |{{code}}write_object{{/code}}, {{code}}delete_object{{/code}}, {{code}}write_schema{{/code}} |No | ||
| 11 | |Reach-gated |{{code}}list_wikis{{/code}} |Only when cross-wiki reach is enabled | ||
| 12 | |||
| 13 | == Mandatory tools == | ||
| 14 | |||
| 15 | {{code}}man{{/code}} is always registered regardless of the enabled tools list. It provides self-documentation and costs nothing. | ||
| 16 | |||
| 17 | == Write tools == | ||
| 18 | |||
| 19 | Tools where {{code}}isWrite() == true{{/code}} are off by default and must be enabled by an administrator per wiki. Eight tools are write tools, covering page content and deletion, attachments, structured objects and class definitions. See [[Enable Write Tools>>doc:documentation.extensions.admin.llm.mcp-server.enable-write-tools.WebHome]]. | ||
| 20 | |||
| 21 | == Reach-gated tools == | ||
| 22 | |||
| 23 | {{code}}list_wikis{{/code}} is registered only when the endpoint has cross-wiki reach. It is not shown in the admin tool checkbox tree: reach is its enable switch. | ||
| 24 | |||
| 25 | == Tool categories == | ||
| 26 | |||
| 27 | The category is the tool's own category value, and it drives the grouping of the {{code}}man{{/code}} catalog. | ||
| 28 | |||
| 29 | |=Category |=Tools | ||
| 30 | |Help |{{code}}man{{/code}} | ||
| 31 | |Search & Navigation |{{code}}query_documents{{/code}}, {{code}}get_document{{/code}}, {{code}}get_tree{{/code}}, {{code}}get_history{{/code}}, {{code}}get_links{{/code}}, {{code}}get_attachment{{/code}}, {{code}}list_wikis{{/code}} (reach-gated) | ||
| 32 | |Structured Data |{{code}}query_objects{{/code}}, {{code}}get_schema{{/code}}, {{code}}write_object{{/code}}, {{code}}delete_object{{/code}}, {{code}}write_schema{{/code}} | ||
| 33 | |Authoring |{{code}}edit_document{{/code}}, {{code}}write_document{{/code}}, {{code}}delete_document{{/code}}, {{code}}write_attachment{{/code}}, {{code}}delete_attachment{{/code}} | ||
| 34 | |||
| 35 | == Collection tools (index module) == | ||
| 36 | |||
| 37 | When the AI-LLM indexing module is installed, two additional tools are available: | ||
| 38 | |||
| 39 | |=Tool |=Category | ||
| 40 | |{{code}}search_collections{{/code}} |Semantic Search | ||
| 41 | |{{code}}list_collections{{/code}} |Semantic Search | ||
| 42 | |||
| 43 | These tools are governed by collection access rights, not the space filter. |
