Table of Contents

🇬🇧 English version

Référence de configuration (appsettings.json)

Cette page est la carte unique des réglages que lit Orkeon : d'où ils viennent, quand l'un d'eux est refusé, puis chaque clé, par catégorie — son type, son défaut, son sens et l'hôte qui la lit (Trouver un réglage) —, et enfin les variables d'environnement que lit Orkeon. Une section qui ne prend effet qu'après un enregistrement dédié le dit — voir Sous-systèmes opt-in pour le détail de chacun.

D'où viennent les réglages

Chaque hôte Orkeon — les hôtes runner (RunnerHost.Build, utilisé par orkeon run, les runners YAML et orkeon-host) et le REPL — compose les mêmes couches, et elles seules (RunnerSettings.ComposeSources). Sous toutes se trouvent les variables d'environnement sans préfixe : le OTEL_EXPORTER_OTLP_ENDPOINT standard que pose un collecteur ou un AppHost .NET Aspire atteint par elles l'exportateur OpenTelemetry (télémétrie), et un Llm__Model nu est lu aussi, sous chacune des couches qui suivent :

  1. Un appsettings.json résolu — chaîne de résolution (RunnerSettings.ResolveSettingsPath) : --settings <chemin> explicite → appsettings.json à côté de la config de crew → appsettings/appsettings.json en remontant l'arborescence (examples/appsettings/appsettings.json dans ce dépôt) → la config globale par utilisateur écrite par orkeon init. Aucun fichier trouvé ⇒ variables d'environnement uniquement.
  2. Les variables d'environnement préfixées ORKEON_ (AddEnvironmentVariables("ORKEON_"), pour chaque hôte et pour orkeon doctor). Mapping .NET standard : __ sépare les niveaux — ORKEON_Llm__ApiKey surcharge Llm:ApiKey, ORKEON_Orkeon__Rag__Profile surcharge Orkeon:Rag:Profile. Le préfixe et les clés se comparent sans la casse, et : sépare les niveaux comme __ : ORKEON_LLM__APIKEY, orkeon_llm__apikey et ORKEON_Llm:ApiKey valent tous Llm:ApiKey. Sous Linux et macOS, deux graphies d'un réglage sont deux variables, et un run lit l'une ou l'autre : ne posez jamais un même réglage sous deux graphies. Les variables sont ajoutées après le fichier : elles gagnent. Une clé n'a pas à venir de l'une ou l'autre couche : le fichier peut nommer la variable qui la contient (ApiKeyEnvVar, plus bas), lue quand aucune ne résout d'ApiKey.
  3. Les surcharges CLI de montage — chaque argument --mount devient une entrée mémoire Orkeon:FileSystem:Mounts:<i> (précédence maximale), placée par racine virtuelle : un --mount sur une racine que le tableau déclaré (les couches ci-dessus) tient déjà est écrit à l'index de la première entrée et remplace toutes les entrées déclarées de cette racine pour le run ; un --mount sur une racine neuve est ajouté après le plus haut index déclaré. Le montage /crew (ou /script) du runner et les InternalMounts sont toujours ajoutés. Une entrée déclarée peut porter un identifiant — l'ULID de 26 caractères devant un |, 01J9Z3K4M5N6P7Q8R9S0T1V2W3|C:\data:/output:rw — et plusieurs entrées peuvent déclarer une même racine si chacune en porte un : --mount-id <ulid>, sinon le bloc mounts: de la crew, sélectionne l'entrée que le run garde, et toute autre entrée de cette racine est retirée — sa clé est écrite à null à son propre index, son chemin de base n'est pas mis en liste blanche et son dossier n'est pas sondé. orkeon-repl place ses arguments --mount de la même façon, sur ses propres couches — sa ligne de commande (--Orkeon:FileSystem:Mounts:<n>=…) parmi elles, jugée comme le fichier.

Les contrôles qu'une commande mène avant son hôte — une racine réservée, une racine déclarée deux fois, une sélection sans réponse, un dossier de montage absent — lisent ces mêmes couches (RunnerSettings.ReadDeclaredMounts, sur RunnerSettings.ReadConfiguration) : un montage déclaré par une variable, préfixée ORKEON_ ou non, est jugé comme la même ligne du fichier.

Rien d'autre n'est lu : ni les appsettings.json, appsettings.{Environment}.json et <binaire>.settings.json du dossier courant, ni, en Development, les secrets utilisateur — un fichier d'un autre projet ajouterait sinon ses profils, serveurs MCP ou montages au run. orkeon-host lit ./appsettings.json comme son fichier de réglages, quand --settings n'en nomme aucun, jamais sous celui qu'il nomme ; le REPL lit ses fichiers --settings, sinon le fichier global, puis sa ligne de commande, en dernier (CLI).

