Outils d’agent
Généré depuis
src/agent_tools/parmake gen-docs-agent-tools. Ne modifiez pas ce fichier à la main.
Cette page sert à consulter un outil, sa classe d’accès et ses paramètres.
Facet expose un catalogue unique d’outils documentaires à toutes les surfaces d’agent. Le serveur de ressources MCP liste tout le catalogue sous tools/list ; les assistants embarqués montent le sous-ensemble dont ils ont besoin. Le registre contient 23 outils. La visibilité filtre la liste par rôle ; le contrôle s’exécute toujours à l’appel, exactement comme en REST.
La colonne Accès porte la balise requires de l’outil dans le registre. Un rôle voit un outil quand sa carte de permissions passe la classe :
read— au moins une ligne de lecture.write— au moins une ligne create, update ou delete.action— une action nommée ou le joker*.none— toujours visible d’un principal connecté.
| Outil | Accès | Rôle | Paramètres |
|---|---|---|---|
aggregate_documents |
read | Aggregate documents of one doctype with the same filter grammar as list_documents. | aggregate (string, required) doctype (string, required) domain (string, required) field (string, optional) filters (object, optional) parent_id (string, optional) scope (string, optional) |
batch |
write | Apply an ordered list of writes atomically — all land or nothing does. | ops (array, required) |
call_action |
action | Execute a named action on one document. | action (string, required) args (object, optional) doc_id (string, required) doctype (string, required) domain (string, required) |
create_document |
write | Create one document of the given doctype. | content (object, required) doctype (string, required) domain (string, required) parent_id (string, optional) |
create_sidecar |
write | Create one sidecar record attached to a host document — the host-scoped nested-sidecar create (REST: POST /Api/:domain/:doctype/:id/:segment), generic over every sidecar doctype (comments, attachments, …). | content (object, required) doc_id (string, required) doctype (string, required) domain (string, required) segment (string, required) |
delete_document |
write | Soft-delete one document (tombstone, recoverable through audit replay). | doc_id (string, required) doctype (string, required) domain (string, required) |
get_artifact |
read | Mint a short-lived signed download URL for one artifact. | artifact_id (string, required) |
get_backrefs |
read | Find the live documents that point at one document — the inverse of get_links. | doc_id (string, required) doctype (string, required) domain (string, required) |
get_document |
read | Read one document by id. | doc_id (string, required) doctype (string, required) domain (string, required) expand (array, optional) fields (array, optional) |
get_links |
read | Get the outbound links of one document — the urn:facet:… references this document points to (from its reference fields and inline longtext links). | doc_id (string, required) doctype (string, required) domain (string, required) |
get_schema |
read | Get the full schema of one doctype: fields (types, required, constraints), named actions with their typed arguments, child doctypes, the parent doctype (member_of, on a child), sidecar segments (host-scoped record types attached through the nested routes — e.g. comments or attachments, via create_sidecar/list_sidecars), and named scopes. | doctype (string, required) domain (string, required) |
list_artifact_refs |
read | List the live documents that currently reference one artifact — both ‘file’ field placements and inline urn:facet:artifact: |
artifact_id (string, required) |
list_doctypes |
read | List the document types of one domain. | domain (string, required) |
list_documents |
read | List documents of one doctype. | doctype (string, required) domain (string, required) expand (array, optional) fields (array, optional) filters (object, optional) items (integer, optional) page (integer, optional) parent_id (string, optional) scope (string, optional) sort (array, optional) |
list_domains |
read | List the live domains (bounded contexts) available in Facet. | — |
list_mutations |
read | List the mutation history of one document, or — with no doc_id — the recent mutations of the whole workspace (domain/doctype narrow as filters; needs the wildcard read grant). | doc_id (string, optional) doctype (string, optional) domain (string, optional) filters (object, optional) items (integer, optional) page (integer, optional) sort (array, optional) |
list_sidecars |
read | List the sidecar records of one segment attached to a host document — the host-scoped nested-sidecar list (REST: GET /Api/:domain/:doctype/:id/:segment), generic over every sidecar doctype. | doc_id (string, required) doctype (string, required) domain (string, required) items (integer, optional) page (integer, optional) segment (string, required) |
ping |
none | Health probe. | — |
request_artifact_upload |
write | Get a one-time signed upload URL for a file artifact. | filename (string, required) size_bytes (integer, optional) |
resolve_refs |
read | Resolve a batch of document URNs (urn:facet:domain:Doctype:id — the inline links of longtext fields, links entries, or reference values) to documents in one call. | fields (array, optional) refs (array, required) |
search_documents |
read | Search every readable doctype at once — use it when you do not know where a document lives. | domain (string, optional) items (integer, optional) query (string, required) |
update_document |
write | Partially update one document. | doc_id (string, required) doctype (string, required) domain (string, required) patch (object, required) |
whoami |
none | Read your own identity and access: the account you act as, the mounted role, its permission manifest (doctype -> actions and scope aliases), and the role’s visible tags. | — |
Un outil ne fait pas partie du registre : read_skill, le chargeur de compétences. La surface MCP l’ajoute à tools/list, et l’assistant d’espace de travail monte le sien. Tous deux prennent un argument obligatoire, name (string). Ils servent le corpus de compétences partagé de src/agent_tools/skills/, filtré par le front-matter surfaces de chaque fichier de compétence.