Table of Contents

🇬🇧 English version

Voir aussi : Créer un nouveau tool · Retour à l'index

Inventaire des tools Orkeon

Cette page est le catalogue de référence des 124 classes de tools intégrées. La règle de comptage est celle qu'applique scripts/check-doc-claims.py : chaque fichier *Tool.cs sous src/, sauf l'interface (IBaseTool.cs) et l'infrastructure non-tool qui matche le glob (MockTool.cs, JsTool.cs, ObservedTool.cs, AIAgentTool.cs). Le même script vérifie que chaque nom de tool ci-dessous existe dans le code et que chaque tool du code est nommé ici — cette page ne peut pas dériver silencieusement de l'implémentation.

La colonne Tool est le nom exact que les agents et les listes YAML tools: utilisent (le UniqueName du contrat). Les tools réellement disponibles à l'exécution dépendent de la racine de composition — voir Disponibilité par racine de composition.

Collaboration et humain dans la boucle (Orkeon.Infrastructure)

Tool Classe Enregistrement Cas d'usage Exemple d'appel
ask_question_to_coworker AskQuestionTool Construit par agent par AgentDelegationToolsProvider quand AllowDelegation est actif — jamais en DI Poser une question à un agent coéquipier spécialisé { "question": "What is the Q4 revenue?", "coworker_role": "Financial Analyst", "context": "Fiscal year 2025" }
delegate_work_to_coworker DelegateWorkTool Même construction par agent (avec AgentExecutionBudget optionnel pour borner la profondeur récursive) Déléguer une tâche complète à un agent spécialisé ; avec wait_for_result: true le collègue s'exécute dans le contexte de la tâche qui délègue — même crew et même portée mémoire, sa réponse jamais rangée dans la mémoire de la crew — et hors d'un run de crew l'appel est refusé { "task": "Analyze competitor pricing", "coworker_role": "Market Researcher", "context": "Focus on SaaS B2B" }
spawn_agent SpawnAgentTool Câblé par aucune racine de composition livrée — l'hôte l'enregistre explicitement (IAgentFactory requis) Créer et exécuter un sous-agent spécialisé à l'exécution (mode autonome) { "role": "Fact checker", "goal": "Verify the claims", "task": "..." }
human_input HumanInputTool AddOrkeonHumanInput() — câblé par orkeon run pour un crew YAML (RunnerExecution) et par le REPL avec son fournisseur console ; sous --events la question remonte sur le flux d'événements du run, sinon c'est le AutoApproveHumanInputProvider par défaut qui répond Poser une question à l'humain (input_type : text, approval, choice avec choices — recommended marque une option — ou multi qui renvoie une liste) ; sans interface, HumanInputOptions.HeadlessPolicy répond la valeur par défaut (Default) ou refuse (Refuse) ; le runtime se suspend jusqu'à la réponse { "prompt": "Deploy to production?", "input_type": "approval" }

Les noms d'affichage des trois premiers contrats sont en prose (« Ask question to coworker », « Delegate work to coworker », « Spawn sub-agent ») ; le nom du registre — celui ci-dessus — est ce que le YAML référence.

Tools de recherche et de connaissance (Orkeon.Infrastructure / Orkeon.Tools.Rag)

