Table of Contents

🇬🇧 English version

Comportements par défaut (et comment les remplacer)

Voir aussi : Bootstrap et exécution · Sous-systèmes opt-in · Limites et contraintes · Retour à l'index

Les défauts DI d'Orkeon suivent un principe : aucune magie implicite. Rien n'appelle un LLM que vous n'avez pas configuré, rien ne persiste là où vous n'avez pas pointé, et chaque défaut délibérément minimal s'annonce par un Warning unique qui nomme le geste de remédiation. Cette page est l'inventaire de ces défauts — ce que chacun fait, comment il signale qu'il est actif, et le geste exact pour le remplacer.

La plupart des enregistrements ci-dessous utilisent TryAdd : enregistrer votre propre implémentation avant AddOrkeonApplication() / AddOrkeonInfrastructure() gagne, sans autre changement. Les exceptions sont signalées dans leur ligne — un service enregistré inconditionnellement (AddScoped/AddSingleton) se remplace en enregistrant le vôtre après l'appel Orkeon.

Les défauts qui avertissent au premier usage

Service Défaut Ce qu'il fait réellement Le remplacer par
IKnowledgeStore un store en mémoire Store in-memory fonctionnel (store/retrieve/delete réels, rien ne persiste) — mais SearchAsync ignore la requête et retourne les premières entrées stockées. Activer le sous-système RAG (AddOrkeonRag(configuration)) et utiliser son ingestion/récupération, ou enregistrer votre propre store.
ILlmCache aucun cache Un cache qui rate toujours — change le coût, pas la justesse. services.AddSingleton<ILlmCache, VotreCache>();
IMemorySystem un système de mémoire en mémoire Vraie implémentation en mémoire — correcte, juste pas persistante. Configurer un provider persistant (Memory:Provider).
IAgentSelectionService (FirstFit) premier venu Prend le premier agent disponible — le repli sûr explicite. Passer OrkeonApplicationOptions.AgentSelectionStrategy à Skill (lexical) ou Embedding (sémantique — exige un vrai fournisseur d'embeddings), via AddOrkeonApplication(o => …) ou services.Configure<OrkeonApplicationOptions>(…).
IEmbeddingProvider chaîne de résolution BGE local (quand AddOrkeonLocalEmbeddings() est enregistré) → fournisseur distant via Orkeon:Embeddings → fail-fast au premier usage avec une exception actionnable. Jamais de repli hash silencieux. Une crew memory: true s'en sert dès son kickoff : sans lui, cette crew est refusée avant sa première tâche. Enregistrer AddOrkeonLocalEmbeddings() ou configurer Orkeon:Embeddings.

IAgentExecutionService n'est volontairement pas dans cette liste : AddOrkeonApplication() enregistre le vrai AgentExecutionService inconditionnellement (AddScoped). Le stub interne qui rend des résultats vides ne gagne que dans un conteneur câblé avec AddOrkeonInfrastructure() seul (son enregistrement est TryAddScoped). Pour substituer le vôtre dans un bootstrap standard, enregistrez-le après AddOrkeonApplication().

Deux services n'ont aucun défaut qui fonctionne. Aucun IFileSystemService n'est enregistré par l'un ou l'autre appel : AddOrkeonFileSystem(configuration), avec au moins un montage sous Orkeon:FileSystem:Mounts, est requis avant de charger une crew — le chargeur YAML, les outils fichier et les livrables lisent et écrivent tous à travers lui. Et aucun modèle n'est enregistré : un conteneur qui n'en a pas échoue à sa première résolution LLM, en nommant le service manquant — enregistrez le vôtre avec AddOrkeonLlmProvider(...) (voir Bootstrap). La CLI orkeon, orkeon-host et orkeon-repl se comportent autrement : sans section Llm, ils tournent sur le fournisseur écho et le signalent. Une crew planning: true y saute alors son plan, avec un avertissement : le fournisseur écho renvoie son prompt, il n'y a rien avec quoi planifier.

Les défauts véritablement silencieux

Inoffensifs par construction, ils restent en Debug ou n'émettent rien :

Service Défaut Pourquoi le silence convient
Callbacks step/task Null*Callback Hooks d'observabilité no-op ; Debug par conception.
IMemoryScope NullMemoryScope Marqueur explicite « pas de mémoire dans ce contexte » — demandé, pas subi.
IMemoryProvider factory pilotée par la config Le provider in-memory quand Memory:Provider est absent ; un type non reconnu refuse le démarrage de l'hôte.

Les défauts TryAdd pleinement fonctionnels (p. ex. IPathValidator → PathValidator) ne sont volontairement pas listés ici : c'est l'implémentation réelle, pas un remplaçant — on les remplace de la même façon (enregistrer le vôtre avant l'appel Orkeon), mais rien ne les annonce parce que rien ne manque.

Pourquoi c'est conçu ainsi

Un framework qui glisserait silencieusement un appel LLM, une dépendance réseau ou un store persistant derrière un défaut prendrait des décisions qui vous appartiennent. La contrepartie : un hôte fraîchement amorcé en fait moins qu'un hôte configuré — et le dit dans le log, une fois par service, avec le correctif dans le message. Si vous voyez l'un de ces warnings en production, ce n'est jamais du bruit : une capacité que vous attendez probablement tourne sur son remplaçant minimal.