Architecture
Un seul runtime, cinq portes d’entrée.
Le runtime est le moteur qui exécute une équipe d’agents (crew dans le code) et qui applique les règles. Il n’y en a qu’un, quel que soit le mode d’utilisation.

Le runtime et son point de contrôle
Portes d’entrée
Cinq façons d’atteindre le runtime.
- Orkeon Studio
- ligne de commande
orkeon - Orkeon Code
- Orkeon Workshop
- package NuGet
Runtime
Le moteur : il charge l’équipe et l’exécute.
- YAML ·
.ork.ts· C# - 6 modes
- budgets et disjoncteurs
- mémoire, points de reprise (à activer)
- pipeline RAG
Point de contrôle
Chaque appel d’outil d’un agent y passe avant d’agir.
- montages virtuels
- Guardian (heuristique)
- shell confiné (sauf en conteneur)
- bac à sable
- audit des appels
Outils
Ce qu’un agent peut faire, une fois l’appel accepté.
- fichiers
- courrier · drives
- web · HTTP
- bases · Office · PDF
- code
Fournisseurs
Les modèles qui répondent aux agents.
- modèles locaux
- éditeurs
- agrégateurs
- points d’accès compatibles OpenAI
Transversal OpenTelemetry · événements de domaine · MCP et A2A (expérimentaux) · Microsoft Agent Framework
Un cadre déclaré, puis appliqué
Un chemin hors montage est refusé au point de contrôle, avant d’atteindre le disque.
Un agent est un logiciel, pas un script
Une équipe se déploie, garde son état et s’observe comme n’importe quel service.
Un projet ouvert : des standards, pas d’enfermement
Orkeon est open source, sous licence MIT, et le choix du modèle reste libre.
Les briques du runtime
Les limites du cadre sont détaillées sur la page Sécurité.
A. Cadre
- CadreCe qu’un agent peut toucher est déclaréLes montages placent un dossier réel derrière chaque chemin virtuel. Le code s’exécute en bac à sable ; le shell est confiné, sauf en conteneur. Les outils web atteignent tout le web public tant que la liste de domaines n’est pas déclarée. Guardian, filtre heuristique contre l’injection, reste hors garantie.
- BudgetL’autonomie a un budgetUne exécution autonome tourne sous le budget que l’équipe déclare, à cinq bornes : appels d’outils, profondeur de délégation, durée, tokens, agents créés. Sans budget déclaré, ni les tokens ni la durée ne sont plafonnés. Des disjoncteurs (circuit breakers) interrompent les boucles. Les autres modes sont bornés par le plafond de tokens et de coût que fixe l’hôte, l’application qui lance le runtime ; il n’y en a pas par défaut. (nouvel onglet)
B. Continuité
- OrchestrationSix modes, choisis dans le fichier de l’équipeSéquentiel, hiérarchique (un manager et des exécutants), parallèle, consensuel (chaque agent exécute la tâche, puis un vote), graphe, autonome. L’ordre des tâches suit les dépendances déclarées, puis le fichier ; en parallèle, les tâches sans dépendance entre elles partent ensemble. (nouvel onglet)
- ÉtatMémoire, RAG et points de repriseLe runtime fournit six backends de mémoire et un pipeline RAG (la recherche documentaire qui alimente le modèle). La mémoire durable et les points de reprise sont à activer. Les embeddings locaux ne couvrent que l’anglais. (nouvel onglet)
- ObservabilitéTraces, métriques et journaux en OpenTelemetryUn export OTLP (le protocole d’OpenTelemetry), des événements de domaine (une tâche annulée, un agent en échec…) et un audit de chaque appel d’outil, sans les arguments. (nouvel onglet)
- ExtensibilitéPlugins isolés et fichiers .ork.tsLes plugins se chargent dans des contextes séparés. Le code procédural d’une équipe s’écrit en
.ork.ts. Un outil que ce code appelle lui-même ne passe pas par le point de contrôle. (nouvel onglet) - LivraisonLe même runtime, du poste au serveurCommande
dotnet tool, conteneur, serviceorkeon-host, bibliothèque NuGet. Package apt (source signée), installateur.msinon signé, archive macOS non notarisée.
L’intégration continue vérifie chaque changement
- Le README est un testses deux blocs de commandes sont exécutés (nouvel onglet)
- Chaque nombre est recalculé124 outils, 16 fournisseurs, 6 modes, 6 backends de mémoire, 104 équipes d’exemple (nouvel onglet)
- Zéro avertissementtous les analyseurs .NET,
-warnaserror(nouvel onglet) - Des workflows GitHub publicscouverture, CodeQL, secrets, dépendances (nouvel onglet)
Documentation
- Sécurité, résilience et plugins (nouvel onglet)/architecture/security
- Rejouer les réponses du modèle (nouvel onglet)/guides/testing
- Matrice de conformité A2A (expérimental) (nouvel onglet)/reference/a2a-conformance
- Interopérabilité Microsoft Agent Framework (nouvel onglet)/reference/agent-framework-interop
- Décisions d’architecture (ADR-002 à ADR-018) (nouvel onglet)/adr
- Référence de l’API (nouvel onglet)/api