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 :
- Un
appsettings.jsonrésolu — chaîne de résolution (RunnerSettings.ResolveSettingsPath) :--settings <chemin>explicite →appsettings.jsonà côté de la config de crew →appsettings/appsettings.jsonen remontant l'arborescence (examples/appsettings/appsettings.jsondans ce dépôt) → la config globale par utilisateur écrite parorkeon init. Aucun fichier trouvé ⇒ variables d'environnement uniquement. - Les variables d'environnement préfixées
ORKEON_(AddEnvironmentVariables("ORKEON_"), pour chaque hôte et pourorkeon doctor). Mapping .NET standard :__sépare les niveaux —ORKEON_Llm__ApiKeysurchargeLlm:ApiKey,ORKEON_Orkeon__Rag__ProfilesurchargeOrkeon: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__apikeyetORKEON_Llm:ApiKeyvalent tousLlm: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. - Les surcharges CLI de montage — chaque argument
--mountdevient une entrée mémoireOrkeon:FileSystem:Mounts:<i>(précédence maximale), placée par racine virtuelle : un--mountsur 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--mountsur une racine neuve est ajouté après le plus haut index déclaré. Le montage/crew(ou/script) du runner et lesInternalMountssont 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 blocmounts: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-replplace ses arguments--mountde 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, unOrkeon:Sqlite:TableNamequ'on ne peut pas donner à SQLite). La sectionLlmest lue aussi strictement que ses profils : unTimeoutSecondsde"600s"est refusé,Thinking:EnabledetGrammarvalenttrueoufalse, et uneTemperatureest un nombre fini —NaN,Infinityou1e400(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 enNaNou en infini sans un mot. Un niveau deLoggingest l'un deTrace,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 sousOrkeon:et sous les groupesOrkeon:Cli,Orkeon:Tools,Orkeon:Scripting,Orkeon:SecurityetSecuritydoit ê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__APIKEYestLlm: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:ProvideretOrkeon:Rag:Provider, avec ce qu'il faut au fournisseur nommé (Orkeon:LanceDb:Endpointpourlancedb;Orkeon:Pinecone:ApiKeyetIndexName, ouHost, pourpinecone) ;Orkeon:Rag:Profile; lesRerank:Kind,QueryTransform:Mode,Context:OrderingetIngestion:DefaultChunkingStrategydes options RAG effectives — profil plus surcharges, si bien qu'un hôte sans le reranker ONNX refusebalancedetqualityen nommantonnx;Orkeon:Rag:QueryRouting:Classifier;Orkeon:Embeddings:Provider;RaggableTree:Embedding:Provider. LememoryProvider:d'une crew YAML est vérifié à son chargement. - Un identifiant de modèle vide : une entrée de
Llm:ModelCapabilitiesnommée""ou" ", ou:Vision(une clé sans identifiant avant son champ), quoi qu'elle contienne, est refusée avecLlm: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.
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 :
orkeonest le CLI —orkeon runsous toutes ses formes et tout verbe qui construit l'hôte des runners (--validate,--list-tools,mcp serve, la forge,rag,email) —,orkeon-hostl'hôte de service,orkeon-replla 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 :
QueueLimitsousRateLimitingest le réglageRateLimiting:QueueLimit—"RateLimiting": { "QueueLimit": 5 }dans le fichier,ORKEON_RateLimiting__QueueLimitdans 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 …, oulibrepour une valeur que son lecteur prend telle qu'elle est écrite.secretmarque 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é.
ApiKeyEnvVarnomme 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.ApiKeyest la clé en clair — déconseillé. Temperature. Omise, rien n'est envoyé et le modèle applique la sienne — souvent 1 ; écrivez0.7pour une température modérée.Thinking:Enabled,Thinking:Effortconcernent 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é.AvailableModelsest la liste de modèles qu'une commande REPL scriptée/modelpeut proposer (tableau de chaînes, ou une chaîne séparée par des virgules), lue parAddOrkeonSessionTools(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 :
- Une clé que la configuration résout :
ApiKeydans le fichier,ORKEON_Llm__ApiKey(ORKEON_Llm__Profiles__<id>__ApiKeypour 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. - 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. - 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 lellm_overridede 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 parWithAgentFrameworkAgent—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 dullm_overrided'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 blocllm: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
llmet juge d'évaluation — sur le profil que nommeOrkeon: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'
Evaluationet 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.WithPlanningLlmgarde 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,adaptiveoucorrective; toute cléOrkeon:Ragsurcharge 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, classifieurllm, juge d'évaluation ; absent oudefault: 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 --offlinel'ignore.Provider— TYPE du provider du document store RAG (RagStoreOptions— un alias de type deMemoryProviderFactory), connecté depuis la section propre de ce provider (Orkeon:Redis,Orkeon:Sqlite, …) ; défaut : l'IMemoryProviderambiant.Collection— la collection qu'interrogerag_searchquand l'agent n'en nomme aucune (non définie :default) ;rag_evall'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 (ordreedgesanti-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 estOrkeon: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épertoireemailcontient les jetons OAuth ; un chemin relatif part du répertoire du fichier de réglages. Le runner le monte sur la racine interne/credentialsquand 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éfautfalse: signaler seulement).Accounts:<nom>— un compte.ProvidervautGmail,OutlookouCustom(le défaut) ;Rightsest obligatoire (Read, Organize, Draft, Send, Delete, Purge) ;Incoming:SecurityetOutgoing:SecurityvalentSslOnConnect,StartTlsouNone— ce dernier vers un hôte de bouclage seulement ; une listeSend:AllowedRecipientsvide 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épertoiredrivecontient 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 : quandOrkeon:Tools:Email:CredentialsDirectoryen 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éfautfalse: signaler seulement).Accounts:<nom>— un compte.Provider(GoogleDriveouOneDrive) etRights(Read, Write, Organize, Share, Delete, Purge) sont obligatoires ;Rootconfine l'agent à un dossier du drive ; une listeShare:AllowedRecipientsvide n'autorise personne, et les liens publics restent fermés tant queShare:AllowPublicLinksne vaut pastrue.
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) etDescription(ce que la compétence A2A de la crew dit qu'elle fait).RunTimeout,ShutdownGracePeriod.LlmProfiles— la liste blanche desLlm:Profilesque les crews hébergées peuvent nommer — leurs agents, tâches et managers — etOrkeon:Rag:LlmProfileaussi ; 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 :Hostvauthttp://localhost, ethttp://+écoute sur toutes les interfaces ;Crewsliste 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 queCrewsne déclare pas, unHostou unPortmal formé, ou une écoute au-delà de la boucle locale alors queA2A:Securityne 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