Le même préfixe ORKEON_ alimente aussi EnvironmentSecretProvider (résolution de secrets, p. ex. OPENAI_API_KEY → ORKEON_OPENAI_API_KEY ; la clé Tavily de l'outil web_search est ORKEON_TAVILY_API_KEY). Le second maillon de cette chaîne est la section Secrets du fichier (Secrets:TAVILY_API_KEY), la variable d'environnement l'emportant quand les deux existent. Les variables qu'un binaire lit par leur propre nom — elles ne portent aucun réglage — sont listées avec les autres dans Variables d'environnement.

Ce que cela signifie en pratique. Le fichier est la base durable et partagée ; tout ce qui se pose dessus est un calque éphémère qui vit et meurt avec un processus. La vérification llm-config d'orkeon doctor compose exactement comme un runner (même chaîne de résolution, mêmes couches : les variables sans préfixe, le fichier, la surcouche ORKEON_) : son verdict répond à la question qu'utiliserait un run lancé depuis ce shell, sans calque propre au lancement ? Les réglages nommés d'un client peuvent emprunter la couche 2 : le réglage élu par défaut peut être écrit en entier dans la section Llm du fichier — adresse, modèle, délai, interrupteur de réflexion et variable qui contient sa clé (ApiKeyEnvVar), jamais la clé —, si bien qu'un orkeon run manuel en terminal ou une équipe planifiée suit la même élection, ses 600 s et sa clé comprises (c'est ce que llm-config reflète), tandis qu'une équipe qui a élu un autre réglage peut le recevoir en variables ORKEON_Llm__* sur son seul lancement — chaque champ que le réglage modélise, vide là où il n'en fixe pas, pour que rien du défaut, et sa clé moins que tout, n'atteigne l'adresse de l'équipe ; llm-config ne peut pas les voir, car elles n'existent nulle part tant que ce lancement n'a pas démarré. Chaque réglage peut aussi être écrit dans Llm:Profiles du fichier, avec le nom de la variable qui contient sa clé et jamais la clé, comme profil d'hôte qu'une crew peut nommer (plus bas). Aucun fichier n'est jamais généré : la composition est en mémoire.

Un fichier d'où partir. Chaque installation porte appsettings.sample.json à la racine de ce que son canal installe, à côté de VERSION : chaque clé qu'un binaire livré lit, par catégorie, à son défaut — produit depuis le catalogue des réglages, celui que liste orkeon settings. Aucun binaire ne le charge. Copié tel quel à la place du fichier de réglages, il ne change rien : chaque clé qu'il écrit porte la valeur qu'elle a quand on l'omet, et ce qui ne s'écrit pas ainsi — une clé sans défaut, un secret, une liste, une entrée sous un nom que vous choisissez, une clé qu'un profil RAG fixe, la section Llm entière — est montré en commentaire, à décommenter. C'est du JSON avec des commentaires // et une virgule après chaque membre, que les lecteurs de réglages acceptent (les runners) ; un analyseur JSON strict, non.

Quand un réglage est refusé

Chaque hôte livré — orkeon run sous toutes ses formes (--validate, --list-tools, mcp serve, la forge, rag, email), orkeon-host et orkeon-repl — juge tout réglage qu'il lit à son démarrage, que le run s'en serve ou non : avant le chargement de la crew, avant tout appel au modèle, avant qu'un avertissement ne s'imprime ou que la télémétrie ne démarre. Un refus tient en une ligne qui nomme la clé — code de sortie 1 pour orkeon et orkeon-repl, 78 pour orkeon-host —, et orkeon doctor rapporte les mêmes refus sur le même fichier, une ligne runner-settings chacun. Ce qui est refusé :

  • Une valeur que le lieur de configuration ne convertit pas ("Orkeon:Guardian:Enabled": "oui"), ou qu'une règle de sa section refuse (Orkeon:Rag:Retrieval:TopK à 0, un Orkeon:Sqlite:TableName qu'on ne peut pas donner à SQLite). La section Llm est lue aussi strictement que ses profils : un TimeoutSeconds de "600s" est refusé, Thinking:Enabled et Grammar valent true ou false, et une Temperature est un nombre fini — NaN, Infinity ou 1e400 (lu comme l'infini) passaient la lecture, puis faisaient échouer chaque requête, JSON n'écrivant aucun tel nombre. De même pour tout nombre qu'une section lit en float ou en double (Orkeon:Rag:Generation:Temperature, Orkeon:CrewMemory:MinScore, …), que le lieur prend en NaN ou en infini sans un mot. Un niveau de Logging est l'un de Trace, Debug, Information, Warning, Error, Critical, None, sans tenir compte de la casse.
  • Une clé qu'aucune section ne porte, contre la forme que déclarent ses lecteurs — les lecteurs d'une même section ensemble, une sous-section qu'un autre lecteur déclare comprise : Orkeon:Guardian:Enabeld, Llm:Modle. Le refus d'une clé inconnue se termine par la commande qui liste les clés de sa section — `orkeon settings Orkeon:Guardian` lists its keys. Un nom de section sous Orkeon: et sous les groupes Orkeon:Cli, Orkeon:Tools, Orkeon:Scripting, Orkeon:Security et Security doit être l'une de celles qu'Orkeon lit (SettingsSections) ; le refus propose la plus proche (Orkeon:Guardain → Orkeon:Guardian). Clés et noms de section se comparent sans tenir compte de la casse, comme la configuration les lit : ORKEON_LLM__APIKEY est Llm:ApiKey, et "llm": { "apikey": … } aussi.
  • Un nom par lequel on choisit un composant, contre les noms que connaît cet hôte, la liste dans le refus : Memory:Provider et Orkeon:Rag:Provider, avec ce qu'il faut au fournisseur nommé (Orkeon:LanceDb:Endpoint pour lancedb ; Orkeon:Pinecone:ApiKey et IndexName, ou Host, pour pinecone) ; Orkeon:Rag:Profile ; les Rerank:Kind, QueryTransform:Mode, Context:Ordering et Ingestion:DefaultChunkingStrategy des options RAG effectives — profil plus surcharges, si bien qu'un hôte sans le reranker ONNX refuse balanced et quality en nommant onnx ; Orkeon:Rag:QueryRouting:Classifier ; Orkeon:Embeddings:Provider ; RaggableTree:Embedding:Provider. Le memoryProvider: d'une crew YAML est vérifié à son chargement.
  • Un identifiant de modèle vide : une entrée de Llm:ModelCapabilities nommée "" ou " ", ou :Vision (une clé sans identifiant avant son champ), quoi qu'elle contienne, est refusée avec Llm:ModelCapabilities: an entry has no model id; name each entry by the model it describes.

Ce qui reste ouvert : la racine de la configuration — elle reçoit aussi les variables d'environnement sans préfixe, et rien n'y distingue une section mal écrite d'une variable de la machine —, Logging au-delà de ses niveaux, Secrets, les clés d'un dictionnaire (Llm:Profiles:<nom>, MCP:Servers:<id>, …:Env:<VAR>, Orkeon:Consensus:RoleWeights:<rôle>, Orkeon:Tools:Email:Accounts:<nom>) et les index d'une liste, et les clés d'une section que cet hôte ne lit pas — orkeon run laisse Orkeon:Host au démon, qui la juge ; une section qu'aucun binaire livré ne lit est signalée, pas jugée (ci-dessous). Les comptes e-mail sont l'exception : un compte qui porte une valeur ou une clé illisible est mis de côté et signalé quand un appel ou orkeon email le nomme, et les autres continuent de fonctionner (e-mail).

Un hôte C# qui démarre (StartAsync, un AppHost .NET Aspire) refuse les valeurs et les noms que lient ses inscriptions Orkeon — chacune est inscrite avec ValidateOnStart — ; les clés de ses sections restent les siennes. Un conteneur bâti à la main et jamais démarré ne juge rien tant qu'aucune option n'est lue.

Quand un réglage est seulement signalé

Une section qu'Orkeon connaît et qu'aucun binaire livré ne lit n'est pas refusée : un fichier de réglages partagé entre orkeon run et un hôte écrit en C# est légitime. Elle n'est pas lue en silence non plus — le run démarrerait sans la limite, le budget ou le filtrage que le fichier décrit. Chaque hôte livré le dit à son démarrage, une fois par section et par processus, sur stderr (la sortie standard reste celle du run) et dans son journal, puis démarre ; le code de sortie est celui du run :

WARNING: ToolRateLimiting is read by no component of this host: a C# host reads it through AddOrkeonToolRateLimiting(). The calls to the model are limited by RateLimiting, which this host reads.

orkeon doctor rapporte la même phrase en ligne warn de runner-settings, une par section, et sort toujours en 0. Les sections sont celles que le catalogue des réglages marque comme lues par aucun binaire livré : ToolRateLimiting, TokenBudget, Orkeon:Dlp, Orkeon:Monitoring, Orkeon:MultiModal et Orkeon:VectorSearch (sous-systèmes opt-in). La liste est calculée, pas écrite : une section qu'un binaire livré se met à lire en sort. Ne sont pas signalées : une section qu'un autre binaire livré lit (Orkeon:Host dans un fichier que lit orkeon run), une section de la racine qu'Orkeon ne connaît pas, et une section que l'hôte lit lui-même parce que sa composition C# a enregistré ce qui la lit. L'environnement ORKEON_ écrit une section comme le fichier : ORKEON_ToolRateLimiting__GlobalToolRequestsPerMinute reçoit la même ligne.

Trouver un réglage

Chaque réglage que lit Orkeon est listé plus bas, rangé par ce à quoi il sert : onze catégories, une partie de cette page chacune. Dans une catégorie, chaque section a sa sous-partie — ce que fait la section, qui la lit, puis une ligne par clé : son type, son défaut, les valeurs qu'elle accepte quand leur liste est fermée, et son sens.

Catégorie Sections Clés
Modèles Evaluation, Llm, LlmLogging, Orkeon:CostTracking, Orkeon:Decision, Orkeon:Kev, Orkeon:Liquid, Orkeon:TokenCounter, Orkeon:TypeSafe 103
Débit et budgets RateLimiting, TokenBudget, ToolRateLimiting 11
Mémoire et vecteurs Memory, Orkeon:ChromaDb, Orkeon:CognitiveMemory, Orkeon:CrewMemory, Orkeon:EmbeddingCache, Orkeon:Embeddings, Orkeon:Encryption, Orkeon:LanceDb, Orkeon:Pinecone, Orkeon:Redis, Orkeon:Sqlite, Orkeon:VectorSearch 69
RAG Orkeon:Rag, Orkeon:Rag:Ingestion, Orkeon:Rag:QueryRouting, Orkeon:Rag:Retrieval:Hybrid, Orkeon:Rag:WebFallback 34
Fichiers et bac à sable Orkeon:CodeSandbox, Orkeon:CodeSandbox:Docker, Orkeon:FileSystem, Orkeon:Sandbox, PathSecurity 33
Sécurité Orkeon:Dlp, Orkeon:Guardian, Orkeon:Security:PermissionGate, Secrets, Security:Audit, Security:Prompt, Security:ToolResults, Security:Url, Security:Vault 40
Outils BRAVE_API_KEY, MCP, MCP:Server, Orkeon:MultiModal, Orkeon:Tools:Drive, Orkeon:Tools:Email, Orkeon:Tools:Firefox, Orkeon:Tools:GitHub, Orkeon:Tools:ResultLimits, Orkeon:Tools:Shell, Plugins, RaggableTree 110
Orchestration et persistance Orkeon:Checkpointing, Orkeon:Consensus, Orkeon:CrewFactory, Orkeon:ExecutionState:Persistence, Orkeon:HumanInput, Orkeon:RunHistory 28
Scripts et console Orkeon:Cli:ConsoleStreaming, Orkeon:Cli:Memory, Orkeon:Cli:ScriptCommands, Orkeon:Cli:ScriptHost, Orkeon:Cli:Session, Orkeon:Cli:Tui, Orkeon:Scripting:AgentInstances, Orkeon:Scripting:AgentMemory, Orkeon:Scripting:Limits, Orkeon:Scripting:Toolchain 35
Hôte de service et A2A A2A, A2A:Security, A2A:Security:AzureAD, A2A:Security:Oidc, Orkeon:Host, Orkeon:Host:Discord 59
Observabilité Logging, Orkeon:Monitoring, Telemetry 8

80 sections, 530 clés. Lues par aucun binaire livré, seulement par un hôte écrit en C# (6) : TokenBudget, ToolRateLimiting, Orkeon:VectorSearch, Orkeon:Dlp, Orkeon:MultiModal, Orkeon:Monitoring.

Lire un tableau :

  • Lue par nomme les binaires livrés qui lisent la section : orkeon est le CLI — orkeon run sous toutes ses formes et tout verbe qui construit l'hôte des runners (--validate, --list-tools, mcp serve, la forge, rag, email) —, orkeon-host l'hôte de service, orkeon-repl la console interactive. Une section qu'aucun binaire livré ne lit le dit, et nomme l'enregistrement par lequel un hôte écrit en C# la lit : écrite dans le fichier de réglages d'orkeon run, elle n'y règle rien (Sous-systèmes opt-in donne le détail de chacune).
  • Clé s'écrit depuis sa section : QueueLimit sous RateLimiting est le réglage RateLimiting:QueueLimit — "RateLimiting": { "QueueLimit": 5 } dans le fichier, ORKEON_RateLimiting__QueueLimit dans l'environnement. <nom> tient la place d'un nom que vous choisissez (un profil, un serveur MCP, un compte e-mail, un rôle) et <i> celle d'un indice dans une liste.
  • Type vaut chaîne, entier, nombre, booléen, durée (hh:mm:ss, j.hh:mm:ss à partir d'un jour), URI, date et heure, énumération (ses noms sont sous Valeurs), liste de …, ou libre pour une valeur que son lecteur prend telle qu'elle est écrite. secret marque une clé dont la valeur est un secret : aucun tableau n'en montre une, et les clés qui nomment une variable à sa place (ApiKeyEnvVar, PasswordEnvVar, …) la tiennent hors du fichier.
  • Défaut est la valeur de la clé quand rien ne la règle ; — dit qu'elle n'en a pas, et le sens dit alors ce que fait une clé absente. Un défaut qui n'est pas une constante est dit en mots.
  • Sens est la phrase que le code porte sur la propriété où la clé est lue, traduite.

Les tableaux sont produits depuis le code — le catalogue de réglages avec lequel un hôte refuse une clé inconnue (plus haut) — et un test les y tient. Le même inventaire est dans l'outil, hors ligne : orkeon settings liste les catégories, orkeon settings RateLimiting les clés d'une section, orkeon settings rate tout ce à quoi un mot correspond, et orkeon settings --json donne le catalogue entier à un programme (CLI).

Les options d'un fichier de crew — maxRpm, llm: { profile: … }, memoryProvider:, rag:, mounts: — ne sont pas des réglages d'hôte : elles sont décrites dans le schéma YAML. Cette page en nomme une là où elle borne ou sélectionne un réglage d'hôte.

Les variables d'environnement ont leur propre partie, après les catégories : celles qui portent un réglage, celles qu'un binaire lit par leur nom — ORKEON_DEBUG, TUI_DRIVER — et celles qu'un réglage nomme (Variables d'environnement).

Modèles

Le modèle qu'appelle un hôte, la façon dont ses échanges sont journalisés, et ce que coûtent ses tokens. Les plafonds sur les appels eux-mêmes sont sous Débit et budgets.

Llm

La section Llm est lue par RunnerHost.RegisterLlmProvider et transformée en ILlmProvider via ILlmProviderFactory ; le REPL la lit avec le même lecteur (LlmSettings.ReadDefault). Le provider est inféré automatiquement, dans l'ordre : l'URL de base seule quand il y en a une — la même lecture pour le run et la CLI (un hôte de vendeur comme deepseek.com → DeepSeek ou api.x.ai → Grok ; /engines/ ou le port 12434 → Docker Model Runner ; le port 11434 → Ollama à sa racine ; toute autre adresse → un serveur compatible OpenAI, signalé comme muet s'il n'a pas de chemin ; une adresse qu'aucun run ne sert — pas une URL http(s) absolue, ou un hôte de vendeur sous /anthropic — refuse le démarrage) — puis, sans URL de base, motifs du nom de modèle, puis forme de la clé API ; défaut openai. Une section sans Model tourne sur le modèle par défaut de ce fournisseur (la colonne Défaut (code) du comparatif des fournisseurs), jamais sur celui d'OpenAI posé sur un autre vendeur. Sans section Llm, le runtime dégrade vers le provider écho et avertit une fois. Voir Providers LLM ; des gabarits vivent dans examples/appsettings/*.json.example.

Cette section est la base de chaque appel à son fournisseur : un composant qui passe sa propre configuration — le planificateur, la mémoire cognitive, les résumés de fenêtre de contexte et de RaggableTree, les boucles d'agent hors du client de chat, un client de chat enregistré sans configuration — complète celle de la section au lieu de la remplacer. Ce qu'il laisse vide est celui de la section (la clé, BaseUrl, TimeoutSeconds, Thinking, MaxTokens…) ; ce qu'il fixe l'emporte (la température 0,3 du planificateur, le plafond de sortie d'une analyse). Le fournisseur d'un profil fait de même avec ses propres clés.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
ApiKey chaîne, secret — La clé d'API, en clair. Préférez ApiKeyEnvVar : une clé écrite ici est dans le fichier de réglages.
ApiKeyEnvVar chaîne — Le nom de la variable d'environnement qui contient la clé d'API, lue quand ApiKey n'en résout aucune : l'environnement du processus, puis la portée utilisateur de Windows.
AvailableModels liste de chaînes [] Les modèles qu'un /model scripté peut proposer : une liste, ou une seule valeur séparée par des virgules.
BaseUrl chaîne — L'adresse du point d'accès du fournisseur, http:// ou https://. Omise, l'adresse du fournisseur que désigne le nom du modèle ou la clé.
Cache:SystemPrompt booléen — Marque le prompt système comme cachable pour chaque agent qui ne fixe aucun cache, sur un fournisseur dont le cache de prompt est explicite (Anthropic). Omis, il ne l'est pas.
Cache:Tools booléen — Marque les définitions d'outils comme cachables pour chaque agent qui ne fixe aucun cache, sur un fournisseur dont le cache de prompt est explicite (Anthropic). Omis, elles ne le sont pas.
Cache:Ttl chaîne — La durée de vie du cache, 5m ou 1h ; elle demande SystemPrompt ou Tools, et toute autre valeur refuse le chargement. Omise, celle du fournisseur (5 minutes chez Anthropic).
CallMode chaîne "Auto" Comment un appel atteint le modèle : Auto, Buffer ou Stream, casse ignorée. Omis, Auto : l'appel est diffusé en flux, et retombe sur un appel tamponné quand le fournisseur refuse le flux.
Grammar booléen false Si le point d'accès honore une grammaire GBNF — un serveur compatible llama.cpp, comme Docker Model Runner. Ailleurs une grammaire est abandonnée avec un avertissement.
MaxRateLimitWait durée "00:05:00" La plus longue fenêtre de limite de débit qu'un appel attend avant d'échouer : un fournisseur qui en annonce une plus longue fait échouer l'appel aussitôt avec une erreur de limite de débit. 00:00:00 n'attend rien.
MaxRetries entier 10 Combien de fois un appel qui échoue sur une erreur passagère est retenté ; 0 ne retente jamais.
MaxTokens entier — Le plus grand nombre de tokens qu'une réponse peut contenir : un épinglage. Omise, une requête porte le maximum documenté de son modèle, et 4096 pour un modèle que le catalogue ne connaît pas.
Model chaîne — Le nom du modèle. Omis, le fournisseur utilise son propre modèle par défaut.
ModelCapabilities:<nom>:AudioInput booléen — Si le modèle accepte des parties audio en entrée. Omis, la valeur intégrée du modèle (faux si la table ne le connaît pas).
ModelCapabilities:<nom>:AudioOutput booléen — Si le modèle répond en audio. Simple enregistrement : rien n'envoie ni ne lit l'audio en sortie. Omis, la valeur intégrée du modèle (faux si la table ne le connaît pas).
ModelCapabilities:<nom>:ReasoningEfforts liste de chaînes [] Les efforts de raisonnement que le modèle accepte : une liste, ou une seule valeur séparée par des virgules ; écrit vide, aucun. Omis, la liste intégrée du modèle (aucune restriction pour un modèle que la table ne connaît pas) et les niveaux du fournisseur font foi.
ModelCapabilities:<nom>:Thinking chaîne — Le support de réflexion du modèle : None, EffortOnly (raisonne toujours, ne peut pas être désactivé), Toggle ou Budget. La valeur effective est la plus basse de celle-ci et de celle du fournisseur. Omis, la valeur intégrée du modèle (celle du fournisseur pour un modèle que la table ne connaît pas).
ModelCapabilities:<nom>:Vision booléen — Si le modèle accepte des parties image en entrée. Omis, la valeur intégrée du modèle (faux si la table ne le connaît pas).
Profiles:<nom>:ApiKey chaîne, secret — La clé d'API, en clair. Préférez ApiKeyEnvVar : une clé écrite ici est dans le fichier de réglages.
Profiles:<nom>:ApiKeyEnvVar chaîne — Le nom de la variable d'environnement qui contient la clé d'API, lue quand ApiKey n'en résout aucune : l'environnement du processus, puis la portée utilisateur de Windows.
Profiles:<nom>:BaseUrl chaîne — L'adresse du point d'accès du fournisseur, http:// ou https://. Omise, l'adresse du fournisseur que désigne le nom du modèle ou la clé.
Profiles:<nom>:Cache:SystemPrompt booléen — Marque le prompt système comme cachable pour chaque agent qui ne fixe aucun cache, sur un fournisseur dont le cache de prompt est explicite (Anthropic). Omis, il ne l'est pas.
Profiles:<nom>:Cache:Tools booléen — Marque les définitions d'outils comme cachables pour chaque agent qui ne fixe aucun cache, sur un fournisseur dont le cache de prompt est explicite (Anthropic). Omis, elles ne le sont pas.
Profiles:<nom>:Cache:Ttl chaîne — La durée de vie du cache, 5m ou 1h ; elle demande SystemPrompt ou Tools, et toute autre valeur refuse le chargement. Omise, celle du fournisseur (5 minutes chez Anthropic).
Profiles:<nom>:CallMode chaîne "Auto" Comment un appel atteint le modèle : Auto, Buffer ou Stream, casse ignorée. Omis, Auto : l'appel est diffusé en flux, et retombe sur un appel tamponné quand le fournisseur refuse le flux.
Profiles:<nom>:Fallback liste de chaînes [] Les profils vers lesquels un appel passe, dans l'ordre, quand celui-ci échoue d'une façon qu'un nouvel essai ne guérit pas : une erreur de transport, un 5xx, un 429 une fois MaxRetries épuisé, un délai dépassé. Une liste de noms de profils, ou une seule valeur séparée par des virgules ; default désigne le profil de l'hôte. Omise, un échec reste celui de l'appel.
Profiles:<nom>:FallbackBudgetSeconds entier — Le temps maximal, en secondes et compté depuis le premier appel, que la chaîne peut passer avant de cesser d'essayer le profil suivant. Il est vérifié entre deux profils et ne coupe jamais un appel en cours. Omis, la chaîne n'est bornée que par le TimeoutSeconds et le MaxRetries de chaque profil.
Profiles:<nom>:Grammar booléen false Si le point d'accès honore une grammaire GBNF — un serveur compatible llama.cpp, comme Docker Model Runner. Ailleurs une grammaire est abandonnée avec un avertissement.
Profiles:<nom>:MaxRateLimitWait durée "00:05:00" La plus longue fenêtre de limite de débit qu'un appel attend avant d'échouer : un fournisseur qui en annonce une plus longue fait échouer l'appel aussitôt avec une erreur de limite de débit. 00:00:00 n'attend rien.
Profiles:<nom>:MaxRetries entier 10 Combien de fois un appel qui échoue sur une erreur passagère est retenté ; 0 ne retente jamais.
Profiles:<nom>:MaxTokens entier — Le plus grand nombre de tokens qu'une réponse peut contenir : un épinglage. Omise, une requête porte le maximum documenté de son modèle, et 4096 pour un modèle que le catalogue ne connaît pas.
Profiles:<nom>:Model chaîne — Le nom du modèle. Omis, le fournisseur utilise son propre modèle par défaut.
Profiles:<nom>:Provider chaîne — mock, la seule valeur : le fournisseur hors ligne qui répond depuis le fichier JSONL que nomme Responses. Omise, le fournisseur découle de BaseUrl, du nom du modèle et de la clé.
Profiles:<nom>:Responses chaîne — Avec Provider: mock, le chemin virtuel du fichier JSONL — un objet {match, regex?, content, toolCalls?} par ligne — dont le fournisseur mock tire ses réponses.
Profiles:<nom>:StreamIdleSeconds entier — La plus longue absence de réponse tolérée entre deux fragments d'une réponse en flux, en secondes. Omise, rien ne la borne : TimeoutSeconds seule borne l'appel entier, en flux ou non. Un modèle qui réfléchit avant d'écrire peut rester silencieux un moment : ne la fixez qu'au-dessus de ce silence, ou coupez sa réflexion.
Profiles:<nom>:Temperature nombre — La température d'échantillonnage. Omise, aucune n'est envoyée et le modèle applique la sienne.
Profiles:<nom>:Thinking:Effort chaîne — L'intensité de sa réflexion, dans les mots du fournisseur (low, medium, high…). Omise, celle du fournisseur.
Profiles:<nom>:Thinking:Enabled booléen — Si le modèle réfléchit avant de répondre. Omise, le comportement propre du fournisseur.
Profiles:<nom>:TimeoutSeconds entier 30 La durée maximale d'un appel, en secondes. Trop courte à son défaut pour un modèle qui réfléchit avant de répondre : écrivez 600 pour un tel modèle, ou coupez sa réflexion.
Provider chaîne — mock, la seule valeur : le fournisseur hors ligne qui répond depuis le fichier JSONL que nomme Responses. Omise, le fournisseur découle de BaseUrl, du nom du modèle et de la clé.
Replay:Cassette chaîne — Le chemin virtuel de la cassette, un fichier JSONL ; record et replay en ont besoin.
Replay:Mode chaîne — record écrit dans la cassette chaque appel du run et sa réponse ; replay répond à chaque appel depuis elle, et un appel qu'elle ne contient pas échoue ; off ne fait ni l'un ni l'autre. Omis, off.
Responses chaîne — Avec Provider: mock, le chemin virtuel du fichier JSONL — un objet {match, regex?, content, toolCalls?} par ligne — dont le fournisseur mock tire ses réponses.
StreamIdleSeconds entier — La plus longue absence de réponse tolérée entre deux fragments d'une réponse en flux, en secondes. Omise, rien ne la borne : TimeoutSeconds seule borne l'appel entier, en flux ou non. Un modèle qui réfléchit avant d'écrire peut rester silencieux un moment : ne la fixez qu'au-dessus de ce silence, ou coupez sa réflexion.
Temperature nombre — La température d'échantillonnage. Omise, aucune n'est envoyée et le modèle applique la sienne.
Thinking:Effort chaîne — L'intensité de sa réflexion, dans les mots du fournisseur (low, medium, high…). Omise, celle du fournisseur.
Thinking:Enabled booléen — Si le modèle réfléchit avant de répondre. Omise, le comportement propre du fournisseur.
TimeoutSeconds entier 30 La durée maximale d'un appel, en secondes. Trop courte à son défaut pour un modèle qui réfléchit avant de répondre : écrivez 600 pour un tel modèle, ou coupez sa réflexion.
  • La clé. ApiKeyEnvVar nomme la variable d'environnement qui contient la clé — plus bas ; la variable où vit conventionnellement la clé de chaque fournisseur, et les noms qu'on confond avec elle, sont dans le comparatif des fournisseurs. ApiKey est la clé en clair — déconseillé.
  • Temperature. Omise, rien n'est envoyé et le modèle applique la sienne — souvent 1 ; écrivez 0.7 pour une température modérée.
  • Thinking:Enabled, Thinking:Effort concernent les providers à raisonnement.
  • Profiles:<nom> porte les profils nommés qu'une crew choisit par agent ou par tâche, chacun avec les mêmes clés que la section elle-même (plus bas) ; un client peut en écrire un par réglage de modèle, avec le nom de la variable qui contient sa clé, jamais la clé.
  • AvailableModels est la liste de modèles qu'une commande REPL scriptée /model peut proposer (tableau de chaînes, ou une chaîne séparée par des virgules), lue par AddOrkeonSessionTools(configuration).

Le délai, et les modèles qui réfléchissent

TimeoutSeconds vaut 30 s par défaut, trop court pour un modèle qui réfléchit avant de répondre (Kimi K2.6, DeepSeek V4 et GLM le font par défaut) : mettez 600 s, ou coupez la réflexion avec Thinking:Enabled = false. Un appel qui atteint le délai est réessayé une fois, puis fait échouer sa tâche avec un message qui nomme le réglage — il n'est jamais rapporté comme une réponse vide.

Le délai borne l'appel entier, en flux ou non, attente du premier jeton comprise. StreamIdleSeconds ajoute une seconde borne, omise par défaut : la plus longue absence de réponse entre deux fragments du flux. Un modèle qui réfléchit avant d'écrire peut rester silencieux un moment : fixez-la au-dessus de ce silence, ou coupez la réflexion. L'une ou l'autre borne atteinte est un appel échoué dont le message nomme le réglage — jamais une réponse vide.

MaxTokens est un épinglage

MaxTokens est un épinglage : absent, la requête porte le maximum de sortie documenté du modèle, lu dans le catalogue LlmModelOutputLimits (128K sur gpt-5.6-sol et la génération Claude 5, 384K sur deepseek-flash, 131 072 sur les familles GLM-5 et Qwen 3.7/3.8, 65 536 sur Gemini 3.x Flash — voir la table des plafonds), aucun plafond quand le fournisseur n'en documente pas (Mistral, un Ollama local), et 4096 seulement pour un modèle inconnu du catalogue — un plafond qu'un modèle de raisonnement peut dépenser à réfléchir avant d'écrire un mot, pour revenir vide (une réponse finale vide fait échouer la tâche au lieu de passer pour une tâche accomplie). Épinglez-le quand le modèle n'est pas au catalogue ou pour un plafond plus serré ; un profil de modèle d'un client peut l'épingler en ORKEON_Llm__MaxTokens. Un plafond du catalogue que le point d'accès refuse est rejoué une fois sans le champ, avec un avertissement qui nomme le modèle.

Provider: mock répond depuis un fichier

Un profil — ou la section Llm elle-même — écrit "Provider": "mock", "Responses": "/llm-mock/answers.jsonl" ne construit aucun fournisseur d'éditeur : il répond depuis un fichier JSONL lu par le système de fichiers virtuel, un objet {"match", "regex"?, "content", "toolCalls"?} par ligne (la première ligne dont match convient au prompt l'emporte ; voir orkeon run --llm-mock). Il ne fait aucun appel réseau : une crew YAML ou un script .ork.ts tourne hors ligne avec la même sortie à chaque fois. mock est la seule valeur que prend Provider ; sinon le fournisseur découle de BaseUrl, du nom du modèle et de la clé. Responses y est obligatoire. orkeon run --llm-mock <fichier> écrit les deux clés pour chaque profil de l'exécution. Le mock n'est pas l'un des seize fournisseurs : c'est un double de test.

Replay enregistre ou rejoue les appels

Llm:Replay:Mode à record écrit chaque appel d'un fournisseur, avec sa réponse, dans le fichier JSONL que Llm:Replay:Cassette nomme ; replay répond à chaque appel depuis ce fichier et n'appelle aucun modèle ; off (le défaut) ne fait ni l'un ni l'autre. Le décorateur se pose dans la fabrique de fournisseurs, sous la couche de mode d'appel : la cassette contient donc ce qui est vraiment parti sur le fil. orkeon run --llm-record et --llm-replay posent les deux clés et montent le dossier ; voir Enregistrer et rejouer les appels LLM. Un mode sans cassette, ou un mode qui n'est aucun des trois, refuse le démarrage en nommant la clé.

Grammar est pour un serveur compatible llama.cpp

Grammar (défaut false) : ne le passez à true que lorsque BaseUrl désigne un serveur compatible llama.cpp (Docker Model Runner, llama-server) — le seul genre de point d'accès qui honore le champ GBNF grammar que produit un livrable structured_output ; ailleurs la grammaire est abandonnée avec un avertissement qui nomme la clé (comparatif des fournisseurs).

La clé d'API (ApiKey, ApiKeyEnvVar)

Une section n'a jamais à contenir sa clé. ApiKeyEnvVar nomme la variable d'environnement qui la contient — le nom, jamais la clé —, dans la section Llm comme dans chaque profil : "ApiKeyEnvVar": "DEEPSEEK_API_KEY". Un run prend, dans cet ordre :

  1. Une clé que la configuration résout : ApiKey dans le fichier, ORKEON_Llm__ApiKey (ORKEON_Llm__Profiles__<id>__ApiKey pour un profil), ou ce qu'un lancement de client pose sur son processus enfant. Une installation existante garde la clé qu'elle avait, et l'environnement l'emporte toujours sur le fichier.
  2. Sinon la variable que nomme ApiKeyEnvVar, lue dans l'environnement du processus, puis — sous Windows — dans la portée Utilisateur persistante (HKCU\Environment), où un client peut mémoriser une clé : un terminal ouvert avant la mémorisation, ou une équipe planifiée, la trouve quand même. La valeur est lue, jamais recopiée dans le processus : ce que le run lance — un outil shell, un serveur MCP stdio, le bac à sable de code — n'hérite d'aucune clé qu'il n'aurait pas eue. Une portée Utilisateur illisible (registre refusé, compte de service virtuel) vaut une variable absente. Linux et macOS n'ont pas de portée Utilisateur : le processus seul.
  3. Sinon pas de clé, et chaque appel répond qu'une clé d'API est requise, comme sans la référence.

Le nom est lu tel qu'il est écrit : Windows compare les noms de variable sans la casse, Linux avec. Une référence qui ne peut pas être un nom de variable — un =, une espace, un saut de ligne — refuse le démarrage de l'hôte, en nommant le chemin de configuration et jamais la valeur, qui peut être une clé collée dans le mauvais champ. Une ApiKey écrite comme un gabarit ${NOM} — jamais développé, si bien que le texte partirait comme clé — refuse aussi le démarrage, avec la correction : "ApiKeyEnvVar": "NOM" (une référence n'est jamais développée). Au démarrage, l'hôte runner dit d'où vient chaque clé, jamais la clé ni le nom de la variable — LLM resolved: … apiKey=from the variable named by Llm:ApiKeyEnvVar (user environment), puis une ligne LLM profile <id>: apiKey=… par profil offert aux crews (from configuration (…:ApiKey), from the variable named by … (process environment), none) — et avertit une fois par section dont la référence nomme une variable posée nulle part, par son chemin, sur son journal et sur stderr ; orkeon doctor, la sonde d'orkeon init et le REPL disent la même chose. Un profil que cache la liste blanche d'orkeon-host est nommé sur une ligne à part et jamais signalé : aucune crew ne peut le nommer (hôte de service). Une valeur vide se lit comme absente, pour chaque clé de la section (Thinking:Effort comprise) : un lancement de client peut vider les champs du défaut que le réglage de son équipe ne fixe pas, et une section dont toutes les valeurs sont vides ne configure aucun défaut — le provider écho, avec son avertissement. orkeon init --api-key-env <nom> écrit Llm:ApiKeyEnvVar. La référence peut nommer n'importe quelle variable : un fichier de réglages est une configuration de confiance (Sécurité).

Une référence de variable n'est jamais développée

Orkeon ne développe jamais (never expands) une variable dans un réglage : le texte part tel qu'il est écrit. Deux graphies sont reconnues comme une référence et refusées — ${NOM} (aussi ${env:NOM}, ${NOM:-défaut} et tout ${…}, seul ou dans une valeur plus longue comme sk-${X}) et %NOM% (la valeur entière). $NOM, sans accolades, n'est pas une référence : il passe tel qu'il est écrit. Le refus a lieu au démarrage, avant la connexion d'un serveur MCP, en nommant le chemin du réglage et jamais la valeur, avec sa correction : la commande run, le REPL et doctor s'arrêtent (run sort en 1), orkeon-host sort en 78. Une valeur qu'une couche supérieure couvre n'est pas celle qui est lue : elle n'est pas jugée. Les réglages jugés, tirés de Orkeon.Constants.Configuration (SettingPlaceholders), clés comparées sans la casse :

Réglages Correction énoncée
Llm:ApiKey, Llm:Profiles:<nom>:ApiKey, Orkeon:Embeddings:ApiKey écrire "ApiKeyEnvVar": "<NOM>" à la place
Llm:ApiKeyEnvVar, Llm:Profiles:<nom>:ApiKeyEnvVar, Orkeon:Rag:WebFallback:ApiKeyEnvVar, Orkeon:Embeddings:ApiKeyEnvVar, Orkeon:Host:Discord:TokenEnvironmentVariable, A2A:Security:ApiKeySecretNames:<i>, Orkeon:Encryption:SecretName, Orkeon:Tools:GitHub:TokenVariable écrire le nom seul, sans ${ ni }
MCP:Servers:<id>:Command, :Args:<i>, :Url ; Orkeon:Redis:ConnectionString, Orkeon:Sqlite:ConnectionString ; RaggableTree:Embedding:ApiKey, Orkeon:Pinecone:ApiKey, Orkeon:LanceDb:ApiKey ; Llm:BaseUrl, Llm:Profiles:<nom>:BaseUrl, RaggableTree:Embedding:BaseUrl, Orkeon:ChromaDb:BaseUrl, Orkeon:Pinecone:Host, Orkeon:LanceDb:Endpoint, Orkeon:Embeddings:Endpoint, Orkeon:Rag:WebFallback:Endpoint, Telemetry:OtlpEndpoint ; Security:Vault:AzureKeyVaultUri, A2A:Security:AzureAD:Authority, A2A:Security:Oidc:Authority ; Orkeon:Tools:GitHub:Token écrire la valeur, ou la garder hors du fichier par la couche d'environnement ORKEON_<chemin avec __>
MCP:Servers:<id>:Env:<nom> retirer l'entrée : le serveur hérite de l'environnement où tourne Orkeon, y poser la variable
Secrets:<nom> retirer l'entrée et poser ORKEON_<nom>, que la chaîne des secrets lit en premier
BRAVE_API_KEY retirer l'entrée, Orkeon lit la variable

Un compte e-mail dont Incoming:Host, Outgoing:Host, Auth:PasswordEnvVar ou Auth:ClientSecretEnvVar contient une référence, ou un compte drive dont Auth:ClientSecretEnvVar en contient une, ne refuse pas le démarrage : le compte est mis de côté, avec son problème (guide e-mail, guide drive).

Profils nommés (Llm:Profiles)

Un hôte peut offrir plusieurs fournisseurs. Chaque enfant de Llm:Profiles est un profil : un nom, et un fournisseur décrit avec exactement les clés de la section Llm (BaseUrl, ApiKeyEnvVar, ApiKey, Model, Temperature, MaxTokens, TimeoutSeconds, MaxRetries, Thinking, Cache, Grammar, CallMode, MaxRateLimitWait, StreamIdleSeconds). La section Llm elle-même reste le profil par défaut — celui de tout agent qui n'en nomme pas d'autre. Une crew choisit un profil par son nom, jamais par une clé ou une URL : llm: { profile: claude } sur la crew, un agent ou le llm_override d'une tâche en YAML, llm.profile("claude") sur un agent et taskBuilder().withProfile("claude") sur une tâche en .ork.ts (YAML et builders).

{
  "Llm": {
    "BaseUrl": "https://api.deepseek.com/v1", "Model": "deepseek-v4-flash", "ApiKeyEnvVar": "DEEPSEEK_API_KEY",
    "Profiles": {
      "claude": { "BaseUrl": "https://api.anthropic.com/v1", "Model": "claude-sonnet-5", "ApiKeyEnvVar": "ANTHROPIC_API_KEY" },
      "local":  { "BaseUrl": "http://localhost:11434", "Model": "qwen3" }
    }
  }
}

Les clés restent hors des fichiers de la même façon : le profil nomme sa variable (ApiKeyEnvVar), et ORKEON_Llm__Profiles__claude__ApiKey l'emporte sur elle quand elle est posée. Le fournisseur de chaque profil est construit une fois, au premier usage, compté comme celui par défaut — les relevés cost.updated d'un run nomment le fournisseur de chaque appel, et un client peut ventiler les jetons par fournisseur. Les profils sont validés au démarrage de l'hôte : default est un nom réservé (il désigne la section Llm, et une crew peut le nommer pour ramener un agent au défaut), et une BaseUrl invalide (la même lecture la refuse) ou une valeur qui n'est pas un nombre fait échouer le démarrage en nommant la clé à corriger. Une crew qui nomme un profil que l'hôte ne définit pas échoue au chargement, et le message liste les profils offerts. Un modèle non précisé est celui du profil, sur tous les chemins : un bloc llm: YAML ou .ork.ts sans model, le .Thinking() ou le .MaxOutputTokens(n) d'un agent C#, llm.default_ sur un hôte qui ne configure aucun modèle, le planificateur, les boucles d'agent hors client de chat et les appels d'analyse de la mémoire cognitive laissent tous le modèle au fournisseur qu'ils atteignent, qui envoie le modèle que son profil configure, sinon son propre défaut — jamais un modèle vide, jamais celui d'OpenAI sur un autre vendeur.

Qui tourne sur quel profil :

  • Les tours d'un agent — sur son profil llm:, ou le llm_override de sa tâche pour cette tâche (taskBuilder().withProfile(nom) en .ork.ts). Un agent construit en C# peut porter à la place son propre fournisseur (AgentBuilder.WithLlm(fournisseur), ou un agent Microsoft Agent Framework par WithAgentFrameworkAgent — Agent.Llm) : ses tours, sa correction de sortie et son bulletin y tournent, sur un client que l'hôte construit une fois par fournisseur et compte comme le travail de l'agent ; le profil du llm_override d'une tâche déplace toujours cette tâche, et l'agent ne peut pas nommer en plus un profil (le build refuse les deux).
  • Le manager d'une crew hiérarchique (et celui qui distribue les tâches d'une crew autonome) — sur le LLM que la crew lui donne : en C#, le fournisseur que pose CrewBuilder.WithManagerLlm, compté comme celui de l'hôte ; sinon le fournisseur que porte son agent manager (WithLlm, WithAgentFrameworkAgent), compté de même ; sinon le bloc llm: de son agent manager, profil et modèle ; sinon le profil par défaut.
  • Le sous-système RAG — génération citée, transformateurs de requête, reranker listwise, évaluateur et vérificateur d'ancrage du graphe correctif, classifieur llm et juge d'évaluation — sur le profil que nomme Orkeon:Rag:LlmProfile (absent : le défaut). Un nom que l'hôte n'offre pas fait refuser le démarrage de l'hôte, en listant ceux qu'il offre ; le fournisseur du profil est construit au premier appel RAG qui en a besoin, jamais au démarrage.
  • Le planificateur, le Guardian, les juges d'Evaluation et les analyses de la mémoire cognitive restent sur le profil par défaut : ce sont des services de l'hôte, pas des rôles de crew (CrewBuilder.WithPlanningLlm garde la main en C#, avec .Planning(), ses appels comptés comme ceux de l'hôte).

Une section qui ne contient que Profiles ne configure aucun fournisseur par défaut — le défaut est alors le provider écho, avec l'avertissement habituel. orkeon-host peut restreindre les profils que ses crews peuvent nommer (Orkeon:Host:LlmProfiles, plus bas) ; la restriction vaut aussi pour le profil RAG et pour celui d'un agent manager.

Un run sur un autre profil. orkeon run --llm-profile <id> élit un profil comme défaut du run (CLI) : pour ce run, la section Llm est ce profil, en entier — ce qu'il laisse vide reste vide, sa clé est la sienne —, et chaque rôle ci-dessus qui tourne sur le défaut tourne dessus. Un identifiant que la configuration ne définit pas refuse le run, en listant ceux qu'elle définit. C'est ce que passent les lanceurs d'une équipe planifiée.

LlmLogging

Règle la capture des échanges LLM. Lue uniquement quand le run passe --llm-log ou --llm-log-path, qui disent où va le journal (RunnerHost → AddLlmExchangeLogging(logDirectory, options)) : aucune clé de cette section n'active le journal ni ne choisit son dossier. Un interrupteur qui ne vaut ni true ni false, une longueur qui n'est pas un nombre entier, ou une autre clé refuse le démarrage d'un run qui passe --llm-log. Recette : suivre le run et garder les échanges LLM.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
FullEmbeddingLog booléen true Si un vecteur d'embedding est journalisé en entier. false remplace chacun par ses deux premières et ses deux dernières valeurs : l'échange garde sa forme et perd ses mégaoctets.
LogStreamingExchanges booléen true Si un échange en flux est journalisé : sa requête, et la réponse une fois le flux terminé.
MaxBodyLengthChars entier 0 Le plus grand nombre de caractères journalisés d'un corps de requête ou de réponse ; 0 le journalise en entier.

Orkeon:CostTracking

Suivi des coûts LLM : un budget par défaut par crew (DefaultCrewBudget) et le prix d'un modèle, par nom ou par motif (CustomPricings). Enregistré par AddOrkeonInfrastructure() ; la section gouverne le comportement. Le budget couvre chaque appel LLM fait dans l'exécution d'un crew (YAML, .ork.ts, l'hôte de service) et se cumule par identifiant de crew : une crew YAML ou C# prend un nouvel identifiant à chaque chargement, le budget vaut donc en pratique par exécution ; les appels qu'un script fait lui-même par ctx.llm se cumulent sous le nom de la crew pendant toute la vie du processus, à part de ses tâches orchestrées. Un appel hors crew n'est soumis à aucun budget. L'appel qui franchit un plafond va à son terme ; le suivant est refusé avant tout envoi et la tâche se termine BudgetExhausted, sans nouvelle tentative. Les plafonds sur le nombre d'appels sont RateLimiting. La liste de prix intégrée couvre le modèle par défaut de chaque fournisseur payant, sauf Hugging Face, dont le fournisseur routé fixe le prix ; une passerelle (Together, Mammouth) est tarifée par ses propres lignes, posées avec CustomPricings:<i>:Provider, et les modèles ollama et Docker Model Runner ne coûtent rien. OpenRouter est compté d'après le usage.cost que renvoie le fournisseur, non d'après cette liste ; un déploiement Azure OpenAI n'est tarifé que si son nom correspond à une ligne (ajoutez-en une sous CustomPricings). Une ligne CustomPricings l'emporte toujours sur une ligne intégrée : une ligne sans Provider s'applique à tous les fournisseurs, une ligne qui nomme un fournisseur à ce fournisseur seul. Un modèle sans prix est compté à zéro et journalise un seul avertissement par modèle et par processus hôte (un démon orkeon-host avertit une fois pour toute sa durée de vie, non une fois par run), qui nomme Orkeon:CostTracking:CustomPricings : ajoutez-y une ligne pour le tarifer. Sous un budget MaxCostUsd, celui du crew ou celui d'un agent, un second avertissement, une fois par crew et par modèle, dit que le budget ne peut pas compter les appels de ce modèle (il faut un plafond au-dessus de 0 et un appel qui porte des tokens). Avec Enabled à false, chaque appel est toujours enregistré et tarifé (l'historique et le rapport le comptent, un modèle sans prix avertit toujours une fois), mais aucun n'est refusé, aucune alerte de budget n'est levée et l'avertissement « le budget ne peut pas compter » n'est pas journalisé.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
CustomPricings:<i>:CacheReadPricePerMillion nombre — Coût par million de tokens lus dans le cache de prompt ; null si le modèle n'en déclare pas.
CustomPricings:<i>:CacheWritePricePerMillion nombre — Coût par million de tokens écrits dans le cache de prompt ; null si le modèle n'en déclare pas.
CustomPricings:<i>:CompletionPricePerMillion nombre 0 Coût par million de tokens de complétion (sortie), dans la devise indiquée.
CustomPricings:<i>:Currency chaîne "USD" Devise des prix (défaut : USD).
CustomPricings:<i>:EffectiveDate date et heure l'instant où la valeur est lue Date à laquelle ce prix est entré en vigueur.
CustomPricings:<i>:EmbeddingPricePerMillion nombre — Coût par million de tokens d'embedding (null si ce n'est pas un modèle d'embedding).
CustomPricings:<i>:ModelPattern chaîne "" Nom ou motif du modèle (p. ex. "gpt-4o", "claude-3-opus").
CustomPricings:<i>:PromptPricePerMillion nombre 0 Coût par million de tokens de prompt (entrée), dans la devise indiquée.
CustomPricings:<i>:Provider chaîne — Fournisseur auquel cette ligne est rattachée ; null signifie n'importe quel fournisseur.
DefaultCrewBudget:AlertThresholdPercent nombre 80 Pourcentage du budget à partir duquel une alerte d'avertissement est émise (défaut : 80 %).
DefaultCrewBudget:MaxCostUsd nombre — Coût total maximal en USD (null = illimité) : une fois que les appels enregistrés l'atteignent, l'appel LLM suivant est refusé (BudgetExhaustedException, dimension Cost).
DefaultCrewBudget:MaxTokens entier — Nombre total maximal de tokens (null = illimité) : une fois que les appels enregistrés l'atteignent, l'appel LLM suivant est refusé (BudgetExhaustedException, dimension Tokens).
Enabled booléen true Si les budgets sont appliqués (défaut : true) ; false enregistre les appels sans en refuser aucun.

Orkeon:TokenCounter

Estimation des tokens. Enregistré par AddOrkeonInfrastructure() ; la section gouverne le comportement.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
CharsPerToken nombre 3.5 Nombre moyen de caractères par token (défaut : 3,5).
SpecialTokenOverhead entier 2 Nombre de tokens spéciaux de surcoût (p. ex. BOS/EOS) par requête (défaut : 2).
TokensPerMessage entier 4 Nombre de tokens de surcoût par message au format chat (défaut : 4).
TokensPerReply entier 3 Nombre de tokens de surcoût pour l'amorce de la réponse (défaut : 3).

Evaluation

Avec EnableLlmJudge, l'IEvaluationSuite par défaut exécute aussi les juges LLM de cohérence, fluidité et ancrage sur l'IChatClient enregistré. Liée par AddOrkeonInfrastructure(configuration), ou AddOrkeonEvaluation(configuration) (idempotent : un second appel n'enregistre aucun évaluateur deux fois). Les hôtes runner (orkeon, orkeon-host) la lient avec le second ; orkeon eval run --llm-judge la fixe pour un run, --offline la force à faux.

Lue par : orkeon, orkeon-host.

Clé Type Défaut Sens
EnableLlmJudge booléen false Quand la clé est vraie, la suite d'évaluation par défaut exécute aussi les évaluateurs « LLM juge » (cohérence, fluidité, ancrage). Requiert un IChatClient enregistré dans le conteneur. Défaut : false. Liée depuis la section Evaluation.

Orkeon:TypeSafe

Le fournisseur de décision TypeSafe (modèle Jev, clé requise), lié par AddOrkeonDecisionProvider(configuration, provider), que les trois binaires livrés appellent quand il est le fournisseur actif (un seul est actif à la fois, voir Orkeon:Decision) : cette section est présente — même vide, TypeSafe: {} compte — ou TYPESAFE_API_KEY est définie, ou Orkeon:Decision:Provider vaut typesafe : la clé, l'endpoint, le modèle par défaut, le délai et les nouvelles tentatives de chaque appel (le juge LLM du gardien est Orkeon:Guardian:Llm). Voir Modèles de décision.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
ApiKey chaîne, secret — La clé d'API. Déconseillée dans un fichier de réglages : laissez-la vide et posez la variable que nomme ApiKeyEnvVar.
ApiKeyEnvVar chaîne "TYPESAFE_API_KEY" La variable d'environnement lue quand ApiKey est vide.
BaseUrl URI "https://api.typesafe.ai/v1" La racine de l'API ; /systemone s'y ajoute.
MaxRetries entier 3 Les nouvelles tentatives après un 429, un 529, un autre 5xx ou une erreur réseau.
Model chaîne "jev-latest" Le modèle sur lequel tourne une requête qui n'en nomme aucun.
TimeoutSeconds entier 30 Le délai HTTP d'une tentative, en secondes.

Orkeon:Liquid

Le modèle de décision Liquid, lié par AddOrkeonDecisionProvider(configuration, provider) quand il est le fournisseur de décision actif : cette section est présente (même vide), ou LIQUID_API_KEY est définie, ou Orkeon:Decision:Provider vaut liquid. Un seul fournisseur est actif à la fois (voir Orkeon:Decision). Voir Modèles de décision.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
ApiKey chaîne, secret — La clé d'API. Déconseillée dans un fichier de réglages : laissez-la vide et posez la variable que nomme ApiKeyEnvVar.
ApiKeyEnvVar chaîne "LIQUID_API_KEY" La variable d'environnement lue quand ApiKey est vide.
BaseUrl URI "https://api.liquid.ai/decisions/v1" La racine de l'API ; /systemone s'y ajoute.
MaxRetries entier 3 Les nouvelles tentatives après un 429, un 529, un autre 5xx ou une erreur réseau.
Model chaîne "d1.1" Le modèle sur lequel tourne une requête qui n'en nomme aucun.
TimeoutSeconds entier 30 Le délai HTTP d'une tentative, en secondes.

Orkeon:Kev

Le modèle de décision Kev, un serveur System One lancé en local, lié par AddOrkeonDecisionProvider(configuration, provider) seulement quand Orkeon:Decision:Provider vaut kev : une section Kev seule ne le choisit jamais et est signalée comme ignorée au démarrage. L'adresse exige un schéma http ou https (sinon refusée au démarrage, avec Orkeon:Kev:BaseUrl dans le message). La clé est facultative (KEV_API_KEY : envoyée si donnée, sinon l'appel est sans authentification), et une clé configurée est refusée au démarrage vers une adresse non locale en http clair (locale : localhost, 127.0.0.0/8, ::1) ; utiliser https pour un Kev distant. Voir Modèles de décision.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
ApiKey chaîne, secret — La clé d'API. Déconseillée dans un fichier de réglages : laissez-la vide et posez la variable que nomme ApiKeyEnvVar.
ApiKeyEnvVar chaîne "KEV_API_KEY" La variable d'environnement lue quand ApiKey est vide.
BaseUrl URI "http://127.0.0.1:8009/v1" La racine de l'API ; /systemone s'y ajoute.
MaxRetries entier 3 Les nouvelles tentatives après un 429, un 529, un autre 5xx ou une erreur réseau.
Model chaîne "kev-latest" Le modèle sur lequel tourne une requête qui n'en nomme aucun.
TimeoutSeconds entier 30 Le délai HTTP d'une tentative, en secondes.

Orkeon:Decision

Enabled, le circuit de décision des tâches de décision, est lié par AddOrkeonInfrastructure() ; les profils de décision (Profiles) par AddOrkeonDecisionProfiles(configuration), que les trois binaires livrés appellent : chaque profil enveloppe un profil LLM (Target) dans des étapes qui bloquent, routent ou escaladent un appel. Une crew en utilise un comme tout profil, llm: { profile: <nom> }.

Provider nomme le fournisseur de décision actif (typesafe, liquid ou kev, sans distinction de casse ; vide = non nommé ; un nom inconnu est refusé au démarrage, le message listant les noms valides). Non nommé, l'hôte le déduit : la section Orkeon:TypeSafe ou Orkeon:Liquid (même vide), sinon celui dont la variable de clé est posée ; une section l'emporte sur une clé seule (une section avec les deux clés définies choisit le fournisseur qui a la section), et les deux sections présentes, ou aucune section et les deux clés définies, sont refusées, le message citant les deux et ce réglage. Kev n'est jamais déduit : une section Kev sans Provider: "kev" est signalée comme ignorée dans le journal de démarrage (avec l'indication de la nommer quand aucun fournisseur ne l'est). Voir Modèles de décision.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
Enabled booléen true Si les tâches de décision interrogent le modèle de décision.
Profiles:<nom>:FailClosed booléen false Si une étape en échec bloque l'appel ; false le laisse passer avec un avertissement.
Profiles:<nom>:Stages:<i>:BlockThreshold nombre 0.5 La probabilité à partir de laquelle une étape guard bloque.
Profiles:<nom>:Stages:<i>:Criterion chaîne — Ce qu'est une bonne réponse, pour une étape verify ; vide, le critère par défaut s'applique.
Profiles:<nom>:Stages:<i>:EscalateTo chaîne — Le profil vers lequel une étape verify escalade.
Profiles:<nom>:Stages:<i>:Fallback chaîne — Le profil que prend une étape route sous MinConfidence ; vide, la cible reste.
Profiles:<nom>:Stages:<i>:Kind chaîne "" L'étape : route, guard ou verify.
Profiles:<nom>:Stages:<i>:MinConfidence nombre 0 La confiance sous laquelle une étape route prend Fallback.
Profiles:<nom>:Stages:<i>:MinProbability nombre 0.5 La probabilité sous laquelle une étape verify escalade.
Profiles:<nom>:Stages:<i>:Phase chaîne — Quand une étape guard juge : request, response ou both (le défaut).
Profiles:<nom>:Stages:<i>:Risks:<nom> chaîne — Les risques que détecte une étape guard, chacun avec ce qu'il est.
Profiles:<nom>:Stages:<i>:Routes:<nom> chaîne — Les profils qu'une étape route peut choisir, chacun avec ce à quoi il sert.
Profiles:<nom>:Stages:<i>:Steps chaîne — Les réponses que juge une étape verify : final (le défaut) laisse passer une réponse qui appelle des outils comme une étape de boucle d'agent, all la juge aussi.
Profiles:<nom>:Stages:<i>:WarnThreshold nombre 0.3 La probabilité à partir de laquelle une étape guard journalise un avertissement.
Profiles:<nom>:Target chaîne "" Le profil où va un appel qu'aucune étape ne route ; default est la section Llm.
Provider chaîne — Le fournisseur de décision actif : typesafe, liquid ou kev ; vide, il se déduit des sections et des clés.

Débit et budgets

Deux choses différentes s'appellent « rate limiting ». RateLimiting plafonne les appels au modèle, et tout hôte livré l'applique. ToolRateLimiting plafonne les appels d'outils et TokenBudget les tokens et le coût d'un agent ou d'une crew : les deux ne prennent effet que dans un hôte écrit en C# qui appelle AddOrkeonToolRateLimiting() — aucun binaire livré ne les lit. Une crew borne un agent par maxRpm (schéma YAML), le plus strict de lui et de RateLimiting:AgentRequestsPerMinute l'emportant ; ce que coûtent les appels est suivi par Orkeon:CostTracking.

RateLimiting

Les plafonds de l'hôte sur les appels au modèle : chaque appel au modèle de l'hôte compte une fois, à l'entrée de son fournisseur — tours d'agent, manager, planificateur, RAG, juges, mémoire cognitive, ctx.llm des scripts (pas les embeddings) — face à GlobalRequestsPerMinute, ProviderRequestsPerMinute, MaxConcurrentRequests et QueueLimit ; AgentRequestsPerMinute plafonne chaque instance d'agent dans sa propre fenêtre, avec son maxRpm, le plus strict l'emportant, et une requête de trop attend son tour (sécurité). Liée par AddOrkeonInfrastructure() (ILlmRateLimiter ; RateLimitingOptions dans Orkeon.Application.Configuration).

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
AgentRequestsPerMinute entier 20 Nombre maximal de requêtes au modèle par minute pour chaque agent — chaque instance d'agent, pas chaque rôle : il borne la fenêtre propre de l'agent avec son maxRpm, le plus strict l'emportant, et une requête de trop attend son tour au lieu d'échouer. Lu par l'orchestrateur d'exécution et le manager.
GlobalRequestsPerMinute entier 60 Nombre maximal de requêtes au modèle par minute, tous fournisseurs et agents confondus. Une requête de trop est retenue dans une file de QueueLimit, puis retentée, puis mise en échec.
MaxConcurrentRequests entier 0 Nombre maximal de requêtes au modèle simultanées (en cours). 0 signifie aucune limite de concurrence (limitation de débit seule).
ProviderRequestsPerMinute entier 30 Nombre maximal de requêtes au modèle par minute et par fournisseur, retenues et refusées comme pour le plafond global.
QueueLimit entier 5 Nombre maximal de requêtes que les plafonds global, par fournisseur et de concurrence retiennent en file quand ils sont atteints ; une requête au-delà est refusée, puis retentée.

ToolRateLimiting

Rate limits par outil. Opt-in : AddOrkeonToolRateLimiting(), qui lie depuis l'IConfiguration enregistrée (voir sous-systèmes opt-in).

Lue par : un hôte écrit en C# seulement, par AddOrkeonToolRateLimiting() — aucun binaire livré ne lit cette section.

Clé Type Défaut Sens
DefaultToolRequestsPerMinute entier 30 Nombre maximal de requêtes par minute, par défaut, pour les outils sans limite propre.
GlobalToolRequestsPerMinute entier 120 Nombre maximal de requêtes d'outils par minute, tous outils confondus.
ToolSpecificLimits:<nom> entier FileWriteTool = 15, HttpApiTool = 20, SecureCodeInterpreterTool = 5, WebScrapeTool = 10 Limites de débit par outil, indexées par le nom de l'outil.

TokenBudget

Budgets de tokens. Même opt-in que ToolRateLimiting. MaxCostPerCrew plafonne un coût estimé : l'estimation lit les lignes de prix rattachées à un fournisseur seulement quand l'hôte passe le fournisseur au tracker (sous-systèmes opt-in).

Lue par : un hôte écrit en C# seulement, par AddOrkeonToolRateLimiting() — aucun binaire livré ne lit cette section.

Clé Type Défaut Sens
MaxCostPerCrew nombre 10.0 Coût estimé maximal par crew, en USD. 0 signifie illimité.
MaxTokensPerAgent entier 100000 Nombre maximal de tokens par agent. 0 signifie illimité.
MaxTokensPerCrew entier 500000 Nombre maximal de tokens par crew. 0 signifie illimité.

Mémoire et vecteurs

Où vivent les souvenirs, et comment les textes sont vectorisés et cherchés. Memory:Provider nomme le provider ; sa connexion est la section propre de ce provider.

Memory

Memory:Provider est le TYPE du provider mémoire de l'application (inmemory, redis, sqlite, chromadb, pinecone, lancedb, ou un alias : in-memory, chroma, lance ; absent → in-memory). Sa connexion est la section propre de ce provider (Orkeon:Redis, Orkeon:Sqlite, … plus bas). C'est aussi là que vit la mémoire d'une crew nommée avec memory: true et sans memoryProvider: — voir Système de mémoire. Un autre nom, lancedb sans Orkeon:LanceDb:Endpoint ou pinecone sans Orkeon:Pinecone:ApiKey (ou Host) refuse le démarrage au lieu de tourner sur le provider volatil (quand un réglage est refusé). Liée par AddOrkeonInfrastructure().

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
Provider chaîne — Le type du provider — inmemory, redis, sqlite, chromadb, pinecone, lancedb, ou un alias. Absent, c'est le provider en mémoire.

Orkeon:Redis

Provider mémoire Redis. ConnectionString vaut localhost:6379 par défaut ; la connexion s'ouvre au premier usage. Lue par MemoryProviderFactory sur tout chemin qui sélectionne redis : Memory:Provider, le memoryProvider: d'une crew, Orkeon:Rag:Provider, AddOrkeonRedisMemory. Liée par AddOrkeonInfrastructure().

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
ConnectionString chaîne, secret — La chaîne de connexion StackExchange.Redis (p. ex. localhost:6379, ou redis.internal:6379,password=…,ssl=true).
KeyPrefix chaîne "orkeon:memory:" Le préfixe qui range dans un même espace toutes les clés qu'écrit le provider.

Orkeon:Sqlite

Provider mémoire SQLite. ConnectionString vaut Data Source=:memory: par défaut ; une Data Source fichier est un chemin virtuel sur un montage inscriptible. Lue par MemoryProviderFactory sur tout chemin qui sélectionne sqlite. Liée par AddOrkeonInfrastructure().

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
ConnectionString chaîne, secret — La chaîne de connexion SQLite (p. ex. "Data Source=/data/orkeon-memory.db" ou "Data Source=:memory:"). Par défaut une base en mémoire (Data Source=:memory:) ; une Data Source fichier est un chemin virtuel, qui doit désigner un montage inscriptible.
DefaultTopK entier 10 Le nombre de résultats renvoyés par défaut par les requêtes vectorielles.
MinSimilarityScore nombre 0 Le seuil minimal de score de similarité des résultats de recherche vectorielle.
TableName chaîne "memory_items" Le nom de la table où sont stockés les éléments de mémoire. Doit correspondre à ^[A-Za-z_][A-Za-z0-9_]*$ : l'identifiant est interpolé dans des instructions SQL. Vérifié au démarrage d'un hôte, puis de nouveau à la construction.

Orkeon:ChromaDb

Serveur ChromaDB. Lue par MemoryProviderFactory sur tout chemin qui sélectionne chromadb. Liée par AddOrkeonInfrastructure() ; AddOrkeonChromaDb(configuration) (appelée par AddOrkeonInfrastructure(configuration) quand la section existe) expose aussi le ChromaDbMemoryProvider partagé par sa classe.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
BaseUrl URI "http://localhost:8000/" L'URL de base du serveur ChromaDB.
CollectionName chaîne "orkeon_memories" Le nom de la collection où sont stockés les souvenirs.
Database chaîne "default_database" La base de données adressée par l'API v2 (/api/v2/tenants/{tenant}/databases/{database}/...). Vaut default_database par défaut. Une base autre que celle par défaut doit déjà exister sur le serveur.
DefaultTopK entier 10 Le nombre de résultats renvoyés par défaut par les requêtes.
Tenant chaîne "default_tenant" Le tenant adressé par l'API v2 (/api/v2/tenants/{tenant}/...). Vaut default_tenant par défaut. Un tenant autre que celui par défaut doit déjà exister sur le serveur.

Orkeon:Pinecone

Index Pinecone. Host est facultatif : sans lui, un appel describe_index résout l'hôte de l'index au premier usage. Lue par MemoryProviderFactory sur tout chemin qui sélectionne pinecone. Liée par AddOrkeonInfrastructure(), et par AddOrkeonPinecone(configuration).

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
ApiKey chaîne, secret — La clé d'API Pinecone.
Host chaîne — L'hôte de l'index, tel que Pinecone le donne (p. ex. orkeon-memories-abc1234.svc.aped-4627-b74a.pinecone.io ; le schéma est facultatif). Vide, le provider interroge une fois le plan de contrôle, au premier usage (GET https://api.pinecone.io/indexes/{IndexName}), et utilise le host renvoyé.
IndexName chaîne "orkeon-memories" Le nom de l'index Pinecone.
Namespace chaîne "default" L'espace de noms dans l'index.

Orkeon:LanceDb

Serveur LanceDB distant. Lue par MemoryProviderFactory sur tout chemin qui sélectionne lancedb. Liée par AddOrkeonInfrastructure() ; AddOrkeonLanceDb(configuration) ajoute la classe concrète et LanceDbMigrationService.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
ApiKey chaîne, secret — La clé d'API envoyée dans l'en-tête x-api-key.
CreateFullTextIndexOnInit booléen true Si le provider crée un index plein texte (FTS) sur la colonne content quand il crée la table. La recherche plein texte côté serveur exige cet index ; un échec de création est journalisé en avertissement et réapparaît plus tard en erreur serveur sur SearchAsync.
Database chaîne — Le nom de base de données facultatif envoyé dans l'en-tête x-lancedb-database (déploiements Enterprise derrière un point d'accès partagé ou privé).
DefaultTopK entier 10 Le nombre de résultats renvoyés par défaut par les requêtes.
DistanceType chaîne "cosine" La métrique de distance de la recherche vectorielle côté serveur (cosine, l2 ou dot). Le provider convertit la _distance renvoyée en score de similarité par 1 - distance, ce qui n'a de sens que pour la métrique par défaut, cosine.
EmbeddingDimension entier 1536 La dimension du vecteur d'embedding de la colonne vector, de taille fixe, de la table. Doit correspondre aux embeddings stockés par le provider.
Endpoint chaîne "" L'URL de base du point d'accès REST LanceDB Cloud/Enterprise (p. ex. https://my-deployment.us-east-1.api.lancedb.com).
FullTextWeight nombre 0.3 Le poids appliqué au classement plein texte (BM25) côté serveur lors de la fusion des résultats de recherche hybride.
MinSimilarityScore nombre 0 Le seuil minimal de score de similarité des résultats de recherche vectorielle.
TableName chaîne "orkeon_memories" Le nom de la table où sont stockés les souvenirs.
VectorWeight nombre 0.7 Le poids appliqué au classement par similarité vectorielle côté serveur lors de la fusion des résultats de recherche hybride.

Orkeon:CrewMemory

Ce que rappelle une crew memory: true avant chaque tâche (CrewMemoryOptions) : au plus RecallLimit souvenirs (0 ne rappelle rien), ceux dont la similarité cosinus atteint MinScore — à l'échelle de l'embedder, mesurée sur le modèle local —, coupés à MaxChars caractères de contenu au total — voir Système de mémoire. Lue par MemoryCoordinator ; liée par AddOrkeonInfrastructure(). Avec la mémoire cognitive activée, le rappel est borné par MinCompositeScore et MinSemanticScore au lieu de MinScore, et ConsolidateOnRunEnd consolide la mémoire à la fin d'un run.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
ConsolidateOnRunEnd booléen false Si la mémoire de la crew est consolidée (souvenirs redondants fusionnés, souvenirs de faible valeur élagués) à la fin d'un run. Défaut : false, une consolidation coûte des appels LLM. Lu seulement quand la mémoire cognitive est branchée.
MaxChars entier 4000 Combien de caractères de contenu de mémoire l'invite d'une tâche reçoit au plus, tous souvenirs rappelés confondus. 4 000 par défaut ; le dernier souvenir qui ne tient pas est coupé.
MinCompositeScore nombre 0.4 Le score composite minimal (similarité, récence et importance ensemble) d'un souvenir pour être rappelé quand la mémoire cognitive est branchée. Défaut : 0,4. Distinct de MinScore, qui borne la similarité cosinus du chemin vectoriel : les deux échelles diffèrent.
MinScore nombre 0.6 La similarité cosinus minimale entre une tâche et un souvenir pour que le souvenir soit rappelé. 0,6 par défaut, mesuré sur le modèle d'embedding local (BGE-micro-v2), sur lequel la même tâche d'un run antérieur obtient 0,72 et plus, et une tâche anglaise sans rapport 0,53 et moins. Son échelle est celle de l'embedder : un autre modèle demande sa propre mesure.
MinSemanticScore nombre 0.5 La similarité sémantique (cosinus) minimale d'un souvenir pour être rappelé par la mémoire cognitive, quelles que soient sa récence et son importance : un souvenir rangé à l'instant, d'importance par défaut, atteint MinCompositeScore sur ces deux seules composantes, la pertinence est donc exigée à part. 0,5 par défaut ; son échelle est celle de l'embedder, comme MinScore.
RecallLimit entier 5 Combien de souvenirs une tâche rappelle au plus. 5 par défaut ; 0 ne rappelle rien (la crew stocke quand même ce que produisent ses tâches).

Orkeon:CognitiveMemory

Couche de mémoire cognitive. Opt-in : les exécuteurs la branchent quand Enabled vaut true (AddOrkeonCognitiveMemory(configuration) pour un hôte écrit en C#). Pas de clé YAML : le coût de l'analyse est à la charge de l'opérateur.

Lue par : orkeon, orkeon-host.

Clé Type Défaut Valeurs Sens
AnalysisModel chaîne — Modèle de remplacement facultatif pour les appels d'analyse. Null (ou vide), ils tournent sur le modèle propre du fournisseur.
AnalysisTemperature nombre 0.1 Température des appels d'analyse LLM. Défaut : 0,1.
ContradictionCandidateCount entier 10 Nombre de souvenirs existants où chercher des contradictions. Défaut : 10.
DefaultRecallOptions:ImportanceWeight nombre 0.2 Poids de l'importance dans le score composite. Défaut : 0,2.
DefaultRecallOptions:MinScore nombre 0.1 Seuil minimal du score composite. Défaut : 0,1.
DefaultRecallOptions:MinSemanticScore nombre 0 Similarité sémantique minimale d'un souvenir quelles que soient sa récence et son importance : sans elle, un souvenir frais d'importance par défaut sans rapport avec la requête atteint le plancher composite sur ces deux seules composantes. Défaut : 0.
DefaultRecallOptions:RecencyWeight nombre 0.3 Poids de la récence dans le score composite. Défaut : 0,3.
DefaultRecallOptions:SemanticWeight nombre 0.5 Poids de la similarité sémantique dans le score composite. Défaut : 0,5.
DefaultRecallOptions:TagFilter liste de chaînes [] Filtre facultatif par étiquettes (une seule suffit).
DefaultRecallOptions:TopK entier 10 Nombre maximal de résultats renvoyés. Défaut : 10.
DefaultRecallOptions:TypeFilter énumération — ShortTerm, LongTerm, Episodic, Entity, Procedural Filtre facultatif par type de mémoire.
EnableContradictionDetection booléen true Si la détection de contradictions est activée à la mémorisation. Défaut : true.
Enabled booléen false Si les exécuteurs branchent la mémoire cognitive sur un run : rappel par score composite, stockage analysé, outil memory_recall. Défaut : false (l'analyse coûte des appels LLM).
EnableLlmAnalysis booléen true Si l'analyse du contenu par LLM est activée à la mémorisation. Défaut : true.
Profile chaîne — Le profil LLM (Llm:Profiles:<nom>) sur lequel tournent l'analyse, la détection de contradictions et la consolidation, donc comptés comme tout appel. Null ou vide : le profil par défaut.
PruningMinAgeDays entier 30 Âge minimal, en jours, avant qu'un souvenir puisse être élagué. Défaut : 30.
PruningThreshold nombre 0.1 Seuil d'importance en dessous duquel un souvenir est candidat à l'élagage. Défaut : 0,1.
RecencyHalfLifeHours nombre 69 Demi-vie de la décroissance de récence, en heures (exp(-ln2/halfLife * ageHours)). Défaut : 69,0.

Orkeon:Encryption

Chiffrement de la mémoire au repos. Enregistré par AddOrkeonInfrastructure() ; la section gouverne le comportement, et le décorateur est posé par l'hôte. La rotation de clés reste opt-in : AddOrkeonKeyRotation().

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
Enabled booléen false Si le chiffrement est activé.
KeySizeInBits entier 256 Taille de la clé en bits (128, 192 ou 256).
SecretName chaîne "orkeon-encryption-key" Le nom du secret par lequel la clé de chiffrement est obtenue auprès de ISecretProvider.

Orkeon:Embeddings

Sélection du provider d'embeddings : Provider vaut openai, tout générateur d'embeddings M.E.AI qu'inscrit l'hôte, ollama, mistral, azure-openai ou gemini ; un autre nom refuse le démarrage. Les trois derniers parlent le format d'embeddings d'OpenAI et lisent ApiKey (ou ApiKeyEnvVar), Endpoint et Model ; azure-openai exige aussi Endpoint (l'URL de la ressource) et prend le nom du déploiement comme Model. Au démarrage, l'hôte compare le provider, le modèle et les dimensions à ceux consignés dans FingerprintPath et refuse de démarrer s'ils ont changé. orkeon forge prend par défaut, pour FingerprintPath, /forge/embedding-fingerprint.json, consigné par session : il ne garde donc rien d'une session à l'autre ; orkeon rag le vide et garde chaque collection par son manifeste (ingest, search, eval rag --no-ingest -c et eval rag -c avec sa passe d'ingestion et sans --reindex ; --reindex reconstruit). Une valeur posée dans les settings l'emporte. Un chemin sous aucun montage désactive le garde-fou en Debug. Là où le montage qui le couvre, surcharges comprises, n'accorde ni Write ni Create sur le fichier ni Create sur son dossier (un /workspace en lecture seule), le garde-fou lit et compare encore une empreinte consignée et refuse encore un changement de modèle, mais n'écrit rien, et quand aucune empreinte n'est encore consignée journalise une ligne Debug qui nomme FingerprintPath, jamais un Warning. Un provider qui ne peut pas donner ses dimensions (un ModelPath personnalisé introuvable) fait journaliser au garde-fou un Warning avec le message du provider lui-même. Lue par DefaultEmbeddingProviderResolver, quand aucun provider local ni d'analyse de code n'est inscrit. Liée par AddOrkeonInfrastructure(), et par AddOrkeonVectorSearch(configuration) (appelé par AddOrkeonInfrastructure(configuration)).

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
ApiKey chaîne, secret — La clé d'API de mistral, azure-openai et gemini, en clair. Préférer ApiKeyEnvVar : une clé écrite ici se trouve dans le fichier de réglages.
ApiKeyEnvVar chaîne "" Nom de la variable d'environnement qui porte la clé d'API, lue quand ApiKey est vide.
ApiVersion chaîne "" Le paramètre api-version d'azure-openai. Vide : la version par défaut du fournisseur (2024-10-21).
BatchSize entier 100 Taille maximale d'un lot pour les requêtes d'embedding groupées.
Dimension entier 1536 La dimension des vecteurs d'embedding.
EnableCache booléen true Si le cache d'embeddings est activé.
Endpoint chaîne "" URL de base du point d'accès des embeddings. Vide : le point d'accès public du fournisseur. Obligatoire pour azure-openai : l'URL de la ressource, https://<ressource>.openai.azure.com.
FingerprintPath chaîne "/workspace/.orkeon/embedding-fingerprint.json" Chemin virtuel du fichier qui consigne le fournisseur, le modèle et les dimensions dont viennent les vecteurs stockés ; l'hôte refuse de démarrer quand ils changent. Vide : le garde-fou est désactivé. orkeon forge le règle par défaut sur /forge/embedding-fingerprint.json, orkeon rag et orkeon eval rag sur vide.
Model chaîne "text-embedding-3-small" Le nom du modèle utilisé pour les embeddings.
Provider chaîne "openai" Le provider d'embeddings à utiliser : "openai", "ollama", "mistral", "azure-openai" ou "gemini".

Orkeon:EmbeddingCache

Cache d'embeddings. Liée comme Orkeon:Embeddings.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
MaxCacheSizeBytes entier 104857600 Taille totale maximale du cache, en octets.
SlidingExpirationMinutes entier 60 Durée d'expiration glissante, en minutes, des embeddings en cache.

Orkeon:VectorSearch

Options de recherche vectorielle. Liée par AddOrkeonVectorSearch(configuration), qu'appelle AddOrkeonInfrastructure(configuration).

Lue par : un hôte écrit en C# seulement, par AddOrkeonVectorSearch() — aucun binaire livré ne lit cette section.

Clé Type Défaut Sens
DefaultMinScore nombre 0.7 Le seuil minimal de score de similarité par défaut.
DefaultTopK entier 10 Le nombre de meilleurs résultats renvoyés par défaut.
PreferVectorSearch booléen true S'il faut préférer la recherche vectorielle à la recherche textuelle quand elle est disponible.

RAG

Détails et sémantique : Pipeline RAG. Tout ce qui suit requiert AddOrkeonRag(configuration) (Orkeon.Rag.DependencyInjection), qu'appelle tout hôte livré.

Orkeon:Rag

Le pipeline de requête, étape par étape :

  • Profile — le preset : fast (défaut), balanced, quality, adaptive ou corrective ; toute clé Orkeon:Rag surcharge le preset clé par clé. Les défauts du tableau sont ceux du profil par défaut, fast : une clé que les profils règlent différemment le dit, et les cinq presets sont comparés dans Pipeline RAG.
  • LlmProfile — le profil LLM de l'hôte (Llm:Profiles:<nom>) qu'appelle le sous-système RAG — génération, transformateurs de requête, reranker listwise, évaluateur et vérificateur d'ancrage correctifs, classifieur llm, juge d'évaluation ; absent ou default : le profil par défaut. Un nom inconnu fait refuser le démarrage de l'hôte en listant les profils connus ; orkeon eval rag --offline l'ignore.
  • Provider — TYPE du provider du document store RAG (RagStoreOptions — un alias de type de MemoryProviderFactory), connecté depuis la section propre de ce provider (Orkeon:Redis, Orkeon:Sqlite, …) ; défaut : l'IMemoryProvider ambiant.
  • Collection — la collection qu'interroge rag_search quand l'agent n'en nomme aucune (non définie : default) ; rag_eval l'utilise pour un dataset qui ne nomme pas de collection et n'apporte pas de corpus.
  • Retrieval — les bornes de l'étape de retrieval ; Retrieval:Mmr — MMR opt-in.
  • Rerank — choix et profondeur du reranker.
  • Context — assemblage du contexte (ordre edges anti-Lost-in-the-Middle).
  • Groundedness — le hook de groundedness.
  • Generation — l'étape de génération citée.
  • QueryTransform — transformateurs de requête (multi-query/rag-fusion/hyde).
  • Corrective — les bornes du graphe correctif CRAG ; Corrective:WebFallback — la moitié « politique » du repli web, dont le transport est Orkeon:Rag:WebFallback.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
Collection chaîne — Collection interrogée par défaut quand le site d'appel n'en nomme aucune.
Context:MaxTokens entier 2000 Budget du contexte en tokens (heuristique : 1 token ≈ 4 caractères ; les fragments en trop sont écartés, la génération ne se fait jamais en silence au-delà).
Context:Ordering chaîne "edges" Disposition des fragments dans le bloc de contexte : edges (défaut — anti-Lost-in-the-Middle : les rangs impairs 1, 3, 5… ouvrent le bloc, les rangs pairs …6, 4, 2 le ferment, si bien que les deux meilleurs fragments sont aux extrémités) ou linear (simple ordre des rangs). Les marqueurs de citation restent fondés sur le rang ([1] = meilleur fragment) quelle que soit la disposition.
Corrective:MaxIterations entier 3 Nombre maximal d'itérations correctives (réécritures de requête — déclenchées par un verdict de retrieval Incorrect ou par une réponse non ancrée) avant que le pipeline ne génère avec les meilleurs fragments disponibles. Vaut 3 par défaut.
Corrective:WebFallback:Enabled booléen false Si le repli web peut se déclencher. Désactivé par défaut (opt-in) : le retrieval reste strictement local tant que l'hôte ne l'active pas explicitement ET n'enregistre pas un retriever de documents web.
Corrective:WebFallback:MaxResults entier 3 Nombre maximal de documents web demandés au retriever. Vaut 3 par défaut.
Generation:MaxOutputTokens entier — Nombre maximal de tokens de sortie passé au client de chat.
Generation:SystemPrompt chaîne — Invite système ancrée ; null sélectionne celle du pipeline par défaut (anti-hallucination, marqueurs [n]).
Generation:Temperature nombre — Température d'échantillonnage passée au client de chat.
Groundedness:Enabled booléen false — sous le profil par défaut, fast : chaque profil règle le sien Si la réponse est vérifiée contre le contexte récupéré après la génération. Requiert l'enregistrement d'un IGroundednessChecker ; activée sans lui, l'étape est tracée comme sautée.
LlmProfile chaîne — Le profil LLM de l'hôte (Llm:Profiles:<nom>) vers lequel va chaque appel au modèle du sous-système — génération ancrée, transformateurs de requête, reranker listwise, évaluateur et vérificateur d'ancrage du graphe correctif, classifieur llm et juge d'évaluation. Null, vide ou default : le profil par défaut de l'hôte. Une clé d'hôte : un seul profil pour tout le sous-système, qu'aucun preset ne règle.
Profile chaîne "fast" Nom du profil (fast, balanced, quality, adaptive, corrective). Vaut fast par défaut — balanced demande le paquet opt-in du reranker ONNX. Un nom inconnu échoue bruyamment.
Provider chaîne — Le type de provider mémoire qui porte le document store du RAG : inmemory, in-memory, redis, sqlite, chromadb, chroma, pinecone, lancedb, lance. null ou vide sélectionne le provider ambiant du conteneur.
QueryTransform:Mode chaîne "none" Nom du transformateur, résolu par la fabrique de transformateurs de requête : none (défaut), multi-query, rag-fusion ou hyde. none saute l'étape ; un nom inconnu échoue bruyamment.
QueryTransform:VariantCount entier 3 Nombre de variantes demandées aux transformateurs autres que none.
Rerank:Enabled booléen false — sous le profil par défaut, fast : chaque profil règle le sien Si l'étape de rerank s'exécute. Désactivée, les candidats sont tronqués à TopN dans l'ordre du retrieval.
Rerank:Kind chaîne "none" — sous le profil par défaut, fast : chaque profil règle le sien Nom du reranker, résolu par la fabrique de rerankers (none/noop, llm/listwise, onnx/cross-encoder — ce dernier par le paquet opt-in Orkeon.Rag.Onnx). Un nom inconnu échoue bruyamment.
Rerank:TopN entier 5 Nombre de fragments gardés par défaut après le rerank (un RagQuery.TopN du site d'appel l'emporte).
Retrieval:CandidateK entier 5 — sous le profil par défaut, fast : chaque profil règle le sien Nombre de candidats récupérés avant la fusion et le rerank (l'étape large de la cascade 50 → 5). Le pipeline récupère toujours au moins le TopN final.
Retrieval:MinScore nombre — Plancher de score facultatif appliqué aux scores bruts du retrieval avant la fusion. null (défaut) n'en applique aucun — le plancher global toxique de 0,7 de l'ancien sous-système a été retiré à dessein.
Retrieval:Mmr:Enabled booléen false Si la diversification MMR s'exécute à l'étape de fusion et de dédoublonnage. Désactivée par défaut.
Retrieval:Mmr:Lambda nombre 0.7 Compromis pertinence/diversité dans [0, 1] : 1 garde le pur ordre de pertinence, 0 maximise la diversité. Vaut 0.7 par défaut.
Retrieval:TopK entier 5 Nombre de fragments gardés par défaut pour l'assemblage du contexte (un RagQuery.TopN du site d'appel l'emporte).

Orkeon:Rag:Retrieval:Hybrid

Récupération hybride BM25+RRF.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
Enabled booléen false — sous le profil par défaut, fast : chaque profil règle le sien Si le retrieval fusionne les classements lexical (BM25 / plein texte natif) et vectoriel. Honoré requête par requête par un document store capable d'hybride.
RrfK entier 60 Constante de la Reciprocal Rank Fusion (doit être positive ; 60 est la valeur standard).

Orkeon:Rag:Ingestion

Le pipeline d'ingestion (RagIngestionOptions).

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
DefaultChunkingStrategy chaîne "recursive" Stratégie de découpage résolue par la fabrique de découpage quand une IngestionRequest n'en nomme aucune. Vaut recursive par défaut.
ManifestDirectory chaîne "/output/rag/manifests" Répertoire virtuel (chemin VFS) qui contient les manifestes d'ingestion par collection ({collection}.json). Vaut /output/rag/manifests par défaut — sous le montage inscriptible conventionnel /output, à côté des autres artefacts d'un run.

Orkeon:Rag:QueryRouting

Routage Adaptive-RAG : le classifieur est heuristic ou llm.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
Classifier chaîne "heuristic" Nom du classifieur : heuristic (défaut — sûr, déterministe, fonctionne sans aucun LLM) ou llm. Un nom inconnu échoue bruyamment à la résolution. Quand llm est choisi mais qu'aucun IChatClient n'est enregistré, le classifieur heuristique sert de repli documenté (avec un avertissement) au lieu d'échouer.

Orkeon:Rag:WebFallback

Le repli web est un double opt-in, les deux Enabled désactivés par défaut : la politique (Orkeon:Rag:Corrective:WebFallback, dans le tableau d'Orkeon:Rag) et cette section, son transport SearxNG.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Valeurs Sens
ApiKeyEnvVar chaîne "" Nom de la variable d'environnement qui contient la clé d'API, envoyée dans un en-tête Authorization: Bearer quand elle est définie. Vide = pas d'en-tête d'authentification. La clé elle-même ne vit jamais dans un fichier de configuration.
Enabled booléen false Interrupteur principal du transport. false par défaut — opt-in strict.
Endpoint chaîne "" URL du point d'accès de recherche d'une API JSON compatible SearxNG (interrogée par {Endpoint}?q={query}&format=json, en attendant un tableau JSON results[].url). Vide = désactivé (journalisé).
MaxResults entier 3 Nombre maximal de résultats de recherche récupérés par requête. 3 par défaut.
SuspiciousAction énumération "Flag" Flag, Discard Que faire des documents que le validateur d'injection marque Suspicious : les garder, marqués dans leurs métadonnées (défaut), ou les écarter. Les documents rejetés sont toujours écartés.
Timeout durée "00:00:10" Délai par requête (l'appel de recherche et chaque téléchargement de page). 10 s par défaut.

Fichiers et bac à sable

Les dossiers qu'un run peut atteindre, et l'endroit où peut tourner le code qu'écrit un agent.

Orkeon:FileSystem

Mounts — les montages VFS (voir Conformité VFS). Une entrée peut porter un identifiant — <ulid>|<physique>:<virtuel>:<droits> : ce par quoi le bloc mounts: d'une crew, un sidecar d'équipe et --mount-id la désignent. Un --mount CLI sur la même racine virtuelle remplace toutes les entrées de cette racine pour ce run ; sur une racine neuve il est ajouté (jamais fusionné, jamais perdu). Une racine déclarée deux fois n'est légitime que si chacune de ses entrées porte un identifiant — --mount-id, ou le mounts: de la crew, en sélectionne alors une et les autres sont retirées pour le run ; si rien n'en sélectionne une, le run est refusé avant tout host ('/output' is declared twice in <settings> (<idA>: <dossierA>, <idB>: <dossierB>) and nothing selects one. Pass --mount-id <id>, list '<id>|/output' under mounts: in the crew, or pass --mount <folder>:/output:rw to replace them all.), sauf sous orkeon forge et une commande qui n'offre aucun moyen de sélectionner une entrée (orkeon mcp serve), qui retirent toutes les entrées de cette racine avec un avertissement et poursuivent. Une racine déclarée deux fois avec une entrée sans identifiant (… and '<entrée>' has no id. Give every entry an id …) ou un identifiant porté par deux entrées est refusée par toutes les commandes. Le chemin de base de chaque entrée déclarée est mis en liste blanche pour PathValidator sans --allow-external-mounts — un dossier déclaré est l'intention du propriétaire de la machine, il reste donc accessible même hors du répertoire de travail du processus ; une entrée retirée ne l'est pas.

InternalMounts — même grammaire que Mounts, enregistrés en MountVisibility.Internal : résolubles par le VFS, absents de list_mounts, de la table de montages du prompt agent et des messages de refus d'accès. C'est là qu'un hôte met ce que le VFS doit atteindre et qu'aucun agent n'a à adresser — le répertoire --llm-log y vit, et /credentials, les jetons OAuth des comptes e-mail, quand un tel compte est déclaré (ADR-008).

WorkingDirectory — le répertoire virtuel contre lequel se résout un chemin d'outil relatif, et où s'exécute un shell_command qui n'en nomme aucun : un chemin absolu sans segment . ni .. dans un mount visible des agents, faute de quoi l'hôte refuse de démarrer en nommant la clé. Défini, il l'emporte sur /workspace. Non défini, les runners prennent /workspace s'il est monté, sinon /output, sinon aucun (Répertoire de travail et chemins relatifs).

WriteDirectory — le répertoire virtuel accessible en écriture où s'exécute un shell_command d'écriture qui ne nomme aucun répertoire, hors de toute racine d'agent, quand le répertoire de travail ne lui accorde pas tous les droits (un /workspace en lecture seule, comme dans orkeon forge) : un chemin absolu sans segment . ni .. dans un mount visible des agents dont les droits effectifs sur ce chemin, surcharges de sous-arbre comprises, accordent l'écriture, faute de quoi l'hôte refuse de démarrer en nommant la clé. Non défini, /output quand un mount visible des agents y accorde l'écriture, sinon aucun, et une telle commande est refusée. Il ne dépend jamais de l'ordre des mounts, et les chemins relatifs des outils de fichiers se résolvent toujours contre le seul répertoire de travail.

Les quatre sont lues par AddOrkeonFileSystem(...).

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
InternalMounts liste de chaînes [] Montages d'infrastructure, même grammaire que Mounts : résolubles par l'hôte, absents de list_mounts, de la table de montages de l'invite d'agent et des messages de refus d'accès, et refusés à tout outil. C'est là qu'un runner met ce que le VFS doit atteindre et qu'aucun agent n'a à adresser — le répertoire du journal des échanges LLM, par exemple.
Mounts liste de chaînes [] Définitions de montages au format "physical:virtual:rights[;subpath:rights;...]".
WorkingDirectory chaîne — Le répertoire virtuel contre lequel se résolvent les chemins relatifs, et où s'exécute une commande shell qui n'en nomme aucun (Orkeon:FileSystem:WorkingDirectory). Non défini, le runner prend /workspace s'il est monté, sinon /output, sinon aucun.
WriteDirectory chaîne — Le répertoire virtuel accessible en écriture où s'exécute une commande shell d'écriture qui n'en nomme aucun, hors de toute racine d'agent, quand le répertoire de travail ne lui accorde pas tous les droits (Orkeon:FileSystem:WriteDirectory). Non défini, /output quand un mount visible des agents y accorde l'écriture, sinon aucun.

Orkeon:Sandbox

Le montage sandbox du système de fichiers (/sandbox, Internal) ; les répertoires de session orphelins sont nettoyés au-delà de CleanupOrphansOlderThan (24 h). Lue par AddOrkeonFileSystem(...).

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
CleanupOrphansOlderThan durée "1.00:00:00" Seuil d'âge des répertoires de session orphelins. Les répertoires plus anciens sont supprimés par le concierge au démarrage. 24 heures par défaut.
EphemeralRoot chaîne — Répertoire racine sous lequel sont créés les répertoires de sandbox par session. À null, vaut Path.Combine(Path.GetTempPath(), "orkeon-sandbox").
VirtualPath chaîne "/sandbox" Chemin virtuel où le sandbox est monté. /sandbox par défaut.

PathSecurity

Validation des chemins physiques. Liée par AddOrkeonInfrastructure() (IPathValidator).

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
AdditionalAllowedDirectories liste de chaînes [] Répertoires supplémentaires autorisés au-delà de la racine de l'espace de travail.
AdditionalBlockedExtensions liste de chaînes [] Extensions de fichier supplémentaires à bloquer, en plus de la liste intégrée.
BlockReadsOfBlockedExtensions booléen false Si une simple lecture d'une extension de script intégrée (.sh, .bash, .ps1, .bat, .cmd, .vbs, .wsf) est refusée elle aussi. Défaut : false : lire un script n'est pas l'exécuter, la lecture passe tandis qu'une écriture, une création, une suppression ou une cible de commande y est refusée. Les extensions binaires intégrées et AdditionalBlockedExtensions refusent la lecture quoi que dise cette option.
DefaultWorkspaceRoot chaîne — Le répertoire racine de l'espace de travail par défaut. À null, c'est le répertoire de travail courant.
MaxFileSizeBytes entier 52428800 Taille de fichier maximale autorisée, en octets. Défaut : 50 Mo.
ResolveSymlinks booléen true S'il faut résoudre les liens symboliques et vérifier que la cible est dans l'espace de travail. Défaut : true.

Orkeon:CodeSandbox

Le sandbox de l'interpréteur de code sécurisé. Enregistré par AddOrkeonInfrastructure() ; la section gouverne le comportement.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
AllowHostExecution booléen false Opt-in explicite et bruyant pour autoriser l'exécution de code dans un sandbox qui n'offre AUCUNE isolation au niveau du système (l'exécuteur de processus de l'hôte) quand un sandbox isolant (Docker) est indisponible. Laissée à false, l'exécution de code est refusée plutôt que lancée sur l'hôte ; true équivaut à une RCE sur l'hôte, pour du code de confiance dans un environnement de confiance seulement.
DefaultPermissions:AllowedPaths liste de chaînes [] Liste des chemins de fichiers autorisés.
DefaultPermissions:AllowFileRead booléen false Autorise la lecture de fichiers.
DefaultPermissions:AllowFileWrite booléen false Autorise l'écriture de fichiers.
DefaultPermissions:AllowNetworkAccess booléen false Autorise l'accès au réseau.
DefaultPermissions:AllowProcessExec booléen false Autorise le lancement de processus enfants.
DefaultPermissions:AllowReflection booléen false Autorise les API de réflexion.
DefaultPermissions:WorkingDirectory chaîne — Répertoire de travail du sandbox.
MaxMemoryBytes entier 268435456 Mémoire maximale en octets (défaut : 256 Mo).
MaxOutputBytes entier 50000 Taille maximale de la sortie en octets (défaut : 50 Ko).
SecurityOptions:AllowedNamespaces liste de chaînes ["System", "System.Collections.Generic", "System.Linq", "System.Text", "System.Text.Json", "System.Text.RegularExpressions", "System.Math"] Espaces de noms autorisés dans les directives using.
SecurityOptions:AllowFileIO booléen false Autorise les opérations d'entrée-sortie sur fichiers.
SecurityOptions:AllowNetworking booléen false Autorise les opérations réseau.
SecurityOptions:AllowProcessExec booléen false Autorise le lancement de processus.
SecurityOptions:AllowReflection booléen false Autorise les API de réflexion.
SecurityOptions:AllowUnsafeCode booléen false Autorise les blocs de code unsafe.
SecurityOptions:BlockedTypes liste de chaînes ["System.Diagnostics.Process", "System.IO.File", "System.IO.Directory", "System.Reflection.Assembly", "System.Runtime.InteropServices.Marshal", "System.Net.Sockets.Socket", "System.AppDomain"] Types toujours bloqués.
TimeoutSeconds entier 30 Délai d'exécution par défaut, en secondes.

Orkeon:CodeSandbox:Docker

Le sandbox Docker de l'interpréteur de code sécurisé.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
ImageName chaîne "mcr.microsoft.com/dotnet/sdk:10.0-alpine" Image Docker utilisée pour l'exécution de code.
PullImageOnStartup booléen false S'il faut tirer l'image au démarrage.

Sécurité

Ce qui filtre une invite, un appel d'outil et un résultat d'outil, ce qui est audité, et d'où viennent les secrets. Le récit est dans Sécurité.

Orkeon:Guardian

Le pipeline de gardes : GuardianPipeline joue la phase d'entrée de chaque tour d'agent, et les phases outil et délégation de chaque appel d'outil. Actif par défaut, enregistré par AddOrkeonInfrastructure(). La sous-section Llm ajoute un juge LLM, coupé par défaut : le modèle de décision juge l'entrée et la sortie d'une tâche (Phases), un risque à BlockThreshold ou au-dessus bloque, et quand le modèle ne répond pas FailMode tranche : Closed (défaut) refuse, Open laisse passer le texte ; les deux auditent guardian.judge.unavailable. Tant que la phase de sortie est gardée, le streaming d'une tâche attend le jugement. Il demande un modèle de décision (AddOrkeonDecisionProvider) ; activé sans lui, l'hôte refuse de démarrer.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Valeurs Sens
DefaultPolicy:DelegationGuardEnabled booléen true Si la phase de délégation (profondeur, auto-délégation, cycles) s'exécute.
DefaultPolicy:InputGuardEnabled booléen true Si la phase d'entrée (filtrage anti-injection de l'invite utilisateur composée) s'exécute.
DefaultPolicy:MaxDelegationDepth entier 5 Combien de délégations synchrones peuvent s'emboîter avant que la suivante ne soit bloquée.
DefaultPolicy:OutputGuardEnabled booléen true Si la phase de sortie s'exécute. Sa seule garde est le juge LLM, lui-même coupé sauf Orkeon:Guardian:Llm:Enabled.
DefaultPolicy:ToolGuardEnabled booléen true Si la phase outil (traversée de chemin, SSRF et injection SQL dans les arguments d'outil) s'exécute.
Enabled booléen true Si le guardian s'exécute. À false, aucun guardian n'est enregistré dans le pipeline : les tours d'agent ne sont filtrés ni en entrée ni sur les appels d'outils.
Llm:BlockThreshold nombre 0.8 La probabilité à partir de laquelle un risque bloque le texte.
Llm:Enabled booléen false Si le juge tourne ; coupé par défaut (il coûte un appel de modèle par phase).
Llm:FailMode énumération "Closed" Closed, Open Ce qui se passe quand le modèle de décision ne peut pas juger : Closed (défaut) refuse, Open laisse passer le texte ; les deux auditent guardian.judge.unavailable.
Llm:MaxContentChars entier 8000 Les caractères d'un texte que le juge lit en un appel. Sous Closed un texte plus long est jugé en entier, bloc par bloc (un bloc qui bloque bloque), jusqu'à 32 blocs, et un texte au-delà est refusé ; sous Open il est jugé sur la première et la dernière moitié de ce budget, ce qui est entre n'est pas jugé, et la coupe est auditée.
Llm:Phases liste d'énumérations [] Input, Output Les phases jugées, Input et/ou Output ; vide, les deux. Toute autre valeur est refusée au démarrage (les phases d'outil et de délégation sont vérifiées par des règles, pas par un modèle).
Llm:Risks:<nom> chaîne — Les risques détectés, chacun avec ce qu'il est ; vide, les risques par défaut s'appliquent.
Llm:WarnThreshold nombre 0.5 La probabilité à partir de laquelle un risque est un avertissement.

Security:Prompt

La phase d'entrée du Guardian : Policy vaut Block par défaut — High/Critical fait échouer la tâche, moindre avertit —, Warn ou None. Liée par AddOrkeonInfrastructure() ; elle filtre l'invite de chaque tour d'agent — voir Sécurité.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Valeurs Sens
CustomPatterns liste de chaînes [] Motifs regex personnalisés à détecter en plus des motifs intégrés.
EnableExfiltrationDetection booléen true Si la détection des tentatives d'exfiltration de données est activée. Vrai par défaut.
Policy énumération "Block" None, Warn, Block La politique que la phase d'entrée du Guardian applique à l'invite utilisateur composée. Défaut Block : un motif High ou Critical fait échouer la tâche avant tout appel au fournisseur, un motif moindre est journalisé et audité ; l'invite n'est jamais réécrite.

Security:ToolResults

Filtrage des résultats d'outils : Policy vaut Warn par défaut — balisé comme donnée et signalé —, Block retient High/Critical, None laisse tout passer ; les TrustedTools s'ajoutent aux email_* par défaut. La longueur ne se règle pas ici mais sous Orkeon:Tools:ResultLimits (ci-dessous). Liée par AddOrkeonInfrastructure() et appliquée à chaque résultat d'outil par IToolInvocationPipeline.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Valeurs Sens
Policy énumération "Warn" None, Warn, Block La politique appliquée à un résultat d'outil réussi. Défaut Warn : le résultat arrive au modèle balisé comme donnée, et tout motif d'injection est journalisé et audité. Block retient un résultat qui porte un motif High ou Critical (le modèle en est informé) ; None laisse passer les résultats intacts et sans balise.
TrustedTools liste de chaînes ["email_accounts", "email_create_folder", "email_delete", "email_draft", "email_folders", "email_mark", "email_move", "email_parser", "email_read", "email_rename_folder", "email_save_attachment", "email_search", "email_send", "drive_read"] Outils dont les résultats contournent le filtrage. Par défaut les outils email_*, qui filtrent ce qu'ils lisent avec PromptInjectionDocumentValidator et le marquent eux-mêmes comme non fiable (ADR-012) — les baliser de nouveau empilerait deux enveloppes. Les entrées de la configuration s'ajoutent à celles-ci.

Security:Url

Validation SSRF. Liée par AddOrkeonInfrastructure() (IUrlValidator).

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
AllowedDomains liste de chaînes [] Si la liste n'est pas vide, seuls ces domaines (et leurs sous-domaines) sont autorisés.
AllowedSchemes liste de chaînes ["http", "https"] Schémas d'URL autorisés. Par défaut http et https.
BlockedDomains liste de chaînes [] Domaines (et leurs sous-domaines) explicitement bloqués.
BlockedPorts liste d'entiers [22, 23, 25, 110, 143, 445, 3306, 5432, 6379, 27017] Ports dont l'accès est bloqué (ports de services courants).
BlockPrivateIPs booléen true S'il faut bloquer les requêtes vers les plages d'adresses IP privées ou internes. Vrai par défaut.
ResolveDNS booléen true S'il faut résoudre le DNS et confronter l'adresse IP résolue aux plages privées. Vrai par défaut.

Security:Audit

Sinks d'audit. Liée par AddOrkeonInfrastructure().

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Valeurs Sens
AuditDirectory chaîne "./audit-logs" Répertoire où sont stockés les fichiers du journal d'audit.
Enabled booléen true Si la journalisation d'audit est activée.
EnabledCategories liste d'énumérations [] LlmCall, ToolExecution, FileAccess, HttpRequest, SecurityEvent, CrewLifecycle, AgentDecision, MemoryOperation, ConfigChange Catégories à journaliser. Vide signifie que toutes les catégories sont activées.
MinSeverity énumération "Info" Debug, Info, Warning, Error, Critical Niveau de sévérité minimal des événements journalisés.
RetentionDays entier 90 Nombre de jours de conservation des journaux d'audit.

Security:Vault

La chaîne de coffres à secrets. Liée par AddOrkeonInfrastructure().

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
AzureKeyVaultUri URI — URI d'Azure Key Vault (p. ex. https://my-vault.vault.azure.net/)
CacheTtl durée "00:05:00" Durée de vie du cache des secrets en mémoire (défaut : 5 min)
DpapiSecretsDirectory chaîne — Répertoire du magasin de secrets DPAPI (Windows seulement)
UseAwsSecretsManager booléen false S'il faut utiliser AWS Secrets Manager

Secrets

Secrets:<NOM> est le second maillon de la chaîne de secrets après ORKEON_<NOM> (ConfigurationSecretProvider), p. ex. Secrets:TAVILY_API_KEY pour web_search. Liée par AddOrkeonInfrastructure().

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
<nom> chaîne, secret — Un secret par son nom — Secrets:TAVILY_API_KEY —, là où la chaîne de secrets cherche après la variable d'environnement ORKEON_<NAME> et avant un coffre. Une valeur écrite ici est en clair dans le fichier de réglages.

Orkeon:Security:PermissionGate

La barrière par appel d'outil (ModePermissionGate). AddOrkeonPermissionGate(configuration) — appelé par RunnerHost — est sans effet tant que Enabled = true n'est pas posé.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
DefaultMode chaîne "default" Le mode de permission d'un agent d'une crew qui n'en déclare aucun (permissionMode:) : default, acceptEdits, bypassPermissions, plan ou dontAsk. Un script pose son propre mode à chaque act.
Enabled booléen false Si la barrière est enregistrée. Laissée à false, aucun appel d'outil n'y est soumis.
Interactive booléen false Si l'hôte tranche lui-même une approbation, sans canal d'approbation. Un hôte qui enregistre un canal (orkeon-repl le fait) interroge l'opérateur quoi que dise ce réglage. Laissée à false sans canal, un appel qui demande une approbation est refusé, et le modèle lit la raison comme résultat de l'outil.

Orkeon:Dlp

Politiques DLP et détection de PII. Opt-in : AddOrkeonDlp().

Lue par : un hôte écrit en C# seulement, par AddOrkeonDlp() — aucun binaire livré ne lit cette section.

Clé Type Défaut Valeurs Sens
ChannelPolicies:<nom> libre — Les surcharges de politique par canal.
DefaultAction énumération "Audit" Allow, Mask, Block, Audit L'action par défaut pour tous les canaux.
Enabled booléen true Si la DLP est activée globalement.

Outils

Ce que les outils d'un agent ont le droit de faire, et les serveurs et index qu'ils atteignent.

Orkeon:Tools:ResultLimits

La coupe d'un résultat d'outil et le parallélisme d'un lot d'appels. Limits associe un nom d'outil (insensible à la casse) au plus grand nombre de caractères de son résultat ; elle part de la table de AgentDefaults (shell_command : 10_000), chaque valeur vaut au moins 1, et un outil absent de la table garde sa borne AgentDefaults. MaxParallelToolCalls (défaut 4, au moins 1) est le plus grand nombre d'appels d'outils en lecture d'un même tour du modèle qui s'exécutent en même temps (appels parallèles).

Un résultat qui dépasse sa borne est coupé et se termine par un avis, N chars omitted. …, qui dit combien a été retranché. shell_command, son plafond de flux et job_tail lisent la même borne, de même que la coupe de repli de ctx.llm.act quand aucun pipeline n'en applique. Un outil qui a déjà coupé sa propre sortie (shell_command, avec son avis) marque le résultat comme déjà borné, et le pipeline ne le coupe pas une seconde fois. Le ResultBudget des outils Drive et Email est une borne distincte, hors de ce réglage.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
Limits:<nom> entier — La coupe en caractères, par nom d'outil (insensible à la casse).
MaxParallelToolCalls entier 4 Le plus grand nombre d'appels d'un même lot qui s'exécutent en même temps.

Orkeon:Tools:Shell

Ce que ShellCommandTool peut lancer, par la configuration seule (AddOrkeonCodeTools()) : AllowInterpreters autorise les interpréteurs et le git mutant (équivalent RCE ; l'avertissement SECURITY est journalisé une fois par hôte, au premier appel de shell_command, et dit le confinement en vigueur) ; ExtraAllowedCommands ajoute à l'allowlist et AllowedCommands la remplace en entier — le remplacement annule AllowInterpreters. Une commande hors de la liste par défaut en lecture seule (un interpréteur, une commande ajoutée, git une fois sa restriction levée) peut écrire : un chemin virtuel de sa ligne de commande et son répertoire de travail demandent tous les droits, si bien qu'un montage en lecture seule lui est refusé et reste lisible par les outils de fichiers. Confinement dit comment le système d'exploitation confine la session shell de l'agent : Mode = Auto (le défaut) choisit bubblewrap sous Linux, Seatbelt sous macOS, un AppContainer dans un Job Object sous Windows, et aucun confinement quand l'hôte tourne dans un conteneur ; None le coupe. Un backend qui ne peut pas tourner fait échouer l'appel, avec la raison, plutôt que de le lancer hors confinement. La ligne SECURITY des interpréteurs est journalisée une seule fois par hôte, à la validation du premier appel de shell_command une fois les interpréteurs activés, et dit le confinement en vigueur : le backend, ou none avec sa raison (un conteneur, Mode = None), ou unavailable quand chaque appel échoue ; un backend confinant dit aussi network on ou network off (d'après AllowNetwork) et, sous bubblewrap, system directories are read-only, alors que none dit toujours network on et ne prétend rien sur la lecture seule ; construire ou lister l'outil ne journalise rien. AllowNetwork ouvre le réseau (coupé par défaut) et ReadOnlyPaths prête une chaîne d'outils hors des répertoires système (Confinement du shell, limites). Environment:Propagate nomme des variables de l'hôte remises à la session shell et au bac à sable de code en plus de la liste blanche intégrée, comme HTTPS_PROXY quand le proxy ne demande aucun identifiant ; le bac à sable de code ne la lit que dans la configuration, si bien qu'une liste posée dans le code avec Configure<ShellToolOptions> n'atteint que le shell. Le filtre des secrets l'emporte : un nom qui commence par ORKEON_, contient KEY, TOKEN, SECRET, PASSWORD, PASSWD, PASS, CREDENTIAL ou AUTH, ou le mot PAT seul (sans casse), vide, ou qui porte = ou un NUL, ou dont la valeur porte des identifiants d'URL (http://user:password@proxy:3128, user:password@proxy:3128), est écarté avec un avertissement dans le journal qui ne cite jamais la valeur, et l'hôte démarre quand même ; un nom intégré (SSH_AUTH_SOCK, PATH) est ignoré. Les noms se comparent avec la casse, sauf sous Windows. Sous bubblewrap, une variable ajoutée passe quoi que dise AllowNetwork, et aucun chemin qu'elle nomme n'est monté dans la vue. Environment:SessionBus (coupé par défaut) remet à une session confinée le bus de session de l'opérateur, par lequel une commande peut sortir du bac à sable et lire le trousseau : l'hôte journalise un avertissement quand il est activé (le bus de session est sur option). Les chemins de la sortie reviennent virtuels : un chemin qui suit un guillemet ouvrant court jusqu'au guillemet fermant, espaces compris, et une base Windows (C:\proj) se reconnaît sans casse et avec / pour \ (c:\Proj, le C:/proj de git). WindowsPaths sert un programme Windows lancé sous WSL avec Confinement:Mode = None (cmd.exe, un dotnet.exe Windows) : par chemin virtuel, il donne l'écriture Windows de la base d'un montage (WindowsPaths:/workspace = C:\proj, ce qu'affiche wslpath -w) ; un montage qu'il ne nomme pas, sur un lecteur Windows (/mnt/c/proj), prend l'écriture de ce lecteur. Un tel programme reçoit ses chemins dans cette écriture, après le même contrôle de droits, et ce qu'il écrit dans cette écriture revient virtuel. Hors de WSL la clé n'est pas lue.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Valeurs Sens
AllowedCommands liste de chaînes [] Un remplacement complet de l'allowlist par défaut, tel quel ; il annule AllowInterpreters et rétablit la restriction de git à la lecture seule. Vide garde l'allowlist par défaut.
AllowInterpreters booléen false Active les interpréteurs (node, dotnet, npm, find) et les sous-commandes git qui modifient — équivalent à une RCE sur l'hôte, pour les hôtes d'agent de code de confiance seulement. Faux par défaut.
Confinement:AllowNetwork booléen false Laisse le processus confiné atteindre le réseau. Faux par défaut : il a son propre espace de noms réseau, avec la seule boucle locale.
Confinement:Mode énumération "Auto" None, Bubblewrap, Auto, Seatbelt, AppContainer Comment le processus est confiné. Auto (défaut) choisit le moteur de la plateforme : Bubblewrap sous Linux, Seatbelt sous macOS, AppContainer sous Windows, et aucun confinement quand l'hôte tourne dans un conteneur (le conteneur est la frontière). None lance le processus sur l'hôte, sous l'utilisateur de l'hôte. Bubblewrap le lance sous bwrap (Linux) : chaque montage lié à son chemin virtuel, en lecture seule quand il n'a pas Write, les répertoires système en lecture seule, rien d'autre de l'hôte, le réseau coupé. Quand le moteur est indisponible (autre OS, pas de bwrap, espaces de noms refusés), l'appel échoue avec la raison et la commande ne tourne pas.
Confinement:ReadOnlyPaths liste de chaînes [] Répertoires absolus de l'hôte liés en lecture seule à leur propre chemin, en plus des répertoires système (/usr, /bin, /sbin, /lib, /lib32, /lib64, /etc), pour un programme installé ailleurs, comme /opt/node ou un dossier .dotnet.
Environment:Propagate liste de chaînes [] Noms de variables supplémentaires propagés depuis l'environnement du runner, comme HTTPS_PROXY quand le proxy ne demande aucun identifiant. Un nom vide, qui contient = ou un NUL, commence par ORKEON_ ou contient KEY, TOKEN, SECRET, PASSWORD, PASSWD, PASS, CREDENTIAL ou AUTH ou le mot PAT seul (sans casse), ou dont la valeur porte des identifiants d'URL (http://user:password@proxy:3128, user:password@proxy:3128), est écarté avec un avertissement qui ne cite jamais la valeur ; un nom déjà intégré est ignoré. Les noms se comparent avec la casse, sauf sous Windows. Sous bubblewrap, la valeur passe quel que soit le réseau, mais aucun chemin qu'elle nomme n'est lié dans la vue. Le bac à sable de code ne lit cette liste que dans la configuration : une liste posée dans le code (Configure<ShellToolOptions>) n'atteint que le shell.
Environment:SessionBus booléen false Indique si une session shell confinée (bubblewrap, Seatbelt, AppContainer) reçoit le bus de session de l'opérateur : DBUS_SESSION_BUS_ADDRESS et, sous bubblewrap avec le réseau, son socket. Faux par défaut. Le bus permet à une commande de sortir du bac à sable (systemd-run --user) et de lire tous les secrets du trousseau (secret-tool) : l'activer est journalisé comme un avertissement. Une session non confinée et le bac à sable de code, qu'aucune prison ne retient, le reçoivent toujours.
ExtraAllowedCommands liste de chaînes [] Commandes ajoutées à l'allowlist par défaut (ou de remplacement), comme make.
WindowsPaths:<nom> chaîne — Sous WSL, l'écriture Windows de la base d'un montage, par chemin virtuel (WindowsPaths:/workspace = C:\proj), ce qu'un lanceur lit de wslpath -w. Un programme Windows lancé sous WSL reçoit ses chemins dans cette écriture, et ce qu'il y écrit revient virtuel. Un montage qu'elle ne nomme pas et dont la base est sur un lecteur Windows (/mnt/c/…) prend l'écriture de ce lecteur.

Orkeon:Tools:Email

Lié par AddOrkeonEmailTools(configuration) — l'hôte partagé des runners et orkeon-repl l'appellent — et validé paresseusement : un compte est validé la première fois qu'un outil ou une commande orkeon email s'en sert, tous ses problèmes signalés d'un coup, et une valeur que le binder ne sait même pas lire (un droit mal orthographié, un port en toutes lettres) met ce seul compte de côté au lieu de faire échouer l'hôte — une section cassée ne casse jamais un crew qui n'envoie pas de courrier. Les secrets n'y sont jamais des valeurs, seulement les noms des variables d'environnement qui les contiennent (Auth:PasswordEnvVar, Auth:ClientSecretEnvVar), lues comme l'est la variable que nomme ApiKeyEnvVar : dans l'environnement du processus, puis — sous Windows — dans la portée persistante de l'utilisateur (HKCU\Environment), où un client peut mémoriser un mot de passe ; lues, jamais recopiées dans le processus ; l'environnement du processus seul sous Linux et macOS (où une variable de secret est lue). Parcours par fournisseur et table clé par clé : Outils e-mail.

  • DefaultAccount — le compte qu'utilise un appel qui n'en nomme aucun (facultatif avec un seul compte).
  • CredentialsDirectory — le répertoire physique dont le sous-répertoire email contient les jetons OAuth ; un chemin relatif part du répertoire du fichier de réglages. Le runner le monte sur la racine interne /credentials quand un compte OAuth est déclaré ; par défaut : credentials à côté du fichier de réglages de l'utilisateur.
  • Screening:WithholdRejected — retenir le corps d'un message que le filtre anti-injection de prompt rejette (défaut false : signaler seulement).
  • Accounts:<nom> — un compte. Provider vaut Gmail, Outlook ou Custom (le défaut) ; Rights est obligatoire (Read, Organize, Draft, Send, Delete, Purge) ; Incoming:Security et Outgoing:Security valent SslOnConnect, StartTls ou None — ce dernier vers un hôte de bouclage seulement ; une liste Send:AllowedRecipients vide n'autorise personne. Le nom contient des lettres, des chiffres, ., _ et -, commence par une lettre ou un chiffre (64 au plus).

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Valeurs Sens
Accounts:<nom>:Address chaîne — L'adresse du compte ; aussi le From de chaque message qu'il envoie.
Accounts:<nom>:Auth:ClientId chaîne — Identifiant client OAuth (application Google Cloud ou Microsoft Entra).
Accounts:<nom>:Auth:ClientSecretEnvVar chaîne — Nom de la variable d'environnement qui contient le secret client OAuth (clients de bureau Google).
Accounts:<nom>:Auth:Method énumération — Password, OAuth2 Password ou OAuth2.
Accounts:<nom>:Auth:PasswordEnvVar chaîne — Nom de la variable d'environnement qui contient le mot de passe ou le mot de passe d'application.
Accounts:<nom>:Auth:Tenant chaîne — Tenant Microsoft : consumers (défaut), organizations, common ou un identifiant de tenant.
Accounts:<nom>:Auth:Username chaîne — Nom de connexion ; par défaut l'adresse.
Accounts:<nom>:DisplayName chaîne — Nom affiché, associé à Address dans From.
Accounts:<nom>:Incoming:Host chaîne — Nom d'hôte du serveur.
Accounts:<nom>:Incoming:Port entier — Port du serveur.
Accounts:<nom>:Incoming:Protocol énumération — Imap, Pop3, Graph Imap, Pop3 ou Graph ; le preset décide quand la clé est absente.
Accounts:<nom>:Incoming:Security énumération — SslOnConnect, StartTls, None Sécurité du transport.
Accounts:<nom>:Outgoing:Host chaîne — Nom d'hôte du serveur.
Accounts:<nom>:Outgoing:Port entier — Port du serveur.
Accounts:<nom>:Outgoing:Protocol énumération — Smtp, Graph Smtp ou Graph ; le preset décide quand la clé est absente.
Accounts:<nom>:Outgoing:Security énumération — SslOnConnect, StartTls, None Sécurité du transport.
Accounts:<nom>:Provider énumération "Custom" Custom, Gmail, Outlook Le preset : Gmail, Outlook ou Custom (le défaut).
Accounts:<nom>:Rights énumération "None" None, Read, Organize, Draft, Send, Delete, Purge Ce qu'un agent peut faire, p. ex. "Read, Organize, Draft". Obligatoire.
Accounts:<nom>:SaveSentCopy booléen — Si un message envoyé est ajouté au dossier des messages envoyés. Absente, la clé suit le preset : Gmail, Outlook et Graph classent eux-mêmes le courrier envoyé, un serveur personnalisé en général non.
Accounts:<nom>:Send:AllowedRecipients liste de chaînes [] Qui peut recevoir du courrier de ce compte : une adresse, *@domain, ou * pour tout le monde. Vide signifie personne : l'envoi est fermé tant qu'un opérateur ne l'ouvre pas.
Accounts:<nom>:Send:MaxPerHour entier — Nombre maximal de messages que ce processus envoie par heure depuis le compte. Absente, pas de plafond.
Accounts:<nom>:Send:MaxRecipients entier — Nombre maximal de destinataires d'un message. Absente, la limite est laissée au serveur.
Accounts:<nom>:TimeoutSeconds entier — Délai du protocole, en secondes. Absente, le défaut de la bibliothèque est gardé.
CredentialsDirectory chaîne — Répertoire physique qui contient les jetons OAuth, pour un hôte dont le répertoire de réglages par utilisateur n'est pas le bon (un compte de service). Lu par l'hôte, pas par les outils.
DefaultAccount chaîne — Le compte qu'utilise un appel quand il n'en nomme aucun. Facultatif avec un seul compte.
Screening:WithholdRejected booléen false À true, le corps d'un message que le détecteur d'injection de prompt rejette est retenu. Désactivé par défaut : le détecteur a été réglé sur des pages web, et les lettres d'information le déclenchent.

Orkeon:Tools:Drive

Lié par AddOrkeonDriveTools(configuration) — l'hôte partagé des runners et orkeon-repl l'appellent — et validé paresseusement, comme la section e-mail : un compte est validé la première fois qu'un outil ou une commande orkeon drive s'en sert, tous ses problèmes signalés d'un coup, et une valeur que le binder ne sait pas lire met ce seul compte de côté au lieu de faire échouer l'hôte. Chaque compte se connecte en OAuth2 ; le secret client qu'exige un compte Google n'y est jamais une valeur, seulement le nom de la variable qui le contient (Auth:ClientSecretEnvVar), lue comme celles de l'e-mail. Parcours et outils : Outils drive.

  • DefaultAccount — le compte qu'utilise un appel qui n'en nomme aucun (facultatif avec un seul compte).
  • CredentialsDirectory — le répertoire physique dont le sous-répertoire drive contient les jetons OAuth ; par défaut : credentials à côté du fichier de réglages de l'utilisateur. Le runner garde un seul répertoire de jetons : quand Orkeon:Tools:Email:CredentialsDirectory en nomme un autre, celui de l'e-mail l'emporte, et le runner le dit au démarrage.
  • Screening:WithholdRejected — retenir le texte d'un fichier que le filtre anti-injection de prompt rejette (défaut false : signaler seulement).
  • Accounts:<nom> — un compte. Provider (GoogleDrive ou OneDrive) et Rights (Read, Write, Organize, Share, Delete, Purge) sont obligatoires ; Root confine l'agent à un dossier du drive ; une liste Share:AllowedRecipients vide n'autorise personne, et les liens publics restent fermés tant que Share:AllowPublicLinks ne vaut pas true.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Valeurs Sens
Accounts:<nom>:Auth:ClientId chaîne — Identifiant client OAuth (application Google Cloud ou Microsoft Entra).
Accounts:<nom>:Auth:ClientSecretEnvVar chaîne — Nom de la variable d'environnement qui contient le secret client OAuth (clients de bureau Google).
Accounts:<nom>:Auth:Tenant chaîne — Tenant Microsoft : consumers (défaut), organizations, common ou un identifiant de tenant.
Accounts:<nom>:MaxUploadMegabytes entier 100 Le plus gros fichier qu'un agent peut déposer, en mégaoctets. Non renseigné : 100.
Accounts:<nom>:Provider énumération — GoogleDrive, OneDrive GoogleDrive ou OneDrive. Obligatoire.
Accounts:<nom>:Rights énumération "None" None, Read, Write, Organize, Share, Delete, Purge Ce qu'un agent peut faire, p. ex. "Read, Write, Organize". Obligatoire.
Accounts:<nom>:Root chaîne — Le dossier auquel l'agent est confiné, en chemin depuis la racine du drive (Orkeon/agents). Non renseigné : tout le drive.
Accounts:<nom>:Share:AllowedRecipients liste de chaînes [] Avec qui un agent peut partager : une adresse, *@domaine, ou * pour toute adresse. Vide signifie personne : le partage reste fermé tant qu'un opérateur ne l'ouvre pas.
Accounts:<nom>:Share:AllowPublicLinks booléen — Si un agent peut créer un lien que toute personne qui le détient peut ouvrir. Désactivé par défaut.
Accounts:<nom>:TimeoutSeconds entier — Délai HTTP, en secondes. Non renseigné : celui du client.
CredentialsDirectory chaîne — Répertoire physique qui contient les jetons OAuth, pour un hôte dont le répertoire de réglages de l'utilisateur ne convient pas (un compte de service). Lu par l'hôte, pas par les outils.
DefaultAccount chaîne — Le compte qu'utilise un appel quand il n'en nomme aucun. Facultatif avec un seul compte.
Screening:WithholdRejected booléen false Si vrai, le texte d'un fichier que le détecteur d'injection de prompt rejette est retenu. Désactivé par défaut, comme pour l'e-mail : le détecteur signale ; les droits et le dossier racine bornent l'agent.

Orkeon:Tools:GitHub

Lue une fois par AddOrkeonWebTools quand l'outil github est enregistré. Le jeton est la première valeur non vide parmi Token, la variable d'environnement que nomme TokenVariable (par défaut GITHUB_TOKEN), puis GH_TOKEN. Sans jeton, chaque appel est anonyme : les actions de lecture fonctionnent dans la limite de débit anonyme de GitHub, create_issue et create_pr sont refusées, et la description de l'outil dit où poser le jeton. Le jeton est masqué (***) dans les erreurs et les journaux de l'outil.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
Token chaîne, secret — Jeton d'accès personnel GitHub que l'outil envoie comme bearer. Le garder hors d'un fichier versionné (appsettings.local.json, ou plutôt la variable d'environnement). Non renseigné : la variable que nomme TokenVariable, puis GH_TOKEN.
TokenVariable chaîne "GITHUB_TOKEN" Nom de la variable d'environnement qui contient le jeton quand Token est vide ; GH_TOKEN est lue après elle.

Orkeon:Tools:Firefox

Lue une fois par AddOrkeonWebTools quand l'outil firefox est enregistré. L'outil pilote un Firefox à lui par WebDriver BiDi : le navigateur démarre à la première action d'une exécution d'agent, avec un dossier de profil qu'aucun autre navigateur n'utilise, garde sa page d'une action à la suivante et se ferme avec l'exécution — le profil est alors supprimé. Firefox lui-même n'est pas livré : c'est celui qui est installé sur la machine. La fenêtre est visible sauf si Headless vaut true ou si la machine n'a pas d'affichage. Ce que l'outil ne fait pas est listé dans Limitations connues.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Valeurs Sens
AllowedProfiles liste de chaînes [] Profils qu'un agent peut nommer avec l'argument profile, en plus de disposable et de Profile. Vide : un agent n'en nomme aucun autre. Un nom présent dans DeniedProfiles reste refusé.
CommandTimeoutSeconds entier 30 Secondes laissées à une commande du navigateur (un chargement de page, un script, un clic) pour répondre.
DeniedProfiles liste de chaînes [] Profils avec lesquels aucun navigateur ne démarre jamais, qu'un agent en nomme un ou que Profile le fasse : les profils personnels de l'opérateur, par exemple.
ExecutablePath chaîne — Chemin du programme Firefox, ou son nom sur le PATH. Non renseigné : firefox sur le PATH, puis le dossier d'installation habituel de la plateforme.
Headless booléen false true démarre Firefox sans fenêtre. Par défaut la fenêtre est visible ; sous Linux sans DISPLAY ni WAYLAND_DISPLAY, le navigateur démarre quand même sans fenêtre, et un avertissement le dit.
Lifetime énumération "Run" Run, Host Durée de vie d'un navigateur : Run (par défaut) le ferme avec l'exécution d'agent qui l'a démarré ; Host le garde ouvert, avec ses onglets et son profil, d'une exécution à la suivante, un navigateur par profil, jusqu'à close, la fermeture de la fenêtre par l'utilisateur ou l'arrêt de l'hôte. Casse ignorée.
MaxNodes entier 40 Nombre maximal de nœuds que liste une réponse de snapshot ou de find ; le reste se lit avec offset.
MaxTextLength entier 3000 Nombre maximal de caractères de texte de page que porte une réponse de read.
Profile chaîne — Profil avec lequel un navigateur démarre quand l'agent n'en nomme aucun : disposable (par défaut, un dossier neuf supprimé à la fermeture du navigateur), le nom d'un profil du Firefox installé sur l'hôte (profiles.ini), ou le chemin d'un dossier de profil. Un profil nommé est utilisé sur place, avec ses cookies et ses sessions, et jamais supprimé ; un profil qu'un autre Firefox tient ouvert est refusé.
ProfileRoot chaîne — Dossier sous lequel chaque navigateur reçoit son propre dossier de profil, supprimé à la fermeture du navigateur. Non renseigné : ~/snap/firefox/common/orkeon/profiles quand Firefox est un snap (un snap ne lit pas le dossier temporaire du système), sinon orkeon-firefox sous le dossier temporaire du système.
SharedInstance booléen false true partage un navigateur par profil entre les exécutions d'agents de l'hôte : chaque exécution y pilote ses propres onglets, et le navigateur se ferme quand la dernière exécution le quitte, sauf si Lifetime vaut Host. Par défaut, chaque exécution a son propre navigateur.
StartupTimeoutSeconds entier 30 Secondes laissées à Firefox pour démarrer et ouvrir son protocole distant.

MCP

Connexions client MCP (MCP:Servers:<nom>) et l'interrupteur MCP:Enabled. Aucun réglage ne démarre un serveur MCP : une clé que la section ne porte pas est refusée au démarrage comme toute clé inconnue. Lue par RunnerHost (orkeon run, orkeon-host, orkeon mcp serve) et par orkeon-repl (RunnerHost.RegisterMcp) dès que MCP:Servers déclare au moins un serveur et que MCP:Enabled n'est pas false — les serveurs sont connectés avant le chargement de la crew, par orkeon-host une fois au démarrage, avant son premier message, par orkeon-repl avant qu'il charge ses commandes scriptées, et par orkeon mcp serve avant qu'il serve ; les hôtes bibliothèque appellent AddOrkeonMcp(configuration) ou la surcharge AddOrkeonInfrastructure(configuration) — voir Intégration MCP.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Valeurs Sens
Enabled booléen true Si MCP est activé, tout simplement.
Servers:<nom>:Args liste de chaînes [] Arguments de ligne de commande du processus serveur.
Servers:<nom>:Auth:Audience chaîne — Audience (ressource) pour laquelle le jeton OAuth est émis, quand le fournisseur en demande une (oauth2-client-credentials, oauth2-device).
Servers:<nom>:Auth:ClientId chaîne — Identifiant du client OAuth (oauth2-client-credentials, oauth2-device).
Servers:<nom>:Auth:ClientSecretEnv chaîne — Nom de la variable d'environnement qui porte le secret du client OAuth : obligatoire pour oauth2-client-credentials, facultatif pour oauth2-device. Lue à chaque demande de jeton, jamais écrite dans les réglages.
Servers:<nom>:Auth:DeviceAuthorizationUrl URI — Adresse https du point de terminaison d'autorisation d'appareil du fournisseur (oauth2-device) ; http n'est accepté que sur la boucle locale.
Servers:<nom>:Auth:PasswordEnv chaîne — Nom de la variable d'environnement qui porte le mot de passe basic (Auth:Type Basic).
Servers:<nom>:Auth:Scopes liste de chaînes [] Portées OAuth demandées (oauth2-client-credentials, oauth2-device) ; aucune par défaut.
Servers:<nom>:Auth:TokenEnv chaîne — Nom de la variable d'environnement qui porte le jeton bearer (Auth:Type Bearer). Lue à chaque requête.
Servers:<nom>:Auth:TokenUrl URI — Adresse https du point de terminaison de jeton OAuth (oauth2-client-credentials, oauth2-device) ; http n'est accepté que sur la boucle locale.
Servers:<nom>:Auth:Type énumération "None" None, Bearer, Basic, OAuth2ClientCredentials, OAuth2Device Comment le client s'authentifie auprès d'un serveur HTTP (Sse), avec les clés que chaque valeur demande : None ; Bearer (TokenEnv) ; Basic (UserEnv, PasswordEnv) ; oauth2-client-credentials (TokenUrl, ClientId, ClientSecretEnv ; facultatifs Scopes, Audience) ; oauth2-device (TokenUrl, DeviceAuthorizationUrl, ClientId ; facultatifs ClientSecretEnv, Scopes, Audience ; refusé par orkeon-host, qui n'a pas de terminal). Graphies acceptées, exactement : None, none, Bearer, bearer, Basic, basic, OAuth2ClientCredentials, oauth2-client-credentials, OAuth2Device, oauth2-device ; toute autre est refusée. Aucun identifiant n'est écrit dans les réglages : ils sont lus dans les variables d'environnement que nomment les autres clés Auth.
Servers:<nom>:Auth:UserEnv chaîne — Nom de la variable d'environnement qui porte le nom d'utilisateur basic (Auth:Type Basic).
Servers:<nom>:CallTimeout durée "00:01:00" Durée maximale d'une requête à ce serveur : un appel d'outil se termine en erreur d'outil (McpCallTimeoutException), et prompts/list, prompts/get, resources/list, resources/read et un abonnement lèvent un dépassement de délai. 60 secondes par défaut ; une valeur non positive est refusée. Une connexion d'appareil due d'abord est hors de la borne.
Servers:<nom>:Command chaîne "" Commande qui lance le processus du serveur MCP (pour le transport stdio).
Servers:<nom>:ConnectTimeout durée "00:00:30" Durée maximale de la poignée de main et de la liste des outils de ce serveur avant l'échec de la connexion. 30 secondes par défaut ; une valeur non positive est refusée.
Servers:<nom>:Env:<nom> chaîne — Variables d'environnement du processus serveur.
Servers:<nom>:Headers:<nom> chaîne — En-tête HTTP supplémentaire envoyé à chaque requête vers un serveur Sse : une valeur littérale, ou env:VAR pour la lire dans une variable d'environnement. Un en-tête Authorization est refusé ; utilisez Auth. Les en-têtes que le transport pose lui-même (Accept, Content-Type, Mcp-Session-Id, MCP-Protocol-Version, Mcp-Method, Mcp-Name, Last-Event-ID) sont refusés aussi.
Servers:<nom>:Tools:Allow liste de chaînes [] Noms des outils de ce serveur à enregistrer ; vide, ils le sont tous.
Servers:<nom>:Tools:Deny liste de chaînes [] Noms des outils de ce serveur jamais enregistrés ; appliqué après Tools:Allow.
Servers:<nom>:Transport énumération "Stdio" Stdio, Sse Type de transport à utiliser.
Servers:<nom>:TrustAnnotations booléen false Si la permission gate prend au mot les annotations des outils de ce serveur : un outil marqué readOnlyHint devient alors une lecture, que le mode plan laisse passer. Désactivé par défaut : un serveur non fiable pourrait étiqueter en lecture seule un outil destructeur, ses outils restent donc classés en fail-closed.
Servers:<nom>:Url URI — URL du point d'accès pour le transport SSE. Avec des identifiants (un type Auth, ou un en-tête env:), elle doit être une adresse https absolue, http seulement sur la boucle locale, sinon le serveur est refusé à la configuration.

MCP:Server

La façon dont le serveur d'orkeon mcp serve se présente (des outils, plus les ressources de /output sous --expose-output et les prompts et outils de crew de --crew). Lue par AddOrkeonMcpServer, qu'appelle orkeon mcp serve.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
AllowedTools liste de chaînes [] Les outils du registre que le serveur liste et exécute, par nom (insensible à la casse) ; vide les sert tous. Un outil hors de la liste n'est ni listé ni appelable, quel que soit celui qui l'enregistre et quand : un outil qu'un serveur MCP ajoute plus tard reste dehors. Les outils qu'une extension sert (--crew) n'y sont pas soumis. orkeon mcp serve --tools le définit.
ExposeOutput booléen false Si le serveur sert /output comme ressources MCP en lecture seule (orkeon:///output/<chemin>). Désactivé par défaut : seuls les outils sont exposés. /workspace et tout autre montage ne le sont jamais. orkeon mcp serve --expose-output l'active.
MaxConcurrency entier 4 Nombre de requêtes que la boucle stdio exécute à la fois ; les autres attendent leur tour. Au moins 1. orkeon mcp serve --max-concurrency le remplace.
MaxResourceBytes entier 1048576 Taille du plus gros fichier que resources/read rend, en octets (1 048 576 par défaut) ; un fichier plus gros est refusé.
Name chaîne "Orkeon" Nom du serveur annoncé à l'initialisation MCP.
ResourcesPageSize entier 100 Nombre de ressources d'une page de resources/list (100 par défaut). Au moins 1.
Version chaîne "" Version du serveur annoncée dans le handshake et dans le _meta de l'ère moderne. Vide ou blanche (par défaut) : la version de la release Orkeon en cours d'exécution.

RaggableTree

Indexation de codebase : Enabled, et Embedding — rien d'autre : toute autre clé, un autre nom de fournisseur ou un nombre qui n'est pas entier fait échouer l'hôte au démarrage ; ce que couvre un index se règle à chaque appel index_codebase. Opt-out dans les hôtes runner : RunnerHost l'enregistre par défaut, RaggableTree:Enabled = false le désactive ; les consommateurs bibliothèque appellent AddRaggableTree(options) explicitement.

Lue par : orkeon, orkeon-host.

Clé Type Défaut Valeurs Sens
Embedding:ApiKey chaîne, secret — La clé d'un fournisseur distant. Le fournisseur local n'en a pas besoin.
Embedding:BaseUrl chaîne — L'adresse http:// ou https:// du point d'accès du fournisseur, quand ce n'est pas celle du fournisseur lui-même.
Embedding:Dimensions entier — La taille des vecteurs, pour un modèle qui la laisse choisir. Omise, celle du modèle.
Embedding:MaxTextChars entier — Le plus grand nombre de caractères d'un texte envoyé au modèle ; ce qui dépasse est coupé. Omise, la limite propre du fournisseur.
Embedding:Model chaîne — Le modèle d'embedding. Omis, le fournisseur utilise le sien — bge-micro-v2 pour le fournisseur local.
Embedding:Provider énumération "LocalSmartComponents" None, OpenAI, Ollama, Onnx, LocalSmartComponents Qui calcule les embeddings, sans tenir compte de la casse. Le défaut tourne sur la machine : pas de clé, pas de réseau.
Enabled booléen true Si l'index et ses outils sont enregistrés. false les laisse hors de l'hôte.

BRAVE_API_KEY

Aussi lue comme clé de configuration (pas seulement une variable d'environnement) pour conditionner l'outil Brave, par RunnerHost.

Lue par : orkeon, orkeon-host.

Clé Type Défaut Sens
BRAVE_API_KEY chaîne, secret — La clé de l'API Brave Search. Définie — ici ou dans la variable d'environnement du même nom —, elle enregistre l'outil brave_search ; absente, l'outil n'est pas proposé.

Orkeon:MultiModal

Validation de la vision et des contenus — aucune image n'est redimensionnée. Opt-in : AddOrkeonMultiModal(configuration).

Lue par : un hôte écrit en C# seulement, par AddOrkeonMultiModal() — aucun binaire livré ne lit cette section.

Clé Type Défaut Sens
Enabled booléen true Si les contenus multimodaux sont activés.
MaxAudioDurationSeconds entier 300 Durée audio maximale autorisée, en secondes (défaut : 300 secondes, soit 5 minutes).
MaxImageSizeBytes entier 20971520 Taille d'image maximale autorisée, en octets (défaut : 20 Mo).
SupportedAudioFormats liste de chaînes ["audio/wav", "audio/mp3", "audio/ogg"] Liste des types MIME audio pris en charge.
SupportedImageFormats liste de chaînes ["image/png", "image/jpeg", "image/gif", "image/webp"] Liste des types MIME d'image pris en charge.

Plugins

Découverte du répertoire de plugins. orkeon-repl charge les plugins quand la section est présente ; un autre hôte appelle AddOrkeonPlugins(fileSystem, configuration) — voir Plugins.

Lue par : orkeon-repl.

Clé Type Défaut Sens
ContinueOnError booléen false À true, un assembly de plugin qui échoue à se charger ou à configurer ses services est consigné dans IPluginRegistry.Failures et les candidats restants continuent de se charger. À false (défaut), le premier échec lève une PluginLoadException (échec immédiat).
Directory chaîne "/plugins" Chemin virtuel (VFS) du répertoire parcouru à la recherche d'assemblies de plugin. Doit commencer par / et se résoudre dans un montage configuré. Défaut : /plugins.
SearchPattern chaîne "*.dll" Motif glob simple appliqué aux noms de fichier des assemblies candidats (p. ex. *.dll, MyCompany.*.dll). Les candidats doivent en outre porter l'extension .dll, quel que soit le motif. Défaut : *.dll.
SharedAssemblyPrefixes liste de chaînes ["Orkeon.", "Orkeon.Rag.Abstractions", "Microsoft.Extensions."] Préfixes de noms simples d'assemblies qui ne sont jamais chargés dans l'AssemblyLoadContext isolé du plugin ; la résolution s'en remet au contexte de l'hôte (par défaut), si bien que les types de contrat (p. ex. IOrkeonPlugin, IBaseTool, IServiceCollection) gardent une identité unique, partagée entre l'hôte et le plugin. Défauts : Orkeon., Orkeon.Rag.Abstractions et Microsoft.Extensions..

Orchestration et persistance

Comment une crew se construit et décide, et ce qui est gardé de son exécution.

Orkeon:CrewFactory

StrictTools fait échouer le chargement d'une crew sur un nom d'outil inconnu (les runners le mettent à true par défaut). Lue par RunnerHost → CrewFactoryOptions.

Lue par : orkeon, orkeon-host.

Clé Type Défaut Sens
StrictTools booléen true Si un outil qu'une crew nomme et que le registre ne contient pas fait échouer le chargement de la crew, en listant les noms inconnus et ceux qui sont disponibles. false écarte l'outil avec un avertissement — le comportement tolérant de la bibliothèque, que les hôtes livrés désactivent.

Orkeon:Consensus

Le vote du mode consensuel — les modes et ce qu'est un bulletin sont dans Types de processus. Enregistré par AddOrkeonInfrastructure() ; la section gouverne le comportement.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Valeurs Sens
EnableDiscussion booléen true Si des tours de discussion ont lieu quand le consensus n'est pas atteint. Pendant la discussion, les agents reçoivent le contexte des résultats des autres agents.
FallbackStrategy énumération "AcceptBestScore" AcceptBestScore, Fail, ManagerDecision La stratégie de repli quand le consensus ne peut être atteint.
MaxVotingRounds entier 3 Le nombre maximal de tours de vote avant d'appliquer le repli. Un tour fait travailler chaque agent sur la tâche, puis recueille un bulletin par agent.
RoleWeights:<nom> nombre — Les poids par rôle pour le vote par consensus pondéré. La clé est le rôle de l'agent, la valeur le multiplicateur de poids.
VotingOptions:AllowAbstention booléen true Si l'abstention est permise. À true (le défaut), une abstention ne compte que pour le quorum. À false, une abstention compte comme un vote contre chaque choix : elle reste au dénominateur de chaque part, et elle rompt l'unanimité. Un décompte de Borda, qui n'a pas de seuil de part, n'atteint alors aucun consensus tant que quelqu'un s'abstient.
VotingOptions:ConsensusThreshold nombre 66.7 Le seuil de consensus, en pourcentage. Utilisé par les types SuperMajority et WeightedConsensus.
VotingOptions:ConsensusType énumération "Majority" Majority, SuperMajority, Unanimity, WeightedConsensus, BordaCount Le type de consensus à utiliser.
VotingOptions:QuorumPercent nombre 50 Le quorum, en pourcentage : la part minimale de bulletins exprimés parmi tous les bulletins. En dessous, aucun consensus n'est atteint, quoi que disent les bulletins exprimés.
VotingOptions:UseWeightedVotes booléen false S'il faut utiliser des votes pondérés.

Orkeon:ExecutionState:Persistence

Persistance durable des états d'exécution d'une crew (ScopedCrewExecutionStateManager). Opt-in : AddCrewExecutionStatePersistence(configuration) — appelé automatiquement par AddOrkeonInfrastructure(configuration) quand la section existe, et par orkeon run et orkeon-host ; requiert un IStateStore (Orkeon:Checkpointing).

Lue par : orkeon, orkeon-host.

Clé Type Défaut Sens
DeleteFromStoreOnArchive booléen false À true, archiver une exécution (à son achèvement ou au nettoyage d'expiration) supprime aussi son entrée persistée du state store. Défaut : false — le dernier instantané est gardé dans le store pour que les requêtes d'état continuent de répondre une fois l'entrée en mémoire évincée.
Enabled booléen false Active la persistance durable des états d'exécution. Défaut : false (en mémoire seulement, identique au comportement historique).

Orkeon:Checkpointing

Le magasin qui garde les sessions de checkpoint des runs : Enabled avec Store memory, json, sqlite ou postgres (CheckpointingExtensions). orkeon run et orkeon-host la lisent : json et sqlite écrivent sous ./.orkeon/state, monté en /state comme montage interne (Path est un chemin virtuel dessous) ; sqlite avec une ConnectionString et postgres n'ont besoin d'aucun montage. Un hôte écrit en C# l'enregistre avec AddOrkeonCheckpointing(configuration), AddOrkeonSqliteCheckpointing(...) ou AddOrkeonPostgresCheckpointing(configuration).

Lue par : orkeon, orkeon-host.

Clé Type Défaut Valeurs Sens
AutoMigrate booléen true S'il faut créer automatiquement le schéma et les tables PostgreSQL au premier usage.
ConnectionString chaîne, secret — La chaîne de connexion du magasin Sqlite (à la place de Path) ou Postgres.
Enabled booléen false Si le magasin nommé par Store est utilisé (défaut : false, le magasin en mémoire).
MaxHistoryPerSession entier 1000 Le nombre maximal d'entrées de version par session dans le magasin PostgreSQL.
MaxVersions entier 20 Le nombre de versions qu'une session garde dans le magasin Json (défaut : 20) ; chaque nouvelle version supprime les plus anciennes au-delà. Zéro ou négatif les garde toutes.
Path chaîne — Le chemin virtuel du dossier (Json) ou du fichier (Sqlite) où le magasin écrit, sous le montage /state. Null : /state/checkpoints ou /state/checkpoints.db.
SchemaName chaîne "orkeon" Le nom du schéma PostgreSQL (défaut : "orkeon").
Store énumération "Memory" Memory, Json, Sqlite, Postgres Le magasin (défaut : Memory).

Orkeon:HumanInput

Comment un run se met en pause sur une question à un humain. Actif seulement avec Orkeon:Checkpointing:Enabled, qui donne à la question une session où être persistée. Pause vaut Hold (le run attend la réponse, jusqu'à HoldTimeout, puis suspend : la question reste persistée, rien n'est refusé) ou Suspend (le run s'arrête aussitôt : run.finished status: waiting_for_input, sortie 75). Sans valeur, un run qui a quelqu'un à interroger attend, un orkeon run simple sans personne suspend, et orkeon-host et --events attendent (30 minutes et sans limite). Un run se reprend avec orkeon run <crew> --resume <id> --input "...".

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Valeurs Sens
HoldTimeout durée — Combien de temps un run en attente patiente avant de suspendre (la question reste persistée, rien n'est refusé). Sans valeur, l'hôte décide : 30 minutes dans le démon, sans limite sous --events.
Pause énumération — Hold, Suspend La politique. Sans valeur, l'hôte décide : Hold dans le démon et sous --events, Suspend dans un orkeon run simple.

Orkeon:RunHistory

Si les événements d'un run sont gardés après sa fin : Enabled active l'historique, Store vaut jsonl (un fichier <run id>.jsonl par run et un index.jsonl) ou sqlite (runs.db, WAL). orkeon-host et le gabarit de orkeon init l'activent ; la bibliothèque et orkeon run le laissent éteint. Un run est enregistré avec ou sans --events. Les secrets sont masqués avant l'écriture, et le dossier garde ce que les runs ont dit et fait : à tenir hors d'un dépôt (orkeon init ajoute .orkeon/ au .gitignore). Le dossier est ./.orkeon/runs, monté en /runs comme montage interne à côté de l'état des checkpoints (Path est un chemin virtuel dessous) ; orkeon runs list, show et tail le relisent. Une purge applique RetentionDays et MaxRuns quand un processus écrit pour la première fois et à la fin d'un run, jamais quand l'historique est seulement lu ; un run en cours n'est jamais purgé, un run dont le processus a disparu (orphaned) l'est. Les événements llm.delta restent sur le flux stdout et ne sont gardés dans l'historique qu'avec IncludeDeltas.

Lue par : orkeon, orkeon-host.

Clé Type Défaut Valeurs Sens
Enabled booléen false Si l'historique est enregistré. Éteint dans la bibliothèque, allumé dans orkeon-host et le gabarit de orkeon init.
IncludeDeltas booléen false Si les événements llm.delta (jeton par jeton, verbeux) sont gardés dans l'historique. Ils restent toujours sur le flux stdout.
MaxRuns entier 1000 Au plus ce nombre de runs sont gardés, les plus anciens purgés d'abord ; 0 les garde tous.
Path chaîne "/runs" Un chemin virtuel (il commence par « / »), sous le montage /runs ; le fichier Sqlite est runs.db dedans.
RetentionDays entier 30 Les runs plus vieux que ce nombre de jours sont purgés, au démarrage et à la fin d'un run ; 0 les garde pour toujours.
Store énumération "Jsonl" Jsonl, Sqlite Le magasin : jsonl (défaut) ou sqlite.

Scripts et console

Le sandbox des scripts .ork.ts, la toolchain esbuild, et la console interactive.

Orkeon:Scripting:AgentInstances

Les plafonds de transcription des instances d'agent d'un équipage.

Lue par : orkeon-repl.

Clé Type Défaut Sens
MaxTranscriptCharacters entier 32000 Nombre maximal de caractères (somme des contenus des messages) que garde la transcription d'une instance d'agent ; les plus anciens messages partent d'abord. Supérieur à zéro. Défaut : 32000.
MaxTranscriptMessages entier 40 Nombre maximal de messages que garde la transcription d'une instance d'agent ; les plus anciens partent d'abord. Supérieur à zéro. Défaut : 40.

Orkeon:Scripting:AgentMemory

La mémoire durable derrière ctx.memory.agent.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
RootDirectory chaîne "/workspace/.orkeon/agent-memory" Répertoire racine des fichiers derrière ctx.memory.agent, un fichier JSON par projet et par agent. Ne doit pas être vide. Défaut : /workspace/.orkeon/agent-memory.

Orkeon:Scripting:Limits

Le sandbox Jint de chaque moteur de script (Orkeon.Scripting) : environ 100 Mo de mémoire, une profondeur de récursion de 64 et 30 s par défaut.

Lue par : orkeon, orkeon-host.

Clé Type Défaut Sens
ExecutionTimeout durée "00:00:30" Durée maximale, en temps réel, pendant laquelle le moteur peut tourner, au total — le temps passé à attendre un outil ou un modèle compte ; le temps que le contrôle des permissions met à décider, un opérateur qui répond à une demande d'approbation, ne compte pas. Défaut : 30 secondes, un plafond pour des scripts de provenance inconnue ; un run long de confiance le relève.
MemoryLimitBytes entier 104857600 Mémoire maximale que le script peut allouer sur le thread du moteur pendant un run, en octets — une fenêtre par run (remise à zéro au démarrage du run), pas comptée depuis la création du moteur ; ce qu'alloue l'appel d'un outil de l'hôte n'est pas compté. Défaut : 100 Mo, un plafond pour des scripts de provenance inconnue ; un run de confiance qui en demande plus le relève.
PromiseTimeout durée — Combien de temps un hôte qui attend la promesse d'un script lui laisse avant que l'attente soit rejetée, sans que le script voie ce rejet. Défaut : aucune valeur, soit les dix secondes du moteur ; une valeur négative (-00:00:00.001) laisse l'annulation comme seule limite, ce qu'il faut à une commande scriptée puisqu'elle attend un modèle ou un opérateur.
RecursionLimit entier 64 Profondeur de récursion maximale avant que le moteur ne lève une erreur. Défaut : 64 : elle arrête une récursion emballée bien avant le débordement de la pile .NET et laisse de la place à une logique de script légitimement imbriquée. Un script de confiance peut la relever.

Orkeon:Scripting:Toolchain

Résolution de la toolchain esbuild : EsbuildPath vient en premier dans l'ordre de recherche. Lue par le transpileur esbuild (IScriptTranspiler) d'orkeon run, le runner partagé, orkeon doctor, orkeon forge, les commandes *.cmd.ts. orkeon doctor juge son contrôle tsc selon TypeCheck : un tsc introuvable est ok (optionnel) sous Off et Validate, et fail sous Always (son contrôle tsc).

Lue par : orkeon, orkeon-host.

Clé Type Défaut Valeurs Sens
EsbuildPath chaîne — Chemin absolu du binaire esbuild. À null, le transpileur se rabat sur la variable d'environnement ORKEON_ESBUILD_PATH, puis sur un binaire livré à côté de l'application (esbuild-bin/esbuild), puis sur la copie que npm install dépose dans une copie de travail du dépôt (tools/scripting-esbuild/node_modules/, cherchée en remontant depuis le répertoire de travail et le répertoire de l'application), puis sur une recherche dans le PATH.
EsbuildTimeout durée "00:00:30" Temps maximal dont dispose esbuild pour transpiler une source. Défaut : 30 s.
TscPath chaîne — Chemin absolu du binaire tsc. Renseigné, c'est le seul candidat : un chemin relatif, ou qui n'existe pas, est signalé comme un compilateur absent, jamais résolu depuis le répertoire de travail ni remplacé en silence. À null, le vérificateur de types cherche dans tools/scripting-typecheck/node_modules/.bin/ au-dessus du répertoire de l'application, puis dans PATH ; jamais dans le répertoire de travail. Comme EsbuildPath, il peut venir de l'appsettings.json posé à côté de la crew : ce fichier a la confiance de la crew elle-même.
TypeCheck énumération "Validate" Off, Validate, Always Quand le compilateur TypeScript (tsc) vérifie les types d'un script .ork.ts contre les typings que ce build livre : Off jamais, Validate (défaut) dans orkeon run --validate, Always dans --validate et avant chaque exécution. Sous Validate un compilateur absent est un avertissement ; sous Always c'est un échec. orkeon doctor juge aussi son contrôle tsc selon ce mode : un tsc introuvable est ok sous Off et Validate et fail sous Always ; un TscPath qui n'existe pas est ok sous Off, warn sous Validate et fail sous Always ; un tsc qui ne répond pas à --version est ok sous Off et warn sinon.
TypeCheckTimeout durée "00:01:00" Temps maximal dont dispose tsc pour vérifier un script. Défaut : 60 s.

Orkeon:Cli:ScriptCommands

Découverte des commandes CLI TypeScript (Orkeon.Cli.Commands.Scripting), et sous Limits un profil de sandbox plus strict que celui des scripts.

Lue par : orkeon-repl.

Clé Type Défaut Sens
ContinueOnConflict booléen true À false, deux scripts qui déclarent le même nom de commande sont une erreur fatale au démarrage.
Directories liste de chaînes [] Chemins virtuels parcourus à la recherche de *.cmd.ts. Le premier répertoire l'emporte en cas de conflit.
Enabled booléen true Interrupteur principal. False ⇒ la découverte est sautée, le registre est vide.
EsbuildTranspile booléen true À false, *.cmd.js seulement (pas de transpilation TS). Pour le test et le débogage ; la production le laisse à true.
FailFastOnInvalidScript booléen false À true, le premier script invalide interrompt le chargeur (à utiliser en CI).
FallbackCommandName chaîne "assistant" Nom de la commande scriptée qui traite le texte libre (une ligne du REPL sans préfixe /). Dans la surface de l'agent de code, c'est l'assistant interactif relié à la crew main-loop. Vide ou inconnu ⇒ le texte libre donne le message de commande inconnue au lieu d'être routé.
Limits:ExecutionTimeout durée "00:05:00" Délai strict d'une invocation de commande. Défaut : 5 minutes.
Limits:MemoryLimitBytes entier 67108864 Plafond de mémoire en octets. Défaut : 64 Mo (profil CLI, spec §8.1).
Limits:RecursionLimit entier 100 Plafond de profondeur de récursion. Défaut : 100 (hérité de la spec §8.1 — le même que le plafond global).
MaxChainDepth entier 8 Profondeur maximale d'une chaîne de commandes asynchrones lancées depuis des gestionnaires terminés. 8 par défaut.
MaxScripts entier 200 Plafond strict du nombre de fichiers *.cmd.ts que le chargeur garde ; au-delà, les fichiers suivants, dans l'ordre des chemins, sont ignorés avec un avertissement. 200 par défaut : au-dessus d'un vrai jeu de commandes.

Orkeon:Cli:ScriptHost

Résolution des crews <nom>/crew.ork.ts (ScriptHostFacade).

Lue par : orkeon-repl.

Clé Type Défaut Sens
CrewDirectories liste de chaînes [] Répertoires virtuels sous lesquels vivent les crews, en <dir>/<name>/crew.ork.ts. La résolution essaie chaque répertoire dans l'ordre ; le premier qui correspond l'emporte.
CrewFileName chaîne "crew.ork.ts" Le nom du fichier d'entrée de la crew, résolu sous chaque <dir>/<name>/.
RunCrewTimeout durée "00:10:00" Borne supérieure d'un appel synchrone script-host.runCrew. Quand elle expire, le script appelant reçoit une TimeoutException claire, le run abandonné est annulé de façon coopérative, et le fil du moteur ou du REPL est toujours libéré. Défaut : 10 minutes — généreux à dessein, puisque runCrew est fait pour des crews courtes (les workflows longs passent par le cycle de tickets de runCrewAsync). Zéro ou une valeur négative désactive la borne.

Orkeon:Cli:ConsoleStreaming

Deltas ctx.llm.act streamés sur la console REPL (AddLlmConsoleStreaming(configuration, enabledByDefault)).

Lue par : orkeon-repl.

Clé Type Défaut Sens
Enabled booléen false Si chaque morceau d'une réponse est écrit sur la console à mesure que le modèle l'envoie, au lieu de la réponse entière à la fin. La REPL l'active quand la clé est absente ; un crew exécuté le garde désactivé.

Orkeon:Cli:Memory

La mémoire typée derrière memory_store (FileCategoryMemoryStore) : un memory.json par projet, sous le même slug de projet que le fichier de session. Le REPL active Persist quand la clé est absente.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
Persist booléen false Indique si la mémoire typée (memory_store : entrées user, project, feedback et reference) est conservée par projet sous RootDirectory et relue au démarrage suivant. Désactivé sauf si l'hôte l'active ; le REPL l'active quand le réglage est absent. Désactivé, les entrées vivent en mémoire et meurent avec le processus.
RootDirectory chaîne "/workspace/.orkeon/memory" Répertoire virtuel qui contient un memory.json par projet, dans le dossier de projet des sessions.

Orkeon:Cli:Session

La fenêtre de contexte utilisée par token_budget (TokenBudgetTool) et le TUI.

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Sens
ContextWindowTokens entier — La fenêtre de contexte du modèle, en tokens : un nombre supérieur à zéro. Absente, elle vaut 200000.
Persist booléen false Indique si la session (messages, état, identifiant et titre) est conservée par projet sous SessionsDirectory. Désactivé sauf si l'hôte l'active ; le REPL l'active quand le réglage est absent. Tant qu'il est actif, un *.cmd.ts l'enregistre tout de suite (ctx.services.get("session").save(), ou save(path) pour en garder une copie ailleurs) ou charge à sa place une autre session enregistrée (load(path)).
SessionsDirectory chaîne "/workspace/.orkeon/sessions" Dossier virtuel qui contient un dossier de session conservée par projet.
StartScript chaîne — Chemin virtuel d'un script exécuté une fois au démarrage du REPL : un .ork.ts passe par l'hôte de scripts, tout autre fichier s'exécute comme un script shell. Sa sortie et sa source sont transmises au premier tour ; un script qui échoue ne bloque jamais le démarrage. Absent, aucun script ne s'exécute.

Orkeon:Cli:Tui

Les verbes du spinner du TUI.

Lue par : orkeon-repl.

Clé Type Défaut Valeurs Sens
SpinnerVerbs liste de chaînes [] Les verbes que la ligne d'état fait défiler pendant que le modèle travaille ("Thinking", "Reading"…). Omise ou vide, la liste propre de la console.
Theme énumération — Dark, Light, None La palette de la console au démarrage : Dark, Light ou None (les couleurs du terminal). Omise : None si NO_COLOR est défini, sinon Dark.

Hôte de service et A2A

Le démon orkeon-host, son canal de discussion, et le protocole A2A — voir Hôte de service.

Orkeon:Host

Le démon (Orkeon.Host) :

  • Crews:<i> — chaque crew hébergée : Name (unique, sans tenir compte de la casse), Path, Profile:MaxConcurrentRuns (runs de chat et A2A comptés ensemble), Mounts (l'espace de montages propre à la crew) et Description (ce que la compétence A2A de la crew dit qu'elle fait).
  • RunTimeout, ShutdownGracePeriod.
  • LlmProfiles — la liste blanche des Llm:Profiles que les crews hébergées peuvent nommer — leurs agents, tâches et managers — et Orkeon:Rag:LlmProfile aussi ; absente, tous sont offerts, ["default"] n'offre que le défaut ; une entrée qui nomme un profil non défini, ou un profil RAG que la liste écarte, refuse le démarrage.
  • A2A — le serveur A2A, éteint par défaut : Host vaut http://localhost, et http://+ écoute sur toutes les interfaces ; Crews liste les crews que d'autres agents peuvent lancer, par nom — une compétence chacune, une tâche étant un run de cette crew ; aucune par défaut. Une section activée qui n'expose aucune crew ou une crew que Crews ne déclare pas, un Host ou un Port mal formé, ou une écoute au-delà de la boucle locale alors que A2A:Security ne déclare ni schéma d'authentification ni mTLS refuse le démarrage — voir Hôte de service.

Lue par : orkeon-host.

Clé Type Défaut Sens
A2A:Crews liste de chaînes [] Les crews hébergées que d'autres agents peuvent lancer, par nom — une compétence chacune. Aucune par défaut.
A2A:Enabled booléen false Sert les crews exposées en A2A. Éteint, l'hôte n'écoute sur aucun port.
A2A:Host chaîne "http://localhost" Le schéma et le nom d'hôte de l'écoute : http://localhost par défaut, http://+ pour toutes les interfaces. Ni port (c'est Port) ni chemin.
A2A:Port entier 5002 Le port de l'écoute.
Api:Enabled booléen false Sert l'API. Désactivée, le host n'écoute aucun port pour elle.
Api:IdempotencyMaxKeys entier 10000 Le plus de clés d'idempotence tenues en mémoire ; les plus anciennes terminées partent d'abord.
Api:IdempotencyTtl durée "1.00:00:00" Combien de temps une clé d'idempotence est retenue. Passé ce délai, la même clé démarre un nouveau run.
Api:MaxEventStreams entier 64 Le plus de flux d'événements (GET /runs/{id}/events) servis à la fois. Au-delà, un flux est refusé par un 503 too_many_streams avec un Retry-After : chaque flux tient une connexion et interroge l'historique.
Api:Prefix chaîne "http://localhost:5190/" Le préfixe du HttpListener : schéma, hôte, port et une barre oblique finale. Un hôte que la boucle locale ne contient pas (http://+:5190/) exige un schéma d'authentification ou le TLS mutuel sous Security.
Api:ReadinessCacheTtl durée "00:00:03" Combien de temps une réponse de /readyz est réutilisée avant que les contrôles ne tournent de nouveau. La disponibilité atteint le magasin d'état et l'historique : une boucle de sondes ou un client hostile ne doit pas faire de chaque requête ce travail. Zéro lance les contrôles à chaque fois.
Api:ReadinessTags liste de chaînes [] Tags de health checks ajoutés à la disponibilité en plus de ready. llm ajoute le contrôle du fournisseur LLM, qui joint un service externe : absent par défaut, pour qu'une panne de fournisseur ne sorte pas le daemon de la rotation.
Api:Security:AllowedAuthSchemes liste de chaînes [] Schémas d'authentification acceptés : Bearer et/ou ApiKey. Vide, aucune authentification n'est exigée. Chaque schéma déclaré est validé, pas seulement reconnu (voir A2ACredentialValidator).
Api:Security:ApiKeySecretNames liste de chaînes [] Noms des secrets qui détiennent les clés d'API que le schéma ApiKey accepte, lus par l'ISecretProvider à chaque requête.
Api:Security:RequireMutualTls booléen false Si un certificat client remontant à une ancre de confiance est exigé (fermé par défaut sans ancre).
Api:Security:TrustedCertificateAuthorities liste de chaînes [] Chemins des certificats d'autorité auxquels un certificat client doit remonter quand le TLS mutuel est exigé.
Api:Security:TrustedClientCertificateThumbprints liste de chaînes [] Empreintes de certificats clients épinglés exactement (toujours refusés hors de leur période de validité).
Api:SseKeepAliveInterval durée "00:00:15" Combien de temps un flux d'événements silencieux attend avant d'écrire une trame de maintien (un commentaire SSE, une ligne vide en NDJSON). L'écriture remarque un client parti : un flux abandonné s'achève au lieu de durer autant que le run.
Crews:<i>:Description chaîne — Ce que fait la crew, en une phrase : la description de sa compétence sur la carte d'agent A2A quand Orkeon:Host:A2A l'expose. Lue dans la configuration, jamais dans la définition de la crew — la carte se construit sans charger de crew. Facultative.
Crews:<i>:Mounts liste de chaînes [] Les dossiers que cet hôte accorde à CETTE crew, sous forme de chaînes de montage (<physical>:<virtual>:<rights>) : un espace de montages propre à chaque run, si bien que deux crews hébergées peuvent toutes deux adresser /output sur deux dossiers différents. Vide (le défaut) garde les montages de l'hôte pour cette crew. Un dossier accordé est une entrée du démon : lisible où qu'il se trouve, sans --allow-external-mounts.
Crews:<i>:Name chaîne "" Le nom par lequel les canaux et l'opérateur la désignent.
Crews:<i>:Path chaîne "" Chemin de la définition de la crew — un fichier YAML, un répertoire de crew multi-fichiers ou un script .ork.ts. Les mêmes cibles qu'accepte orkeon run.
Crews:<i>:Profile:MaxConcurrentRuns entier 4 Combien de runs de cette crew peuvent être en cours à la fois. Borné à dessein : un démon qui accepte un nombre illimité de runs simultanés est un démon qui meurt à sa première rafale.
LlmProfiles liste de chaînes [] Les profils LLM (Llm:Profiles:<nom>) que les crews hébergées peuvent nommer. Le service lance des crews qu'il ne contrôle pas : absente, tout profil que définit la configuration est offert ; présente, seuls ceux de la liste — une crew qui en nomme un autre échoue à se charger, et le run avec elle. Le profil par défaut (la section Llm) est toujours offert, donc ["default"] n'offre que lui. Chaque entrée doit nommer un profil défini.
RunTimeout durée "00:30:00" Combien de temps un run peut durer avant que l'hôte ne l'annule. Un démon n'a pas d'utilisateur qui le regarde pour presser Ctrl-C : un run sans borne est un démon bloqué. L'horloge s'arrête tant que le run attend la réponse d'une personne : c'est le délai d'attente de la question, et non celui-ci, qui borne cette attente.
ShutdownGracePeriod durée "00:00:20" Combien de temps l'hôte attend les runs en cours à l'arrêt avant d'abandonner. Systemd envoie SIGKILL après son propre délai : celui-ci doit rester en dessous.

Orkeon:Host:Discord

Le canal Discord. Routes associe un identifiant de salon Discord à un nom de crew : un fil ouvert dans ce salon démarre cette crew ; DefaultCrew est la crew qu'atteint un salon sans route, la première crew déclarée si absent. Une route vers une crew non déclarée, une clé de route qui n'est pas un identifiant de salon ou un DefaultCrew inconnu refusent le démarrage.

Lue par : orkeon-host.

Clé Type Défaut Sens
AllowedUserIds liste de chaînes [] Identifiants des utilisateurs Discord autorisés à parler au bot. Vide refuse tout le monde — un bot sur un serveur public, porte ouverte, dépense le budget d'API de quelqu'un pour des inconnus.
DefaultCrew chaîne — La crew qu'atteint un salon sans route. Absente, c'est la première crew déclarée sous Orkeon:Host:Crews ; présente, elle doit nommer l'une d'elles.
Enabled booléen false Si le canal est allumé. Éteint tant qu'un déploiement ne dit pas le contraire.
GuildIds liste de chaînes [] Identifiants des guildes (serveurs) où enregistrer les commandes slash. Vide les enregistre globalement, ce qui ne demande aucune configuration mais reste en cache chez Discord jusqu'à une heure ; nommer des guildes rend /status et /stop disponibles immédiatement — la boucle de développement.
ProgressInterval durée "00:00:02" L'espacement des mises à jour de progression. La limite de débit de Discord est par salon et sans indulgence ; un message par pensée d'agent l'épuiserait en une seule crew.
Routes:<nom> chaîne — Quelle crew atteint chaque salon : un identifiant de salon Discord (le salon où s'ouvrent les fils) associé au nom d'une crew hébergée. Un fil ouvert dans un salon routé démarre cette crew ; un fil ouvert ailleurs démarre DefaultCrew. Une route vers une crew que l'hôte ne déclare pas, ou une clé qui n'est pas un identifiant de salon, refuse le démarrage.
TokenEnvironmentVariable chaîne "ORKEON_DISCORD_TOKEN" Nom de la variable d'environnement qui contient le jeton du bot.

A2A

Serveur et client A2A ; EnableServer enregistre aussi le service hébergé qui démarre le serveur avec l'hôte générique. Opt-in : AddOrkeonA2A(configuration). orkeon-host y lit l'identité de la carte et A2A:Security, et refuse EnableServer, Host et Port au démarrage — son écoute est Orkeon:Host:A2A, plus haut ; voir Conformité A2A.

Lue par : orkeon-host.

Clé Type Défaut Sens
AgentDescription chaîne "Orkeon A2A Agent" La description de l'agent annoncée dans la carte d'agent.
AgentName chaîne "Orkeon" Le nom de l'agent annoncé dans la carte d'agent.
AgentVersion chaîne "" La version de l'agent annoncée dans la carte d'agent. Vide (par défaut) : la version de la release Orkeon en cours d'exécution.
ContactUrl URI — URL de contact du champ fournisseur de la carte d'agent.
EnableServer booléen false S'il faut lancer un serveur A2A qui expose les agents locaux à la soumission de tâches distantes : enregistre IA2AServer et un service hébergé qui le démarre avec l'hôte.
Host chaîne "http://localhost" L'hôte ou le préfixe du serveur HTTP A2A (p. ex. "http://localhost").
Organization chaîne — Nom de l'organisation du champ fournisseur de la carte d'agent.
Port entier 5002 Le port sur lequel écoute le serveur HTTP A2A.
TimeoutSeconds entier 30 Délai, en secondes, des requêtes HTTP sortantes vers les agents distants.

A2A:Security

TLS mutuel et authentification des points d'accès A2A : chaque schéma d'AllowedAuthSchemes (Bearer, ApiKey) exige son validateur, sinon le serveur refuse de démarrer ; ApiKeySecretNames sont les noms des secrets qui portent les clés acceptées, lus via ISecretProvider ; côté client, ClientCredentialSecretName est le secret qu'A2AClient envoie en Authorization. Même opt-in qu'A2A — voir Sécurité.

Lue par : orkeon-host.

Clé Type Défaut Sens
AllowedAuthSchemes liste de chaînes [] Schémas d'authentification que le serveur accepte sur ses points d'accès de tâches : Bearer et/ou ApiKey. Vide signifie qu'aucune authentification n'est requise. Chaque schéma déclaré est validé, pas seulement reconnu (A2ACredentialValidator) : un jeton bearer par un IAuthenticationProvider enregistré (A2A:Security:AzureAD / A2A:Security:Oidc), une clé d'API contre ApiKeySecretNames. Le serveur refuse de démarrer quand un schéma déclaré n'a pas de validateur.
ApiKeySecretNames liste de chaînes [] Noms des secrets qui portent les clés d'API qu'accepte le schéma ApiKey (Authorization: ApiKey <key>). Chaque nom est lu par l'ISecretProvider à chaque requête — ORKEON_<NAME> avec la chaîne par défaut — si bien que les clés ne résident jamais dans le fichier de configuration et tournent sans redémarrage.
ClientAuthScheme chaîne — Côté client : le schéma de l'identifiant que le client envoie à chaque appel de tâche (Authorization: <scheme> <credential>) — Bearer ou ApiKey, en accord avec ce que le pair déclare dans ses AllowedAuthSchemes. Vide signifie que le client n'envoie pas d'en-tête Authorization. La découverte de la carte d'agent ne le porte jamais.
ClientCertificatePassword chaîne, secret — Mot de passe de la clé privée du certificat client.
ClientCertificatePath chaîne — Chemin du fichier de certificat client pour l'authentification mTLS.
ClientCredentialSecretName chaîne — Côté client : nom du secret qui porte l'identifiant envoyé avec ClientAuthScheme, lu par l'ISecretProvider à chaque appel (ORKEON_<NAME> avec la chaîne par défaut), si bien qu'il ne réside jamais dans le fichier de configuration et tourne sans redémarrage. Un appel échoue avant toute requête quand il ne peut pas être lu.
RequireMutualTls booléen false Si le mTLS est requis pour la communication de serveur à serveur. Activé, le serveur exige un certificat client qui se rattache à l'une des TrustedCertificateAuthorities ou correspond à l'une des TrustedClientCertificateThumbprints ; démarrer le serveur sans aucune ancre de confiance configurée lève une erreur (fermé par défaut) — la simple présence d'un certificat en cours de validité n'est pas une authentification.
TrustedCertificateAuthorities liste de chaînes [] Liste des chemins de certificats d'autorités de certification de confiance. Côté client : quand elle est définie, seuls les serveurs présentant un certificat signé par ces AC sont de confiance (épinglage d'une AC privée). Côté serveur : quand RequireMutualTls est activé, les certificats clients entrants doivent se rattacher à l'une de ces AC (sauf épinglage par TrustedClientCertificateThumbprints).
TrustedClientCertificateThumbprints liste de chaînes [] Empreintes (hexadécimales, insensibles à la casse) des certificats clients acceptés par le serveur quand RequireMutualTls est activé — un épinglage exact, vérifié avant la validation de chaîne des TrustedCertificateAuthorities. Un certificat épinglé reste rejeté hors de sa période de validité.

A2A:Security:AzureAD

Le validateur Azure AD des jetons bearer.

Lue par : orkeon-host.

Clé Type Défaut Sens
Authority chaîne "" URL de l'autorité (p. ex. https://login.microsoftonline.com/{tenantId}/v2.0).
ClientId chaîne "" Identifiant d'application (client) enregistré dans Azure AD.
TenantId chaîne "" Identifiant du tenant Azure AD.
ValidAudiences liste de chaînes [] Audiences valides pour la validation des jetons.
ValidIssuers liste de chaînes [] Émetteurs de jetons valides. Par défaut les émetteurs Azure AD standard du tenant.

A2A:Security:Oidc

Le validateur OIDC générique des jetons bearer.

Lue par : orkeon-host.

Clé Type Défaut Sens
Authority chaîne "" URL de l'autorité OIDC (p. ex. https://login.example.com/realms/myapp).
ClientId chaîne "" Identifiant client enregistré auprès du fournisseur OIDC.
RequireHttpsMetadata booléen true S'il faut exiger HTTPS pour le point d'accès des métadonnées. Vrai par défaut.
ValidAudiences liste de chaînes [] Audiences valides pour la validation des jetons.

Observabilité

Journaux, traces et métriques.

Logging

La configuration de journalisation de .NET. Un niveau vaut Trace, Debug, Information, Warning, Error, Critical ou None, sans tenir compte de la casse ; la section reste ouverte au-delà de ses niveaux (plus haut).

Lue par : orkeon, orkeon-host, orkeon-repl.

Clé Type Défaut Valeurs Sens
Console libre — La section propre du journaliseur console : son LogLevel par catégorie, FormatterName, FormatterOptions et les autres clés du journaliseur console de .NET.
LogLevel:<nom> énumération — Trace, Debug, Information, Warning, Error, Critical, None Le niveau le plus bas journalisé, par catégorie : Default pour toute catégorie sans ligne à elle, un espace de noms comme Orkeon.Infrastructure pour ce qu'il journalise. Un niveau qui n'en est pas un refuse le démarrage, en nommant la clé.

Telemetry

Export OpenTelemetry. OtlpEndpoint est une adresse http:// ou https://, refusée par sa clé sinon ; la variable standard OTEL_EXPORTER_OTLP_ENDPOINT marche aussi dans les runners. Lue par AddOrkeonTelemetry(configuration) — appelé par AddOrkeonInfrastructure(configuration) et RunnerHost.

Lue par : orkeon, orkeon-host.

Clé Type Défaut Sens
Enabled booléen true Si la télémétrie est activée. Vrai par défaut.
MaxMemoryMB entier 2048 Le seuil de mémoire maximal, en Mo, des contrôles de santé. 2048 Mo par défaut.
OtlpEndpoint chaîne — Le point d'accès de l'exportateur OTLP (OpenTelemetry Protocol). Quand il est défini, les traces et les métriques y sont exportées. Exemple : "http://localhost:4317" pour gRPC ou "http://localhost:4318" pour HTTP.

Orkeon:Monitoring

Le backend de monitoring. Opt-in : AddOrkeonMonitoring(configuration).

Lue par : un hôte écrit en C# seulement, par AddOrkeonMonitoring() — aucun binaire livré ne lit cette section.

Clé Type Défaut Sens
MaxTraceHistory entier 1000 Nombre maximal de traces terminées gardées dans le tampon circulaire. Les traces les plus anciennes sont évincées quand cette limite est atteinte.
MetricsRetentionMinutes entier 60 Nombre de minutes de conservation des métriques détaillées.
TraceSourcePrefix chaîne "Orkeon" Préfixe des noms de sources d'activité dont les traces sont capturées. Par défaut toutes les sources Orkeon ; resserrez-le pour observer un seul sous-système — ou, dans un test, sur un nom que rien d'autre n'émet, puisque l'écouteur vaut pour tout le processus et capterait sinon une activité sans rapport.

Variables d'environnement

Trois sortes de variables d'environnement atteignent Orkeon : celles qui portent un réglage, celles qu'un binaire lit par leur nom, et celles qu'un réglage nomme. orkeon settings env imprime les trois mêmes listes dans le terminal, hors ligne (CLI).

Les variables qui portent un réglage

Tout réglage de cette page peut venir de l'environnement plutôt que du fichier : la variable est le chemin du réglage, __ entre ses niveaux. L'ordre des couches, la règle sur la casse et les deux orthographes qu'un réglage a sous Linux et macOS sont dans D'où viennent les réglages.

Variable Ce qu'elle est Où elle se place
ORKEON_<Section>__<Clé> Tout réglage, par son chemin : ORKEON_Llm__Model est Llm:Model, ORKEON_RateLimiting__MaxConcurrentRequests est RateLimiting:MaxConcurrentRequests, ORKEON_Orkeon__Rag__Profile est Orkeon:Rag:Profile. ORKEON_Llm__ApiKey est la variable qu'orkeon init propose pour la clé du modèle par défaut. Par-dessus le fichier de réglages : la variable l'emporte.
<Section>__<Clé> Le même réglage sans le préfixe : Llm__Model. Sous le fichier de réglages : le fichier l'emporte.
ORKEON_<NOM> Un secret, par son nom : ORKEON_TAVILY_API_KEY est la clé de web_search, ORKEON_OPENAI_API_KEY celle d'image_generation. Le premier maillon de la chaîne des secrets, avant Secrets:<NOM> dans le fichier.

Une variable du tableau suivant qui commence par ORKEON_ passe aussi par cette couche, comme une clé qu'aucun réglage n'est — ORKEON_DEBUG est la clé DEBUG de la racine. La racine de la configuration reste ouverte (plus haut) : elle ne refuse rien.

Les variables qu'un binaire lit par leur nom

Ce ne sont pas des réglages : aucune clé de cette page n'en tient lieu, et le binaire nommé lit la variable lui-même. La liste est celle que porte le code — un test y tient ce tableau.

Variable Lue par Valeur Effet
ORKEON_ALLOW_EXTERNAL_MOUNTS orkeon, orkeon-repl 1, true ou yes Vaut --allow-external-mounts pour chaque orkeon run, chaque orkeon rag et orkeon-repl : un --mount peut désigner un dossier hors du répertoire courant. Un déploiement en bac à sable la pose une fois, sa propre frontière tenant lieu d'isolation.
ORKEON_DEBUG orkeon 1, true ou yes Une erreur inattendue imprime son exception — la chaîne des types et la pile — au lieu d'une ligne.
ORKEON_MCP_SERVE orkeon posée par orkeon mcp serve, jamais à la main Marque chaque processus que lance orkeon mcp serve. Sous elle, orkeon mcp serve refuse de démarrer : des réglages qui le rangent parmi leurs propres serveurs MCP ne peuvent pas le lancer en boucle.
ORKEON_ESBUILD_PATH orkeon, orkeon-host, orkeon-repl le chemin d'un exécutable esbuild Où un script .ork.ts trouve esbuild, après Orkeon:Scripting:Toolchain:EsbuildPath et avant la copie livrée à côté du binaire. Les lanceurs d'une installation la posent sur l'esbuild qu'ils livrent quand elle est absente.
ORKEON_LLM_API_KEY orkeon une clé d'API La variable où orkeon llm probe et orkeon llm models lisent la clé quand --api-key-env n'en nomme pas d'autre.
BRAVE_API_KEY orkeon, orkeon-host une clé d'API Brave Search Inscrit l'outil brave_search. Elle est lue d'abord comme une clé de configuration : le fichier de réglages et ORKEON_BRAVE_API_KEY la donnent aussi.
ORKEON_DISCORD_TOKEN orkeon-host un jeton de bot Discord Le jeton du canal Discord : le défaut de Orkeon:Host:Discord:TokenEnvironmentVariable, qui peut nommer une autre variable.
OLLAMA_BASE_URL orkeon, orkeon-host, orkeon-repl l'adresse d'un serveur Ollama L'adresse que prend le fournisseur Ollama quand on ne lui en donne aucune : Llm:BaseUrl l'emporte, et http://localhost:11434 est ce qui reste sans l'une ni l'autre.
TUI_DRIVER orkeon-repl windows, dotnet ou ansi Le pilote Terminal.Gui des interfaces texte, pour le diagnostic. Absente : windows sous Windows, dotnet ailleurs — ansi ne dessine rien sous WSL ni dans bien des terminaux de conteneur.
TUI_DIAG orkeon-repl 1 La console à deux volets écrit des lignes [tui-diag] sur stderr pendant son démarrage : le terminal, le pilote choisi.
OTEL_EXPORTER_OTLP_ENDPOINT orkeon, orkeon-host l'adresse d'un collecteur OTLP Active l'export OpenTelemetry quand Telemetry:OtlpEndpoint est vide ; l'exportateur lit lui-même l'adresse, et les autres variables OTEL_EXPORTER_OTLP_*.
XDG_CONFIG_HOME orkeon, orkeon-host, orkeon-repl un dossier, par son chemin absolu Sous Linux et macOS, la racine des réglages par utilisateur — $XDG_CONFIG_HOME/Orkeon/appsettings.json, ~/.config quand elle est absente — et des unités systemd utilisateur qu'installe orkeon forge schedule.
CI orkeon-repl true Aucune interface texte ne s'ouvre : orkeon-repl se replie sur sa console simple.
TERM orkeon-repl un type de terminal Sous Linux, absente ou vide, elle a l'effet de CI=true : il n'y a pas de terminal où dessiner.

Transmises, pas lues. L'outil shell_command remet à la commande qu'il lance une liste fixe de variables de l'hôte — PATH, HOME, la locale, les dossiers temporaires, DOTNET_ROOT, NUGET_PACKAGES, les quatre qui donnent son identité à un commit (GIT_AUTHOR_NAME, GIT_AUTHOR_EMAIL, GIT_COMMITTER_NAME, GIT_COMMITTER_EMAIL : un nom et une adresse, qu'un conteneur n'a aucun ~/.gitconfig où lire, pas plus qu'une session confinée, dont le HOME est un dossier qui lui est propre sous bubblewrap, Seatbelt ou AppContainer) et ce qu'il faut à Windows pour lancer un programme —, plus les trois qui nomment une socket de la session de l'opérateur : DBUS_SESSION_BUS_ADDRESS, XDG_RUNTIME_DIR (le trousseau que lit un assistant d'identifiants comme gh auth git-credential) et SSH_AUTH_SOCK (l'agent ssh). Elles portent une adresse, pas un secret, mais le bus permet à une commande de sortir d'un bac à sable et de lire le trousseau : une session confinée ne reçoit DBUS_SESSION_BUS_ADDRESS que si Orkeon:Tools:Shell:Environment:SessionBus vaut true, et sous bubblewrap les sockets ne suivent que si Confinement:AllowNetwork vaut true (sécurité). Le bac à sable de code bâtit un environnement plus réduit encore, les trois sockets comprises. Tous deux ajoutent les noms de Orkeon:Tools:Shell:Environment:Propagate qui passent son filtre des secrets. Ni l'un ni l'autre ne les lit comme des réglages, et aucune clé ne passe par là — OPENAI_API_KEY, ORKEON_* et toute autre variable restent derrière. PATH est aussi l'endroit où un script .ork.ts cherche esbuild en dernier ; HOME est lue quand le système ne nomme aucun dossier de profil, pour placer les réglages par utilisateur. Les variables écrites sous MCP:Servers:<nom>:Env sont celles de l'opérateur : Orkeon les remet au serveur qu'il lance et n'en lit aucune. L'image de conteneur a ses propres variables, lues par son script d'entrée et non par les binaires — ORKEON_ENTRYPOINT et ses voisines (trois façons de lancer Orkeon).

Les variables qu'un réglage nomme

Une clé qui finit par EnvVar ou EnvironmentVariable porte le nom d'une variable, jamais une valeur : le secret reste hors du fichier. orkeon settings <clé> décrit chacune.

Clé Ce que porte la variable qu'elle nomme Lue où
Llm:ApiKeyEnvVar La clé d'API du modèle par défaut, lue quand aucun Llm:ApiKey n'est résolu (la clé d'API). L'environnement du processus, puis les variables de l'utilisateur sous Windows.
Llm:Profiles:<nom>:ApiKeyEnvVar La clé d'API de ce profil, lue de la même façon. L'environnement du processus, puis les variables de l'utilisateur sous Windows.
Orkeon:Tools:Email:Accounts:<nom>:Auth:PasswordEnvVar Le mot de passe, ou mot de passe d'application, du compte e-mail. L'environnement du processus, puis les variables de l'utilisateur sous Windows.
Orkeon:Tools:Email:Accounts:<nom>:Auth:ClientSecretEnvVar Le secret client OAuth du compte e-mail. L'environnement du processus, puis les variables de l'utilisateur sous Windows.
Orkeon:Tools:Drive:Accounts:<nom>:Auth:ClientSecretEnvVar Le secret client OAuth du compte Google Drive. L'environnement du processus, puis les variables de l'utilisateur sous Windows.
Orkeon:TypeSafe:ApiKeyEnvVar La clé du modèle de décision TypeSafe ; la clé nomme TYPESAFE_API_KEY quand rien ne la règle. L'environnement du processus, puis les variables de l'utilisateur sous Windows.
Orkeon:Liquid:ApiKeyEnvVar La clé du modèle de décision Liquid ; la clé nomme LIQUID_API_KEY quand rien ne la règle. L'environnement du processus, puis les variables de l'utilisateur sous Windows.
Orkeon:Kev:ApiKeyEnvVar La clé facultative du modèle de décision Kev ; la clé nomme KEV_API_KEY quand rien ne la règle. L'environnement du processus, puis les variables de l'utilisateur sous Windows.
Orkeon:Embeddings:ApiKeyEnvVar La clé d'API du provider d'embeddings mistral, azure-openai ou gemini, lue quand Orkeon:Embeddings:ApiKey n'est pas réglée. L'environnement du processus.
Orkeon:Rag:WebFallback:ApiKeyEnvVar La clé de la recherche web sur laquelle le RAG correctif se replie ; vide, aucune clé n'est envoyée. L'environnement du processus.
Orkeon:Host:Discord:TokenEnvironmentVariable Le jeton de bot du canal Discord ; la clé nomme ORKEON_DISCORD_TOKEN quand rien ne la règle. L'environnement du processus.

La variable conventionnelle de chaque fournisseur — OPENAI_API_KEY, ANTHROPIC_API_KEY, … — est un nom à écrire dans ApiKeyEnvVar : Clés d'API : la variable par fournisseur.


Voir aussi : Sous-systèmes opt-in · Hébergement · Système de mémoire · Pipeline RAG · Retour à l'index