🇬🇧 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) etorkeon-hostenregistrent le sous-système RAG et ses trois tools : un agent de crew peut donc les lister danstools:;orkeon-replaussi, et un hôte C# qui appelleAddOrkeonRag(configuration)+AddOrkeonRagTools(). La façade de scripting (tools.ragSearch, l'espace de nomsrag.*) etorkeon ragatteignent les mêmes pipelines.rag_searchetrag_evalse replient surOrkeon:Rag:Collectionquand 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 commandeorkeon 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 enIBaseTool; 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) etAIAgentTool(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_writeretxlsx_writercouvrent Word et Excel, mais il n'y a pas d'écrivain structuré CSV ou PDF.FileWriteTooln'é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_commandautorise 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 loginouorkeon 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_generationne fait qu'en créer une.