Une équipe (crew dans le code) est un ensemble d’agents, chacun avec un rôle, qui coopèrent pour accomplir une mission.
L’essentiel
Une équipe se décrit, se vérifie sans modèle, puis s’exécute
La description d’une équipe déclare les agents, leurs outils, leurs tâches et les dossiers qu’ils peuvent toucher. L’option --validate la charge sans appeler de modèle, orkeon run l’exécute, et orkeon forge en génère une à partir d’une phrase.
Le runtime est le moteur qui exécute l’équipe et qui applique les règles.
Une équipe plus complète, dans les trois écritures :
crew.yamld’après docs/getting-started/overview
name: "sales-report-crew"goal: "Produce weekly sales analysis report"process: "sequential"verbose: truememory: trueplanning: trueagents:
data_analyst:
role: "Sales Data Analyst"goal: "Extract and analyze sales metrics from the database"backstory: |
Senior data analyst with 10 years of retail experience. Expert in SQL and statistical analysis.tools:
- "relational_database_query"
- "csv_reader"maxIter: 10maxRpm: 15report_writer:
role: "Report Writer"goal: "Transform analysis results into a clear executive report"backstory: |
Business communications specialist who turns data insights into actionable executive summaries.tools:
- "file_write"maxIter: 5tasks:
analyze_sales:
description: |
Query the sales database for the last 7 days. Calculate: total revenue, top 5 products by units sold, week-over-week growth rate. Return structured JSON. The database is the SQLite file sales.db: provider_name 'Microsoft.Data.Sqlite', connection_string 'Data Source=sales.db'. Table sales(id, sale_date 'YYYY-MM-DD', product, units, unit_price). The data ends on 2026-11-14.expectedOutput: "JSON object with revenue, top_products array, and growth_rate"agent: "data_analyst"write_report:
description: |
Using the sales analysis data, write an executive report in Markdown format. Include an executive summary, key metrics table, and 3 actionable recommendations.expectedOutput: "Markdown report saved to /output/weekly-report.md"agent: "report_writer"dependencies:
- "analyze_sales"deliverable:
path: "/output/weekly-report.md" # default source: tool_call — the agent writes it with file_write # source: final_message # or structured_output: the framework writes the file itself
// Create the agentsvar analyst = newAgentBuilder()
.Role("Sales Data Analyst")
.Goal("Extract and analyze sales metrics from the database")
.Backstory("Senior data analyst with 10 years of retail experience. Expert in SQL and statistical analysis.")
.WithTool(relationalDatabaseQueryTool)
.WithTool(csvReaderTool)
.MaxIterations(10)
.MaxRpm(15)
.Build();
var writer = newAgentBuilder()
.Role("Report Writer")
.Goal("Transform analysis results into a clear executive report")
.Backstory("Business communications specialist who turns data insights into actionable executive summaries.")
.WithTool(fileWriteTool)
.MaxIterations(5)
.Build();
// Create the tasksvar analyzeTask = newCrewTaskBuilder()
.Description("Query the sales database for the last 7 days. Calculate: total revenue, top 5 products by units sold, week-over-week growth rate. Return structured JSON. The database is the SQLite file sales.db: provider_name 'Microsoft.Data.Sqlite', connection_string 'Data Source=sales.db'. Table sales(id, sale_date 'YYYY-MM-DD', product, units, unit_price). The data ends on 2026-11-14.")
.ExpectedOutput("JSON object with revenue, top_products array, and growth_rate")
.AssignTo(analyst)
.Build();
var reportTask = newCrewTaskBuilder()
.Description("Using the sales analysis data, write an executive report in Markdown format. Include an executive summary, key metrics table, and 3 actionable recommendations.")
.ExpectedOutput("Markdown report saved to /output/weekly-report.md")
.AssignTo(writer)
.DependsOn(analyzeTask)
.Build();
// Create the Crewvar crew = newCrewBuilder()
.Goal("Produce weekly sales analysis report")
.Sequential()
.WithAgent(analyst)
.WithAgent(writer)
.WithTask(analyzeTask)
.WithTask(reportTask)
.Planning(true)
.EnableMemory(true)
.Verbose(true)
.Build();
Les trois écritures décrivent deux agents, deux tâches et un rapport écrit dans /output ; le même runtime les exécute.
Pour l’exécuter, placez la base d’exemple (SQLite, deux semaines de ventes fictives, 8 Ko) à côté de crew.yaml, puis lancez mkdir out && orkeon run crew.yaml --mount ./out:/output:rw. L’exactitude des chiffres du rapport dépend du modèle.
Le YAML est déclaratif, sans code ; le TypeScript (.ork.ts) est transpilé à la volée ; le C# s’intègre à une application .NET. On choisit selon la complexité que l’équipe doit traiter, pas selon le stade du projet.
Un bloc mounts:, facultatif, nomme les dossiers virtuels de l’équipe ; leurs droits, lecture seule ou lecture-écriture, viennent de la configuration ou de --mount. Un dossier que rien ne fournit fait refuser l’exécution.
Séquentiel, hiérarchique, consensuel et graphe suivent les dépendances déclarées, puis l’ordre du fichier ; en parallèle, les tâches sans dépendance entre elles partent ensemble. En autonome, le modèle les distribue sous le budget que l’équipe déclare, à cinq bornes : appels d’outils, profondeur de délégation, durée, tokens, agents créés.
Limites
Un agent peut se tromper : la relecture humaine reste nécessaire là où l’enjeu le demande.
Les outils web atteignent tout le web public tant que la liste de domaines n’est pas déclarée.
Sans budget déclaré, une exécution autonome ne plafonne ni les tokens ni la durée ; dans les autres modes, il n’y a ni plafond de tokens ni plafond de coût par défaut (Sécurité).
Cas d’usage
Trois exemples
Veille
Un rapport de veille hebdomadaire, envoyé à une liste fermée
Quatre agents lisent le web et écrivent un rapport sourcé. Le rapport va sur le drive, puis aux seules adresses de la liste.
process: "sequential"maxRpm: 20mounts: ["/output"]
# appsettings, par compte : Send.AllowedRecipients (courrier), Rights (drive)
Ouvert par défaut
Les outils web atteignent tout le web public tant que la liste de domaines n’est pas déclarée (Sécurité).
Cette équipe n’a pas encore été jouée en public, et les outils drive restent à éprouver sur de vrais comptes.Les outils drive (nouvel onglet)
Courrier
Le courrier trié, les réponses laissées en brouillons
Un agent range le courrier non lu et prépare les réponses en brouillons. Une personne les relit : l’agent n’envoie rien.
Une équipe générée à partir d’une phrase, adoptée sur votre décision
orkeon forge compose l’équipe, l’essaie en bac à sable et la juge selon vos critères. Une équipe générée n’est, par défaut, adoptée qu’après le verdict d’une personne.
$ orkeon forge "résumer chaque matin les nouvelles
offres de mon fournisseur"
La forge exige un modèle configuré : orkeon init s’en charge.