Tool Classe Enregistrement Cas d'usage Exemple d'appel
semantic_search SearchTool AddSemanticSearchTool() (Orkeon.Hosting, opt-in — orkeon run l'appelle pour un crew YAML) Recherche sémantique par embeddings dans les mémoires { "query": "customer churn patterns", "top_k": 5 }
rag_search RagSearchTool AddOrkeonRag(config) + AddOrkeonRagTools() (Orkeon.Tools.Rag) — tout hôte runner appelle les deux Recherche RAG dans les collections remplies par rag_ingest (jamais l'index du code : codebase_search) via IRagPipeline. Résultat typé (answer, citations[]) ; paramètre structuré question (dataset pour rag_eval) { "question": "What is our return policy?", "top_k": 3 }
rag_ingest RagIngestTool Même opt-in que rag_search Ingestion incrémentale dans une collection RAG (pilotée par manifeste — les sources inchangées coûtent 0 embedding) { "collection": "docs", "sources": ["/kb/**/*.md"], "reindex": false }
rag_eval RagEvalTool Même opt-in que rag_search Évaluer une collection contre un dataset doré YAML : recall@k, precision@k, MRR, groundedness. Résultat typé (metrics[], cases[], reports) { "collection": "docs", "dataset": "/kb/eval/golden.yaml" }

Enregistrés par tout hôte runner. orkeon run (une crew YAML, un répertoire de crew, un script .ork.ts) et orkeon-host enregistrent le sous-système RAG et ses trois tools : un agent de crew peut donc les lister dans tools: ; orkeon-repl aussi, et un hôte C# qui appelle AddOrkeonRag(configuration) + AddOrkeonRagTools(). La façade de scripting (tools.ragSearch, l'espace de noms rag.*) et orkeon rag atteignent les mêmes pipelines. rag_search et rag_eval se replient sur Orkeon:Rag:Collection quand l'appel ne nomme aucune collection. Voir Pipeline RAG.

Tools d'exécution de code (Orkeon.Infrastructure.Sandbox / Orkeon.Tools.Code)

Tool Classe Enregistrement Cas d'usage Exemple d'appel
code_interpreter SecureCodeInterpreterTool AddOrkeonCodeSandbox() — type concret seulement, pas sous IBaseTool : le registre ne peut pas le résoudre par nom ; l'hôte l'injecte ou l'enregistre explicitement Exécuter du code C# dans un sandbox isolé avec analyse de sécurité statique { "code": "return 2 + 2;", "timeout_seconds": 10 }
shell_command ShellCommandTool AddOrkeonCodeTools() — allowlist en lecture seule par défaut (git limité aux sous-commandes en lecture seule) ; Orkeon:Tools:Shell:ExtraAllowedCommands ajoute des commandes, Orkeon:Tools:Shell:AllowedCommands remplace la liste, Orkeon:Tools:Shell:AllowInterpreters = true ouvre les interpréteurs et git en écriture (une ligne SECURITY par hôte au premier appel, qui énonce le confinement en vigueur) ; le processus est confiné par défaut (Orkeon:Tools:Shell:Confinement:Mode = Auto : bubblewrap sous Linux, Seatbelt sous macOS, AppContainer sous Windows, coupé dans un conteneur ; None le coupe ; une session confinée ne reçoit le bus de session de l'opérateur qu'avec Orkeon:Tools:Shell:Environment:SessionBus = true, puisqu'une commande peut sortir du bac à sable par lui), dans une session shell par exécution d'agent Exécuter des commandes shell avec allowlist/blocklist et timeout ; sans working_directory la commande s'exécute dans la racine de l'agent, sinon dans le répertoire de travail du système de fichiers (refusée s'il n'y en a pas), et un répertoire relatif se résout contre lui et reste tenu à la racine de l'agent ; hors d'une racine d'agent, une commande d'écriture que le répertoire de travail n'autorise pas s'exécute dans le répertoire d'écriture (Orkeon:FileSystem:WriteDirectory, /output par défaut), et est refusée en nommant cette option s'il n'y en a pas ; les arguments en chemins virtuels montés sont résolus pour le processus (lecture pour une commande en lecture seule, tous les droits pour une commande qui peut écrire) et les chemins physiques de la sortie reviennent virtualisés (un chemin entre guillemets en entier, une base Windows sans casse et avec l'un ou l'autre séparateur ; sous WSL un programme Windows reçoit et rend l'écriture Windows, Orkeon:Tools:Shell:WindowsPaths) ; action = start_job lance en tâche détachée un build ou une suite de tests plus longs qu'un appel (sortie dans /output/jobs/<id>.log, 16 tâches vivantes au plus par exécution d'agent, tuées avec l'exécution) et renvoie un job_id, job_status indique running ou le exit_code, job_tail renvoie les tail_lines dernières lignes { "command": "cat /workspace/README.md", "timeout_seconds": 30 } ; { "action": "start_job", "command": "dotnet test" } ; { "action": "job_tail", "job_id": "<id>", "tail_lines": 40 }

Tools de session et de mémoire (Orkeon.Infrastructure) — AddOrkeonSessionTools()

Tool Classe Cas d'usage
session_store SessionStoreTool Lire/écrire/tronquer/annoter le buffer de session et ses métadonnées ; truncate garde la tête plus les retain_count derniers tours, comme session_snip, append_message ajoute un message sans réécrire le buffer, get_state lit une key ou plusieurs keys, set_state écrit une key ou plusieurs values et supprime plusieurs keys ; une écriture multi-clés est tout ou rien, un recouvrement values / keys ou une key / value mêlée à values / keys est refusé, et en mode plan seules les lectures (get_state, read_messages, get_metadata) sont admises
session_snip SessionSnipTool Tronquer immédiatement la conversation au message de tête plus les retain_count derniers tours (3 par défaut) ; un tour est une requête utilisateur avec les traces d'outils et la réponse qui la suivent, la coupe n'en scinde donc jamais un ; kept_from est l'index du premier message conservé, toujours un message utilisateur (-1 quand rien n'a été retiré ou que seule la tête est gardée)
session_stats SessionStatsTool Télémétrie complète de session : messages, tokens, coût, totaux d'appels
session_cost SessionCostTool Coût cumulé de la session en USD avec ventilation par modèle
token_budget TokenBudgetTool Taille de la fenêtre de contexte, tokens consommés et ce qui les remplit (used_tokens_by_kind : system, user, assistant, tool, other), budget disponible
memory_store MemoryStoreTool Lister/ajouter/remplacer/supprimer/lire des mémoires typées (user/project/feedback/reference) : add renvoie l'id de l'entrée, chaque entrée porte created_at, list prend newest_first, replace retire un fait périmé sur place (même id et même catégorie). Conservées par projet dans <Orkeon:Cli:Memory:RootDirectory>/<slug du projet>/memory.json quand Orkeon:Cli:Memory:Persist est actif (défaut du REPL) ; en mémoire sinon
memory_recall MemoryRecallTool Enregistré par AddOrkeonCognitiveMemory(configuration), pas par AddOrkeonSessionTools() ; RunnerHost ne l'appelle que si Orkeon:CognitiveMemory:Enabled vaut true. Rappeler ce dont se souvient la crew de l'appel (query, limit), classé par score composite ; opt-in (Orkeon:CognitiveMemory:Enabled), détenu seulement par une crew avec memory: true

Tool de décision (Orkeon.Infrastructure) — AddOrkeonDecisionProvider(configuration)

Tool Classe Cas d'usage Exemple d'appel
system_one_decide SystemOneDecideTool Poser au fournisseur de décision actif (TypeSafe, Liquid ou Kev, voir Modèles de décision) des questions typées sur un état : choice, score ou noul, chaque réponse avec ses probabilités calibrées et une confiance ; les questions box sont refusées (les images ne passent pas par un appel de tool) et la clé d'API n'apparaît jamais dans la requête { "state": { "ticket": "Refund not received" }, "questions": { "urgent": { "type": "noul", "instructions": "Does the customer need an answer today?", "criteria": { "true": "An answer is needed today", "false": "It can wait" } } } }

Outil MCP (Orkeon.Infrastructure) — AddOrkeonMcp(configuration)

Tool Classe Usage Exemple d'appel
mcp_prompt_get McpPromptGetTool Obtient un modèle de prompt d'un serveur MCP connecté (prompts/get), ses arguments remplis ; sans name, liste les prompts du serveur. Le texte est une donnée renvoyée par le serveur, pas une instruction {"server": "docs", "name": "review", "arguments": {"lang": "C#"}}

Tools fichiers (Orkeon.Tools.FileSystem) — AddOrkeonFileSystemTools()

Un path est un chemin virtuel qui commence par un mount (/workspace/src/stats.js). Un chemin relatif se résout contre la racine de travail de l'agent, sinon contre le répertoire de travail du système de fichiers (/workspace par défaut), et la réponse renvoie le chemin absolu ; un path vide est refusé, et un chemin hors de la racine de l'agent est refusé avant toute E/S — de même pour node_outline, node_read, structural_search, structural_rewrite, txt_search et mdx_search (Répertoire de travail et chemins relatifs).

Tool Classe Base Cas d'usage Exemple d'appel
file_read FileReadTool FileToolBase<FileReadRequest, FileReadResponse> Lire un fichier texte entier ou par plage de lignes (offset, limit ; has_more en cas de coupure) ; un symbole passe par node_read, une recherche par grep { "path": "/data/report.txt" }
file_write FileWriteTool FileToolBase<FileWriteRequest, FileWriteResponse> Écrire tout le contenu d'un fichier, en créant les dossiers si nécessaire (append ajoute à la fin) ; une modification dans un fichier passe par edit_file { "path": "/output/result.txt", "content": "Analysis complete.", "append": false }
edit_file EditFileTool FileToolBase<EditFileRequest, EditFileResponse> Remplacer une chaîne dans un fichier lorsqu'elle n'apparaît qu'une fois, ou chaque occurrence avec replace_all { "path": "/workspace/a.txt", "old_string": "foo", "new_string": "bar" }
directory_read DirectoryReadTool FileToolBase<DirectoryReadRequest, DirectoryReadResponse> Lister le contenu d'un répertoire avec filtrage glob et récursion, au plus max_results entrées (200 ; truncated quand le dossier en contient plus) { "path": "/data", "pattern": "*.csv", "recursive": true }
directory_search DirectorySearchTool ToolBase<DirectorySearchRequest, DirectorySearchResponse> Recherche sémantique RAG dans les fichiers d'un répertoire (collection éphémère — exige le sous-système RAG à l'appel, voir ci-dessous) { "path": "/docs", "query": "deployment instructions", "file_patterns": "*.md;*.txt" }
count_pattern CountPatternTool FileToolBase<CountPatternRequest, CountPatternResponse> Compte déterministe des occurrences de chaque motif regex dans un fichier (aucune estimation LLM) ; sur une arborescence, grep avec output_mode: "count" { "path": "/data/log.txt", "patterns": ["ERROR", "WARN"] }
glob GlobTool FileToolBase<GlobRequest, GlobResponse> Fichiers correspondant à un motif sous une racine montée, bornés par max_results (pattern relatif à path). Classe Read { "path": "/workspace", "pattern": "**/*.cs", "max_results": 100 }
grep GrepTool FileToolBase<GrepRequest, GrepResponse> Recherche regex ligne à ligne renvoyant path:line:text, bornée par max_results / max_files, fichiers binaires ou de plus de 1 Mio ignorés, délai par correspondance ; glob filtre relatif à path ; un fichier en path est cherché seul (un glob à côté est refusé, avec la correction à faire). Chaque réponse porte total_matches, files_matched, scan_complete (faux quand un fichier de plus de 1 Mio n'a pas été lu, que le budget de temps est épuisé ou que max_files a coupé le scan) et truncated (vrai quand une liste ou les comptes sont coupés) ; output_mode: "count" supprime les lignes de résultat et renvoie les comptes par fichier, si bien qu'une question « combien » sur une arborescence tient en un appel. Le mode hits, par défaut, lit tous les fichiers candidats jusqu'à max_files ou au budget de 20 s, même une fois max_results atteint, pour que total_matches reste exact ; une grande arborescence peut finir timed_out ou truncated. Classe Read { "path": "/workspace", "pattern": "TODO", "glob": "**/*.cs" }

directory_search — comme txt_search, mdx_search et pdf_search plus bas — cherche au travers des collections éphémères du sous-système RAG : l'extension l'enregistre et le construit sans lui, mais une recherche échoue à l'appel avec un message explicite tant que l'hôte n'a pas appelé AddOrkeonRag(configuration) et fourni un provider d'embeddings.

Tools de données (Orkeon.Tools.Data) — AddOrkeonDataTools()

AddOrkeonDataTools() enregistre les 22 (il chaîne AddRelationalDatabaseTools(), AddMongoDbTools() et AddGraphDatabaseTools() en interne).

Tool Classe Cas d'usage Exemple d'appel
csv_reader CsvReaderTool Lire et structurer des fichiers CSV avec détection du délimiteur { "path": "/data/sales.csv", "delimiter": "," }
pdf_reader PdfReaderTool Extraire le texte de fichiers PDF avec sélection de pages { "path": "/docs/contract.pdf", "page_range": "1-5" }
json_tool JsonTool Manipuler du JSON : parse (analyse de structure), query (navigation dot-notation), format (pretty-print) { "operation": "query", "input": "{...}", "query": "data.users[0].name" }
xml_parser XmlParserTool Parser du XML depuis un chemin de fichier ou une chaîne, avec requêtes XPath { "input": "/data/feed.xml", "operation": "query", "xpath": "//item/title" }
docx_reader DocxReadTool Lire des fichiers Word avec extraction du texte, des tableaux et des métadonnées { "file_path": "/docs/report.docx" }
docx_writer DocxWriteTool Créer des fichiers Word (.docx) avec titre, paragraphes et listes à puces { "file_path": "/output/report.docx", "title": "Monthly Report", "paragraphs": ["Introduction text..."] }
xlsx_reader XlsxReadTool Lire des fichiers Excel (.xlsx) : feuilles, lignes, colonnes, métadonnées (ClosedXML) { "file_path": "/data/budget.xlsx", "sheet_name": "Q3" }
xlsx_writer XlsxWriteTool Créer ou mettre à jour des fichiers Excel (.xlsx) avec plusieurs feuilles, en-têtes et lignes { "file_path": "/output/summary.xlsx", "sheets": [{ "name": "Totals", "headers": ["Region", "Revenue"], "rows": [["EMEA", "1.2M"]] }] }
relational_database_query RelationalDatabaseTool Exécuter des requêtes SQL (SQL Server, PostgreSQL, MySQL, MariaDB, SQLite) ; provider_name est le provider ADO.NET (Microsoft.Data.SqlClient, Npgsql, MySqlConnector, Microsoft.Data.Sqlite) { "connection_string": "...", "provider_name": "Npgsql", "query": "SELECT * FROM orders WHERE status = @status", "parameters": { "status": "pending" }, "query_type": "select" }
sqlserver_query SqlServerDatabaseTool Requêtes SQL Server spécialisées —
postgres_query PostgresDatabaseTool Requêtes PostgreSQL spécialisées —
mysql_query MySqlDatabaseTool Requêtes MySQL spécialisées —
mariadb_query MariaDbDatabaseTool Requêtes MariaDB spécialisées —
database_schema DatabaseSchemaTool Inspection de schéma relationnel (tables, colonnes, index, clés étrangères) —
mongodb_query MongoDbTool Exécuter des opérations MongoDB (Find, Aggregate, CRUD) { "connection_string": "...", "database": "shop", "collection": "products", "operation": "find", "filter": "{ \"price\": { \"$gt\": 100 } }" }
mongodb_schema MongoDbSchemaTool Inférence du schéma d'une collection MongoDB par échantillonnage de documents —
arcadedb_query ArcadeDbTool Requêtes contre la base graphe ArcadeDB —
janusgraph_query JanusGraphTool Traversées Gremlin contre JanusGraph —
graph_schema GraphSchemaTool Inspection du schéma d'une base graphe (labels de sommets/arêtes, propriétés, index) —
pdf_search PdfSearchTool Recherche sémantique dans des fichiers PDF via embeddings (sous-système RAG requis à l'appel) —
txt_search TxtSearchTool Recherche sémantique dans des fichiers texte (sous-système RAG requis à l'appel) —
mdx_search MdxSearchTool Recherche sémantique dans des fichiers MDX/Markdown (frontmatter et JSX retirés ; sous-système RAG requis à l'appel) —

Tools web (Orkeon.Tools.Web)

AddOrkeonWebTools() enregistre les six premiers ; chacun des autres a sa propre extension opt-in parce qu'il exige une clé ou un service support supplémentaire. Les clés ne voyagent pas toutes de la même façon : les clés Tavily et OpenAI sont des secrets résolus à l'appel, les jetons Brave et Slack sont remis à leur extension par l'hôte. Aucun tool ne prend de secret en argument d'appel — ce qu'un argument porte traverse la conversation, le journal des appels d'outils et la trace d'usage. Tout tool qui récupère une URL passe par la garde SSRF (fail-closed même sans IUrlValidator enregistré) et par un client nommé qui refuse les redirections.

Tool Classe Enregistrement Cas d'usage
http_api HttpApiTool AddOrkeonWebTools() Appels HTTP REST (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS) avec protection SSRF. Pour la permission gate, GET, HEAD et OPTIONS (et une méthode absente, envoyée en GET) sont des lectures, toute autre méthode une exécution
web_scrape WebScrapeTool AddOrkeonWebTools() Scraper une page web avec filtrage CSS optionnel ; cached=true découpe et embarque la page dans le cache RAG
scrape_element ScrapeElementTool AddOrkeonWebTools() Scraping ciblé d'éléments DOM via sélecteurs CSS (texte, HTML, attributs)
github GitHubTool AddOrkeonWebTools() — le jeton est lu à l'enregistrement dans Orkeon:Tools:GitHub:Token, la variable que nomme Orkeon:Tools:GitHub:TokenVariable (par défaut GITHUB_TOKEN), puis GH_TOKEN ; sans jeton les appels sont anonymes, les actions d'écriture refusées et la description dit où le poser (configuration) API GitHub v3 (action : list_issues, create_issue, get_pr, search_repos, get_repo, create_pr). create_pr prend base, head, title et un body optionnel, et renvoie l'URL de la pull request dans le url de son unique élément de résultat ; elle exige un jeton avec droit d'écriture sur les pull requests. Pour la permission gate, list_issues, get_pr, search_repos et get_repo sont des lectures (autorisées en plan), create_issue, create_pr et une action inconnue des exécutions
image_generation ImageGenerationTool AddOrkeonWebTools() (exige un IFileSystemService et un ISecretProvider) — le secret OPENAI_API_KEY est résolu à l'appel (par défaut la variable d'environnement ORKEON_OPENAI_API_KEY, puis Secrets:OPENAI_API_KEY) ; sans lui un appel échoue en nommant le secret Génération d'images via l'API OpenAI DALL-E, enregistrables sous un chemin virtuel (save_to_path)
firefox FirefoxTool AddOrkeonWebTools() (exige un IFileSystemService) — Firefox doit être installé sur l'hôte ; il démarre au premier appel d'une exécution d'agent, sur un profil jetable ou sur un que l'hôte nomme, et se ferme avec elle — ou est partagé entre les exécutions, un navigateur par profil, avec SharedInstance, ou gardé avec ses onglets d'une exécution à la suivante avec Lifetime: host (configuration) Pilote un navigateur Firefox par WebDriver BiDi (action : navigate, back, snapshot, read, find, search, click, type, press, evaluate, screenshot, tabs, new_tab, switch_tab, close_tab, close). snapshot rend la page comme un plan de sections, de liens et de contrôles lu dans son graphe sémantique ; chaque nœud porte un identifiant (p2#7) que prennent click, type, read et find. search rend les sections les plus proches par le sens d'une query par la recherche RAG éphémère (une erreur sans le sous-système RAG). screenshot écrit un PNG sous un chemin virtuel (save_to_path). Un agent pilote un onglet à la fois, parmi ceux qu'il a ouverts (tabs, new_tab, switch_tab, close_tab) ; un profile facultatif nomme, au premier appel d'une exécution, le profil sur lequel le navigateur démarre parmi ceux que l'hôte autorise. Chaque adresse que le navigateur affiche est vérifiée par la garde SSRF. Pour la permission gate, navigate, back, snapshot, read, find, search, tabs, new_tab et switch_tab sont des lectures (autorisées en plan), screenshot une édition, click, type, press, evaluate, close_tab, close et une action inconnue des exécutions
web_search WebSearchTool AddOrkeonWebSearchTool() — le secret TAVILY_API_KEY est résolu à l'appel via ISecretProvider (par défaut la variable d'environnement ORKEON_TAVILY_API_KEY, puis Secrets:TAVILY_API_KEY en configuration) Recherche web via l'API Tavily Search
brave_search BraveSearchTool AddOrkeonBraveSearchTool(apiKey) — orkeon run ne le câble que si BRAVE_API_KEY est posée Recherche web via l'API Brave Search
slack_send_message SlackTool AddOrkeonSlackTool(botToken) — aucune racine livrée ne l'appelle (opt-in hôte pur) Envoyer des messages vers des canaux/utilisateurs Slack via la Web API
slack_read_messages SlackReadTool AddOrkeonSlackReadTool(botToken) — même opt-in hôte Lire des messages Slack (lecture seule)
cache_search CacheSearchTool AddOrkeonCacheSearchTool() (exige IEmbeddingService et IMemoryProvider) Recherche sémantique dans le cache RAG que d'autres tools alimentent (ex. web_scrape avec cached=true)

Tools du hub d'événements (Orkeon.Tools.EventHub) — AddOrkeonEventHubTools()

Sept tools, enregistrés avec le hub en mémoire (AddOrkeonInMemoryEventHub()). La sémantique complète vit dans EventHub et le cycle de vie du crew.

Tool Classe Cas d'usage
publish_event PublishEventTool Publier un événement sur un topic (broadcast 1→N), scope crew et métadonnées optionnels
post_message PostMessageTool Message fire-and-forget vers une boîte (agent://, crew://, topic://)
send_request SendRequestTool Envoyer une requête vers une boîte et attendre la réponse corrélée (timeout_ms requis)
reply_to ReplyToTool Répondre à une requête en attente identifiée par son correlation_id
receive_message ReceiveMessageTool Tirer le prochain message d'une boîte (lecture destructive, scope crew)
wait_for_event WaitForEventTool Attendre le prochain événement d'un topic (exactement un de timeout_ms/wait_forever)
get_last_value GetLastValueTool Lire la dernière charge retenue pour une clé (cache dernière-valeur)

Tools e-mail (Orkeon.Tools.Email) — AddOrkeonEmailTools(configuration)

Treize tools sur les comptes qu'un opérateur déclare sous Orkeon:Tools:Email : IMAP, POP3 et SMTP via MailKit, Outlook.com et Microsoft 365 via Microsoft Graph. Tant qu'aucun compte n'est déclaré, les tools de boîte aux lettres refusent tout appel, email_accounts n'en liste aucun et email_parser, qui lit un fichier, fonctionne. Un agent nomme un compte (account, ou celui par défaut) — jamais un serveur ni un identifiant — et les Rights du compte décident de ce qu'il peut faire ; email_send n'atteint que les destinataires qu'autorise la liste Send:AllowedRecipients du compte. Les ids de message sont opaques : repassez-les tels que email_search les a rendus. La colonne Accès est la classe que voit la permission gate. Nouveau venu dans la famille ? Le tutoriel boîte aux lettres met un compte en service de bout en bout. Chaque paramètre est listé dans le guide e-mail ; les résultats sont dimensionnés à ce que garde la boucle d'agent, et cursor / offset reprennent exactement là où une page ou une tranche s'arrête. Mise en place pour Gmail, Hotmail/Outlook.com et votre propre serveur, modèle de sécurité et commandes orkeon email : Outils e-mail.

Tool Classe Droit requis Accès Cas d'usage Exemple d'appel
email_accounts EmailAccountsTool aucun Read Lister les comptes configurés : le nom à passer en account, leurs droits, si chacun est prêt {}
email_folders EmailFoldersTool Read Read Lister les dossiers avec leur rĂ´le (inbox, sent, drafts, trash, junk, archive, all) et leurs compteurs { "account": "work" }
email_search EmailSearchTool Read Read Chercher dans un dossier, du plus récent au plus ancien : non lus, suivis, expéditeur, destinataire, objet, texte, dates, pièces jointes, ou une raw_query native (syntaxe de recherche Gmail, KQL Outlook) ; au plus limit messages par page (10 par défaut, 50 au plus) et une dizaine en pratique, la page étant coupée à un résultat d'outil — seul next_cursor dit que le dossier est fini ; total compte les correspondances en IMAP { "folder": "inbox", "unread_only": true, "since": "2026-09-01" }
email_read EmailReadTool Read (+ Organize avec mark_read) Read Lire un message : l'avis de contenu non fiable et le verdict de filtrage d'abord, puis les en-têtes, les pièces jointes et le corps par tranches (offset, max_chars 200–3000, 2500 par défaut, puis next_offset) { "id": "<id rendu par email_search>" }
email_save_attachment EmailSaveAttachmentTool Read, plus un montage accessible en écriture Edit Enregistrer une pièce jointe (index) ou toutes dans un répertoire virtuel ; noms assainis, rien n'est écrasé { "id": "…", "directory": "/output/attachments" }
email_create_folder EmailCreateFolderTool Organize Edit Créer un dossier (un libellé sur Gmail) ; les parents manquants sont créés { "path": "Clients/ACME" }
email_rename_folder EmailRenameFolderTool Organize Edit Renommer le dernier segment d'un dossier ; les dossiers système sont refusés { "path": "Clients/ACME", "new_name": "ACME Corp" }
email_move EmailMoveTool Organize Edit Déplacer des messages vers un chemin de dossier ou un rôle ; rend le nouvel id de chaque message quand le serveur le donne { "ids": ["…"], "destination": "archive" }
email_mark EmailMarkTool Organize Edit Marquer lu ou non lu (seen), suivre ou non (flagged, une étoile sur Gmail) { "ids": ["…"], "seen": true }
email_delete EmailDeleteTool Delete ; Purge avec permanent: true Execute Mettre des messages à la corbeille, ou les supprimer définitivement ; rend chaque id supprimé et son nouvel id dans la corbeille { "ids": ["…"] }
email_draft EmailDraftTool Draft (+ Read pour répondre ou transférer) Edit Enregistrer un nouveau message, une réponse (reply_to_id, reply_all) ou un transfert (forward_id) dans les brouillons sans l'envoyer — la voie de la relecture humaine, sans liste d'autorisation { "to": ["client@example.com"], "subject": "Devis", "text": "…" }
email_send EmailSendTool Send (+ Read pour répondre ou transférer) Execute Envoyer un nouveau message, une réponse ou un transfert aux destinataires qu'autorise Send:AllowedRecipients (une liste vide n'autorise personne) ; From est toujours le compte { "reply_to_id": "…", "text": "Bien reçu, merci." }
email_parser EmailParserTool aucun (pas de compte) Read Parser un fichier .eml depuis un chemin virtuel ; mĂŞme sortie que email_read { "path": "/workspace/mail/invoice.eml" }

Tools drive (Orkeon.Tools.Drive) — AddOrkeonDriveTools(configuration)

Onze tools sur les drives dans le nuage qu'un opérateur déclare sous Orkeon:Tools:Drive : Google Drive via l'API Drive v3 et OneDrive (personnel ou professionnel) via Microsoft Graph, les deux en HTTP simple. Tant qu'un compte n'est pas déclaré et connecté (orkeon drive login), chaque tool sauf drive_accounts refuse tout appel en disant quoi faire. Un agent nomme un compte (account, ou celui par défaut) — jamais un client ni un jeton — et les Rights du compte décident de ce qu'il peut faire ; le Root d'un compte confine chaque appel à un dossier du drive, un élément hors de ce dossier étant signalé comme introuvable. Les ids sont ceux du fournisseur, et opaques ; root désigne le dossier racine du compte partout où un id de dossier est attendu. drive_share n'atteint que les adresses qu'autorise Share:AllowedRecipients, et les liens publics restent désactivés sauf si Share:AllowPublicLinks est posé. Mise en place pour les deux fournisseurs, modèle de sécurité et commandes orkeon drive : Outils drive.

Tool Classe Droit requis Accès Cas d'usage Exemple d'appel
drive_accounts DriveAccountsTool aucun Read Lister les comptes configurés : le nom à passer en account, leurs droits, leur dossier racine, si chacun est prêt {}
drive_list DriveListTool Read Read Lister un dossier (la racine du compte par défaut), dossiers en tête ; au plus limit éléments par page (20 par défaut, 50 au plus), la page étant ajustée à un résultat d'outil — next_cursor reprend exactement après le dernier élément montré { "folder_id": "root" }
drive_search DriveSearchTool Read Read Chercher par mots, nom, type MIME, nature, date de modification ou dossier, dans la racine ; une clause raw_query Google Drive ; OneDrive exige text ou name_contains { "name_contains": "invoice", "mime_type": "application/pdf" }
drive_info DriveInfoTool Read Read Les métadonnées d'un élément, son adresse dans le navigateur comprise { "id": "<id rendu par drive_list>" }
drive_read DriveReadTool Read Read Lire un fichier texte, ou un fichier Google Docs, Sheets ou Slides via son export texte : l'avis de contenu non fiable et le verdict de filtrage d'abord, puis le texte par tranches (offset, max_chars jusqu'à 3000, puis next_offset) ; un PDF, un fichier Office ou une image est renvoyé vers drive_download { "id": "…" }
drive_download DriveDownloadTool Read, plus un montage accessible en écriture Edit Enregistrer un fichier dans un répertoire virtuel — un document Google exporté au format voulu (pdf, docx, xlsx, csv…) ; noms assainis, rien n'est écrasé { "id": "…", "directory": "/output/drive" }
drive_upload DriveUploadTool Write Edit Charger un fichier du VFS dans un dossier, ou remplacer le contenu d'un fichier existant avec replace_id ; un nom déjà pris est refusé ; au plus MaxUploadMegabytes (100 par défaut) { "path": "/output/report.pdf", "folder_id": "…" }
drive_create_folder DriveCreateFolderTool Write Edit Créer un dossier ; un nom déjà pris dans le parent est refusé { "name": "Reports" }
drive_move DriveMoveTool Organize Edit Déplacer un élément dans un autre dossier (destination_id), le renommer (new_name), ou les deux, dans la racine { "id": "…", "destination_id": "…" }
drive_delete DriveDeleteTool Delete ; Purge avec permanent: true Execute Mettre un élément à la corbeille, ou le supprimer définitivement (Google Drive, OneDrive professionnel ; un OneDrive personnel le refuse) { "id": "…" }
drive_share DriveShareTool Share Execute Donner à des adresses autorisées un accès en lecture ou en écriture (sans notification sauf notify), ou créer un lien public quand le compte le permet { "id": "…", "recipients": ["boss@example.com"] }

Tools d'analyse de codebase (Orkeon.Tools.Analysis) — AddRaggableTreeTools()

Vingt-neuf tools sur le graphe sémantique de code RaggableTree — le guide complet est RaggableTree.

Tool Classe Cas d'usage
index_codebase IndexCodebaseTool Scanner la codebase et construire l'index RaggableTree complet ; recharge l'index sauvegardé depuis le cache (use_cache, vrai par défaut ; false reconstruit), analyse max_parallelism fichiers à la fois (0 = un par processeur)
incremental_reindex IncrementalReindexTool Réindexer seulement les fichiers modifiés depuis un commit ou une liste explicite
index_status IndexStatusTool Lister chaque racine virtuelle actuellement indexée
is_path_indexed IsPathIndexedTool Vérifier si un chemin virtuel est couvert par une racine indexée
codebase_map CodebaseMapTool Carte structurelle de la codebase à un niveau (L1 par défaut, L0–L3), au plus max_entries (200), truncated quand il en existe plus
package_summary PackageSummaryTool Détails d'un package (L1) : comptes fichiers/symboles, points d'entrée, exports (au plus max_exports, 50), dépendances
symbol_detail SymbolDetailTool Détail étendu d'un symbole L3 : signature, doc, métriques, membres, appelants/appelés ; expand: "inheritance" donne extends, implements, derived_by et implemented_by en FQN
symbol_source SymbolSourceTool Citation de source déterministe : chemin, lignes, code, SHA-256, drapeau de stabilité
codebase_search CodebaseSearchTool Recherche hybride (vecteur + BM25) avec résultats classés et cités, au plus top_k (10), truncated quand il en existe plus
dependency_graph DependencyGraphTool Graphe de dépendances à une portée (packages L1, modules L2, symboles L3) : au plus max_nodes nœuds (200), truncated quand la portée en contient plus, les cycles de toute la portée, au plus max_cycles (20, les plus grands d'abord, cycle_count garde le total) d'au plus max_cycle_members (50) membres ; include_mermaid / include_dot désactivés par défaut
sub_graph SubGraphTool Expansion de sous-graphe autour de graines, Forward ou Backward, bornée par depth et max_nodes (100) ; include_mermaid désactivé par défaut
edge_list EdgeListTool Toutes les arêtes des edge_kinds donnés (obligatoire) de l'index entier, dans un ordre stable et paginées (cursor, page_size jusqu'à 1000), chaque extrémité en FQN et en id, éventuellement restreintes aux arêtes dont une extrémité est root_fqn ou se trouve sous lui (un paquet ou un fichier par chemin, un type par FQN, un espace de noms par ses fichiers et son nom) ; total et next_cursor. Classe Read
flow_trace FlowTraceTool Tracer le flux d'appels depuis un symbole, le plus court chemin vers une cible ou tous les chemins dans max_depth et max_paths (20) ; edge_kinds prend les noms de workflow (calls par défaut, inherits)
impact_analysis ImpactAnalysisTool Appelants directs et transitifs affectés par la modification d'un symbole, comptés par package, au plus max_nodes visités (500)
complexity_report ComplexityReportTool Top-N des méthodes par métriques de complexité, avec médiane/P95
access_cost AccessCostTool Coût d'accès aux ports des membres choisis par fqns ou changed_files (par défaut : les changements de l'arbre de travail), restreint à roots ; receivers remplace la regex des récepteurs de ports. Classe lecture
documents_of DocumentsOfTool Symboles documentés par les sections d'un fichier Markdown (path). Classe Read
documented_in DocumentedInTool Sections Markdown qui documentent un symbole (fqn) : fichier, chemin de titres, ligne de début. Classe Read
batch_anchors BatchAnchorsTool action: closure étend des ancres (fqns, files) aux nœuds contenus, appelants et tests ; action: overlap compare deux ensembles d'ancres a et b et liste les nœuds partagés. Classe Read
affected_tests AffectedTestsTool Projets de test et classes de test atteints par un changement via le graphe (changed_files ou base ; ni l'un ni l'autre vaut base = HEAD, les changements de l'arbre de travail) ; répond all quand il ne peut pas borner l'ensemble. Classe Read
statement_query StatementQueryTool Requêter les statements L4 par genre, FQN parent, ou similarité sémantique
node_outline NodeOutlineTool Lister les membres d'un fichier source dans toute grammaire chargée, ou les sections d'un fichier Markdown, avec sélecteurs, plages d'octets et de lignes
node_read NodeReadTool Lire un membre par sélecteur : texte (commentaires et attributs de tête inclus), plage, SHA-256, sans coupure
node_replace NodeReplaceTool Remplacer un nœud par sélecteur et SHA-256 attendu : refusé si le hash est périmé ou si une erreur d'analyse est introduite, fichier intact ; marque l'index sale. Classe Edit
structural_search StructuralSearchTool Recherche structurelle par motif avec métavariables $A / $$$ARGS, objet de règle ou fichier de règles YAML sur les fichiers de toute grammaire chargée ou Markdown, bornée par max_results / max_files. Classe Read
structural_rewrite StructuralRewriteTool Réécrire les nœuds trouvés par un motif ou une règle avec un modèle fix sur les fichiers de toute grammaire chargée ; dry_run vaut true par défaut ; diff par fichier, un fichier dont la réécriture ne s'analyse pas est refusé seul ; Markdown refusé. Classe Edit
node_insert NodeInsertTool Ajouter un nœud inside un type, un namespace ou une section Markdown (dernier membre, indentation des frères) ou before/after un nœud d'ancrage (ses commentaires et attributs restent avec lui) ; aucun hash d'ancrage requis ; refusé si une erreur d'analyse est introduite ; marque l'index sale. Classe Edit
node_ensure NodeEnsureTool Appliquer une opération d'intention idempotente à un fichier (ensure_using, ensure_import, ensure_field, ensure_member, ensure_section, insert_under_heading, replace_mermaid) ; un no-op n'écrit rien et renvoie applied: false ; refusé si une erreur d'analyse est introduite ; marque l'index sale. Classe Edit
edit_batch EditBatchTool Appliquer des opérations node_replace et node_insert sur plusieurs fichiers en une transaction : chaque fichier ré-analysé (validate: "parse") ou le build lancé (validate: "build") ; tout est appliqué ou chaque fichier reste identique à l'octet ; liste la plage de chaque opération. Classe Edit

Montages et embeddings locaux

Tool Classe Enregistrement Cas d'usage
list_mounts ListMountsTool (Orkeon.Tools.Abstractions) AddOrkeonAbstractionTools() Lister les montages VFS visibles par l'agent, avec chemins virtuels et droits d'accès. Résultat typé { mounts: [{ virtual_path, access, overrides: [{ virtual_path, access }] }] }
local_embed_text LocalEmbedTool (Orkeon.Tools.Embeddings.Local) AddOrkeonLocalEmbeddings() Embarquer des textes sur l'appareil (BGE-micro-v2 ONNX, 384 dims, CPU — pas de réseau à l'exécution, pas de clé d'API ; le premier build d'un consommateur télécharge le modèle depuis huggingface.co ; ExcludeAssets="build" sur chaque référence qui atteint le paquet évite le téléchargement, et le premier embedding échoue alors sauf si le modèle est dans LocalEmbeddingsModel/default/model.onnx ou si LocalEmbeddingOptions.ModelPath en nomme un, voir limitations)

Tools côté hôte

Tool Classe Enregistrement Cas d'usage
progress_report ProgressReportTool (Orkeon.Cli.Commands.Scripting) AddScriptCommands(...) (l'hôte des commandes scriptées) Rapporter la progression d'une opération scriptée longue sur la ligne de statut du CLI
spawn_agent SpawnAgentScriptTool (Orkeon.Scripting) l'hôte de scripts, toujours proposé au modèle dans act Exécuter un agent nommé de la crew comme enfant et renvoyer sa sortie, sous un budget enfant (profondeur + 1) ; { "agent": "researcher", "input": "Summarise the findings" }

Hors catalogue

Délibérément hors des 124 classes de tools intégrées :

  • brief_submit / blueprint_submit — internes Ă  la commande orkeon forge (ForgeSubmission.cs, Orkeon.Scripting.Cli) ; les agents du moteur les utilisent, un crew ne les liste jamais.
  • McpToolAdapter (Orkeon.Infrastructure.MCP) — adapte un tool d'un serveur MCP externe en IBaseTool ; son nom est celui du tool distant, dĂ©cidĂ© Ă  l'exĂ©cution (voir MCP).
  • JsTool (tools dynamiques dĂ©finis en script), MockTool (double de test), ObservedTool (dĂ©corateur de tĂ©lĂ©mĂ©trie) et AIAgentTool (Orkeon.Interop.AgentFramework — enveloppe un agent Microsoft Agent Framework que vous fournissez) — infrastructure qui matche le glob de fichiers, exclue par la règle de comptage.

Synthèse par catégorie

En comptant les classes de tools concrètes avec la règle énoncée en tête de page — le nombre qu'affichent le README et l'index de la documentation, vérifié par scripts/check-doc-claims.py :

Package Classes de tools
Orkeon.Tools.Data 22
Orkeon.Tools.Analysis (RaggableTree — voir son guide) 29
Orkeon.Tools.Email (voir son guide) 13
Orkeon.Tools.Drive (voir son guide) 11
Orkeon.Infrastructure (collaboration, session, sandbox, entrée humaine, semantic_search, system_one_decide, memory_recall, mcp_prompt_get) 15
Orkeon.Tools.Web 11
Orkeon.Tools.EventHub 7
Orkeon.Tools.FileSystem 8
Orkeon.Tools.Rag 3
Orkeon.Tools.Abstractions / Orkeon.Tools.Code / Orkeon.Tools.Embeddings.Local / Orkeon.Cli.Commands.Scripting / Orkeon.Scripting 1 chacun
Total 124

Disponibilité par racine de composition

Les deux racines de composition livrées n'enregistrent pas les mêmes suites. Sources : RunnerHost.cs + RunnerExecution.cs/RunCommand.cs pour le CLI, Program.cs pour le REPL. orkeon run construit un hôte différent pour un crew YAML (via RunnerExecution) et pour un script .ork.ts (directement sur RunnerHost) ; là où les deux diffèrent, la table le dit. L'hôte de service orkeon-host s'appuie sur le même RunnerHost : il a donc la suite de RunnerHost — tout ce que liste la première colonne sauf semantic_search — et enregistre human_input lui-même : une question attend sa réponse sur POST /runs/{id}/input. orkeon mcp serve construit l'hôte d'orkeon run --list-tools et sert ses outils à un client MCP, human_input à part — voir Intégration MCP.

Suite / tool orkeon run (CLI) orkeon-repl (ConsoleApp)
FileSystem (8), Data (22), Web cœur (6), shell_command, list_mounts, session (6) ✅ ✅
E-mail (13) — les tools de boîte aux lettres refusent tout appel tant qu'aucun compte n'est déclaré sous Orkeon:Tools:Email ✅ (jetons OAuth sous la racine interne /credentials) ✅ comptes à mot de passe seulement — le REPL ne tient aucun magasin de jetons, un compte OAuth y est refusé
Drive (11) — chaque tool sauf drive_accounts refuse tout appel tant qu'un compte n'est pas déclaré sous Orkeon:Tools:Drive et connecté ✅ (jetons OAuth sous la racine interne /credentials) enregistrés, mais chaque compte y est refusé : tous se connectent en OAuth, et le REPL ne tient aucun magasin de jetons
EventHub (7) ✅ ❌
Analysis (29) âś… (sauf RaggableTree:Enabled = false) âś…
local_embed_text ✅ tant que RaggableTree est actif avec son provider d'embeddings local par défaut ✅
RAG (rag_search, rag_ingest, rag_eval) ✅ enregistrés par tout hôte RunnerHost — orkeon run sous toutes ses formes, orkeon-host, orkeon mcp serve —, avec le reranker ONNX : un agent YAML qui en liste un le reçoit, un script les atteint par tools.ragSearch et rag.* ✅ enregistrés, avec le reranker ONNX : un agent YAML qui en liste un le reçoit
web_search, cache_search ✅ ❌
brave_search ✅ seulement si BRAVE_API_KEY est posée ❌
slack_send_message, slack_read_messages ❌ (opt-in hôte) ❌
Les outils des serveurs MCP déclarés par MCP:Servers ✅ connectés avant le chargement de la crew, sous leur propre nom — un agent les liste dans tools: comme tout autre outil (voir le pipeline de résolution plus bas) ✅ connectés avant le chargement des commandes scriptées, sous leur propre nom
semantic_search ✅ pour un crew YAML (câblé par la commande run) ❌
human_input ✅ pour un crew YAML (sur le flux d'événements sous --events, approuvé automatiquement sinon) ✅ (invite console)
ask_question_to_coworker, delegate_work_to_coworker par agent, quand AllowDelegation est actif par agent
spawn_agent (script, SpawnAgentScriptTool) ✅ proposé au modèle dans le ctx.llm.act du corps d'un agent de crew ❌ (une commande scriptée n'exécute aucun agent de crew)
spawn_agent (C# SpawnAgentTool) ❌ (l'hôte doit l'enregistrer) ❌
code_interpreter enregistrement en type concret seulement — non résoluble par nom idem
progress_report ❌ ✅ (commandes scriptées)
system_one_decide ✅ quand un fournisseur de décision est configuré (Orkeon:Decision:Provider, ou déduit de sa section ou de sa clé d'API) ✅ même règle
mcp_prompt_get ✅ quand MCP:Servers déclare des serveurs ✅ même règle
memory_recall ✅ quand Orkeon:CognitiveMemory:Enabled = true, tenu par une crew à memory: true ❌

orkeon forge s'appuie sur l'hôte des runners mais retire shell_command et code_interpreter du catalogue où puise un crew forgé. Les douze tools de boîte aux lettres y restent : un essai les joue sur une boîte d'essai fictive et n'atteint jamais la vraie boîte de l'opérateur (voir Crews forgés). Les onze tools drive sont retirés eux aussi : il n'y a pas de drive d'essai, et un essai lirait et modifierait le vrai drive de l'opérateur.

Résolution des tools par nom (YAML → instance)

Quand un crew est défini en YAML, les tools sont référencés par leur nom (la propriété Name de la classe du tool). La résolution passe par IToolRegistry (Orkeon.Domain.Tools) ; AddOrkeonInfrastructure() enregistre le ToolRegistry par défaut (Orkeon.Infrastructure.Tools, dans le paquet Orkeon), qui indexe par nom, sans tenir compte de la casse, chaque IBaseTool enregistré en DI — les runners et tout hôte qui embarque utilisent le même.

Pipeline de résolution

Config YAML : tools: ["relational_database_query", "csv_reader"]
       ↓
CrewFactory appelle IToolRegistry.GetToolByNameAsync("relational_database_query")
       ↓
IToolRegistry cherche le tool enregistré avec Name == "relational_database_query"
       ↓
Trouvé → attaché à l'Agent (AgentBuilder.WithTools())
Absent →
    StrictTools (défaut des runners)       → le crew ne se charge pas, avec la liste des tools disponibles
    mode tolérant (défaut de la bibliothèque) → un avertissement, et l'agent tourne sans ce tool

La sévérité est Orkeon:CrewFactory:StrictTools (true dans les runners, CrewFactoryOptions.StrictTools à false pour un hôte à vous). Tout tool que tient le registre atteint un agent qui le nomme — un tool ToolBase, un tool de script, un tool RAG, le tool d'un serveur MCP connecté : IBaseTool est l'unique contrat.

Un nom appartient à un seul tool. Deux tools enregistrés dans la DI sous le même nom arrêtent l'hôte au démarrage avec une erreur qui nomme le nom et les deux types ; un tool enregistré plus tard sous un nom déjà tenu (IToolRegistry.RegisterToolAsync) est refusé — l'appel renvoie false et le tool enregistré garde le nom.

Enregistrement des tools

Les tools sont enregistrés dans IToolRegistry au démarrage de l'application via les extensions DI (chaque table ci-dessus nomme celle qui possède ses tools) :

services.AddOrkeonFileSystemTools();   // file_read, file_write, edit_file, directory_read, directory_search, count_pattern, glob, grep
services.AddOrkeonDataTools();         // les 22 tools de données (relationnel + MongoDB + graphe chaînés en interne)
services.AddOrkeonWebTools();          // http_api, web_scrape, scrape_element, github, image_generation, firefox
services.AddOrkeonCodeTools();         // shell_command
services.AddOrkeonAbstractionTools();  // list_mounts
services.AddOrkeonSessionTools();      // session_store, session_snip, session_stats, session_cost, token_budget, memory_store
services.AddOrkeonInMemoryEventHub();
services.AddOrkeonEventHubTools();     // les 7 tools du hub d'événements
services.AddOrkeonEmailTools(configuration); // les 13 tools email_* ; ceux de boîte aux lettres demandent un compte déclaré
services.AddOrkeonDriveTools(configuration); // les 11 tools drive_* ; ils demandent un compte déclaré et connecté
services.AddRaggableTreeTools();       // les 29 tools d'analyse
services.AddOrkeonLocalEmbeddings();   // local_embed_text
services.AddSemanticSearchTool();      // semantic_search (l'extension vit dans Orkeon.Hosting)
services.AddOrkeonWebSearchTool();     // web_search
services.AddOrkeonCacheSearchTool();   // cache_search
services.AddOrkeonRag(configuration); services.AddOrkeonRagTools(); // rag_search, rag_ingest, rag_eval (opt-in)

rag_search/rag_ingest/rag_eval sont opt-in — voir docs/reference/opt-in-subsystems.md.

Noms Ă  utiliser en YAML

Le nom exact à utiliser dans la section YAML tools: est la valeur de la propriété Name de la classe du tool — la colonne Tool de chaque table ci-dessus. Table de correspondance alphabétique complète :

Nom YAML Classe Package
access_cost AccessCostTool Orkeon.Tools.Analysis
affected_tests AffectedTestsTool Orkeon.Tools.Analysis
arcadedb_query ArcadeDbTool Orkeon.Tools.Data
ask_question_to_coworker AskQuestionTool Orkeon.Infrastructure
batch_anchors BatchAnchorsTool Orkeon.Tools.Analysis
brave_search BraveSearchTool Orkeon.Tools.Web
cache_search CacheSearchTool Orkeon.Tools.Web
code_interpreter SecureCodeInterpreterTool Orkeon.Infrastructure
codebase_map CodebaseMapTool Orkeon.Tools.Analysis
codebase_search CodebaseSearchTool Orkeon.Tools.Analysis
complexity_report ComplexityReportTool Orkeon.Tools.Analysis
count_pattern CountPatternTool Orkeon.Tools.FileSystem
csv_reader CsvReaderTool Orkeon.Tools.Data
database_schema DatabaseSchemaTool Orkeon.Tools.Data
delegate_work_to_coworker DelegateWorkTool Orkeon.Infrastructure
dependency_graph DependencyGraphTool Orkeon.Tools.Analysis
directory_read DirectoryReadTool Orkeon.Tools.FileSystem
directory_search DirectorySearchTool Orkeon.Tools.FileSystem
documented_in DocumentedInTool Orkeon.Tools.Analysis
documents_of DocumentsOfTool Orkeon.Tools.Analysis
docx_reader DocxReadTool Orkeon.Tools.Data
docx_writer DocxWriteTool Orkeon.Tools.Data
drive_accounts DriveAccountsTool Orkeon.Tools.Drive
drive_create_folder DriveCreateFolderTool Orkeon.Tools.Drive
drive_delete DriveDeleteTool Orkeon.Tools.Drive
drive_download DriveDownloadTool Orkeon.Tools.Drive
drive_info DriveInfoTool Orkeon.Tools.Drive
drive_list DriveListTool Orkeon.Tools.Drive
drive_move DriveMoveTool Orkeon.Tools.Drive
drive_read DriveReadTool Orkeon.Tools.Drive
drive_search DriveSearchTool Orkeon.Tools.Drive
drive_share DriveShareTool Orkeon.Tools.Drive
drive_upload DriveUploadTool Orkeon.Tools.Drive
edge_list EdgeListTool Orkeon.Tools.Analysis
edit_batch EditBatchTool Orkeon.Tools.Analysis
edit_file EditFileTool Orkeon.Tools.FileSystem
email_accounts EmailAccountsTool Orkeon.Tools.Email
email_create_folder EmailCreateFolderTool Orkeon.Tools.Email
email_delete EmailDeleteTool Orkeon.Tools.Email
email_draft EmailDraftTool Orkeon.Tools.Email
email_folders EmailFoldersTool Orkeon.Tools.Email
email_mark EmailMarkTool Orkeon.Tools.Email
email_move EmailMoveTool Orkeon.Tools.Email
email_parser EmailParserTool Orkeon.Tools.Email
email_read EmailReadTool Orkeon.Tools.Email
email_rename_folder EmailRenameFolderTool Orkeon.Tools.Email
email_save_attachment EmailSaveAttachmentTool Orkeon.Tools.Email
email_search EmailSearchTool Orkeon.Tools.Email
email_send EmailSendTool Orkeon.Tools.Email
file_read FileReadTool Orkeon.Tools.FileSystem
file_write FileWriteTool Orkeon.Tools.FileSystem
firefox FirefoxTool Orkeon.Tools.Web
flow_trace FlowTraceTool Orkeon.Tools.Analysis
get_last_value GetLastValueTool Orkeon.Tools.EventHub
github GitHubTool Orkeon.Tools.Web
glob GlobTool Orkeon.Tools.FileSystem
graph_schema GraphSchemaTool Orkeon.Tools.Data
grep GrepTool Orkeon.Tools.FileSystem
http_api HttpApiTool Orkeon.Tools.Web
human_input HumanInputTool Orkeon.Infrastructure
image_generation ImageGenerationTool Orkeon.Tools.Web
impact_analysis ImpactAnalysisTool Orkeon.Tools.Analysis
incremental_reindex IncrementalReindexTool Orkeon.Tools.Analysis
index_codebase IndexCodebaseTool Orkeon.Tools.Analysis
index_status IndexStatusTool Orkeon.Tools.Analysis
is_path_indexed IsPathIndexedTool Orkeon.Tools.Analysis
janusgraph_query JanusGraphTool Orkeon.Tools.Data
json_tool JsonTool Orkeon.Tools.Data
list_mounts ListMountsTool Orkeon.Tools.Abstractions
local_embed_text LocalEmbedTool Orkeon.Tools.Embeddings.Local
mariadb_query MariaDbDatabaseTool Orkeon.Tools.Data
mcp_prompt_get McpPromptGetTool Orkeon.Infrastructure
mdx_search MdxSearchTool Orkeon.Tools.Data
memory_recall MemoryRecallTool Orkeon.Infrastructure (opt-in, AddOrkeonCognitiveMemory)
memory_store MemoryStoreTool Orkeon.Infrastructure
mongodb_query MongoDbTool Orkeon.Tools.Data
mongodb_schema MongoDbSchemaTool Orkeon.Tools.Data
mysql_query MySqlDatabaseTool Orkeon.Tools.Data
node_ensure NodeEnsureTool Orkeon.Tools.Analysis
node_insert NodeInsertTool Orkeon.Tools.Analysis
node_outline NodeOutlineTool Orkeon.Tools.Analysis
node_read NodeReadTool Orkeon.Tools.Analysis
node_replace NodeReplaceTool Orkeon.Tools.Analysis
package_summary PackageSummaryTool Orkeon.Tools.Analysis
pdf_reader PdfReaderTool Orkeon.Tools.Data
pdf_search PdfSearchTool Orkeon.Tools.Data
post_message PostMessageTool Orkeon.Tools.EventHub
postgres_query PostgresDatabaseTool Orkeon.Tools.Data
progress_report ProgressReportTool Orkeon.Cli.Commands.Scripting
publish_event PublishEventTool Orkeon.Tools.EventHub
rag_eval RagEvalTool Orkeon.Tools.Rag (opt-in)
rag_ingest RagIngestTool Orkeon.Tools.Rag (opt-in)
rag_search RagSearchTool Orkeon.Tools.Rag (opt-in)
receive_message ReceiveMessageTool Orkeon.Tools.EventHub
relational_database_query RelationalDatabaseTool Orkeon.Tools.Data
reply_to ReplyToTool Orkeon.Tools.EventHub
scrape_element ScrapeElementTool Orkeon.Tools.Web
semantic_search SearchTool Orkeon.Infrastructure (opt-in, enregistré par Orkeon.Hosting)
send_request SendRequestTool Orkeon.Tools.EventHub
session_cost SessionCostTool Orkeon.Infrastructure
session_snip SessionSnipTool Orkeon.Infrastructure
session_stats SessionStatsTool Orkeon.Infrastructure
session_store SessionStoreTool Orkeon.Infrastructure
shell_command ShellCommandTool Orkeon.Tools.Code
slack_read_messages SlackReadTool Orkeon.Tools.Web (opt-in)
slack_send_message SlackTool Orkeon.Tools.Web (opt-in)
spawn_agent SpawnAgentTool Orkeon.Infrastructure (enregistré par l'hôte)
spawn_agent SpawnAgentScriptTool Orkeon.Scripting (hĂ´te de script, offert dans act)
sqlserver_query SqlServerDatabaseTool Orkeon.Tools.Data
statement_query StatementQueryTool Orkeon.Tools.Analysis
structural_rewrite StructuralRewriteTool Orkeon.Tools.Analysis
structural_search StructuralSearchTool Orkeon.Tools.Analysis
sub_graph SubGraphTool Orkeon.Tools.Analysis
symbol_detail SymbolDetailTool Orkeon.Tools.Analysis
symbol_source SymbolSourceTool Orkeon.Tools.Analysis
system_one_decide SystemOneDecideTool Orkeon.Infrastructure (opt-in, AddOrkeonDecisionProvider)
token_budget TokenBudgetTool Orkeon.Infrastructure
txt_search TxtSearchTool Orkeon.Tools.Data
wait_for_event WaitForEventTool Orkeon.Tools.EventHub
web_scrape WebScrapeTool Orkeon.Tools.Web
web_search WebSearchTool Orkeon.Tools.Web
xlsx_reader XlsxReadTool Orkeon.Tools.Data
xlsx_writer XlsxWriteTool Orkeon.Tools.Data
xml_parser XmlParserTool Orkeon.Tools.Data

Enregistrer un tool custom dans le registre

Pour qu'un tool custom soit utilisable en YAML, il doit être enregistré dans IToolRegistry :

// Option 1 — via DI (lu par le ToolRegistry par défaut)
services.AddSingleton<IBaseTool, MyCustomTool>();

// Option 2 — enregistrement explicite au runtime
var registry = host.Services.GetRequiredService<IToolRegistry>();
await registry.RegisterToolAsync(new MyCustomTool());

Dérivez le tool de ToolBase (ou implémentez directement IBaseTool) — voir Créer un nouveau tool. Le tool sera alors accessible en YAML via son Name :

agents:
  my_agent:
    tools:
      - "my_custom_tool"  # Correspond à la propriété Name du tool

Manques fonctionnels identifiés

Les catégories suivantes ne sont pas couvertes par les tools existants :

  • Écriture de fichiers structurĂ©s : docx_writer et xlsx_writer couvrent Word et Excel, mais il n'y a pas d'Ă©crivain structurĂ© CSV ou PDF. FileWriteTool n'Ă©crit que du texte brut (un CSV peut bien sĂ»r s'Ă©crire comme du texte).
  • Transformation de donnĂ©es : pas de tool ETL pour convertir entre formats (CSV → JSON, XML → CSV, etc.).
  • Notifications et alertes : l'e-mail est couvert — email_send, limitĂ© Ă  la liste d'autorisation de chaque compte (voir Outils e-mail) — et Slack par un opt-in de l'hĂ´te ; il n'y a pas de tool SMS, push ou Teams.
  • ContrĂ´le de version : pas de tool Git natif pour commit, branche, diff (shell_command autorise par dĂ©faut les sous-commandes git en lecture seule).
  • Calendrier / Planification : pas de tool pour interagir avec des calendriers (Google Calendar, Outlook, etc.).
  • Stockage cloud : Google Drive et OneDrive sont couverts par les tools drive (voir Outils drive) ; il n'y a pas de tool pour S3, Azure Blob, GCS, Dropbox, ni pour les drives partagĂ©s Google et les bibliothèques SharePoint.
  • Authentification OAuth : pas de tool gĂ©nĂ©rique pour les flux OAuth exigĂ©s par des APIs tierces — OAuth n'existe que pour les comptes e-mail et drive, connectĂ©s une fois avec orkeon email login ou orkeon drive login.
  • Traitement d'images : les images atteignent un modèle par le pipeline multimodal opt-in (AddOrkeonMultiModal, IMultiModalContentLoader), mais aucun tool ne transforme ni n'analyse une image ; image_generation ne fait qu'en crĂ©er une.