Orkeon
Écrire une équipe

Une équipe, trois écritures, un seul runtime.

Une équipe (crew dans le code) est un ensemble d’agents, chacun avec un rôle, qui coopèrent pour accomplir une mission.

Kama écrit une équipe en YAML, à côté de feuilles en TypeScript et en C#
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.

écritDeux minutes, sans clé d’API. Il faut Orkeon et Ollama installés.
$ orkeon quickstart && cd orkeon-quickstart
$ orkeon run crew.yaml --mount ./out:/output:rw

L’agent écrit out/hello.md sans voir out/ : il ne voit que /output.

Source : le README du dépôt, exécuté par l’intégration continue (nouvel onglet), qui valide aussi le catalogue d’exemples (nouvel onglet).

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: true
memory: true
planning: true

agents:
  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: 10
    maxRpm: 15

  report_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: 5

tasks:
  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

La description déclarative, sans code. Le schéma YAML (nouvel onglet)

crew.ork.tsla même équipe, écrite pour cette page
/// <reference orkeon-script="1.0" />
const analyst = agentBuilder()
    .name("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"])
    .maxIterations(10)
    .maxRpm(15)
    .build();

const writer = agentBuilder()
    .name("report_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"])
    .maxIterations(5)
    .build();

const analyzeSales = taskBuilder()
    .name("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(analyst)
    .build();

const writeReport = taskBuilder()
    .name("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(writer)
    .withContext(analyzeSales)
    .deliverable({ path: "/output/weekly-report.md", source: "tool_call" })
    .build();

const crew = crewBuilder()
    .name("sales-report-crew")
    .goal("Produce weekly sales analysis report")
    .process("sequential")
    .withAgents([analyst, writer])
    .withTasks([analyzeSales, writeReport])
    .planning(true)
    .memory(true)
    .verbose(true)
    .build();

globalThis.crew = crew;

Ce fichier n’est pas dans le dépôt : il transcrit le YAML, et orkeon run crew.ork.ts --validate l’accepte en version 1.0.0. Écrire une équipe en TypeScript (nouvel onglet)

Program.csd’après docs/getting-started/overview
// Create the agents
var analyst = new AgentBuilder()
    .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 = new AgentBuilder()
    .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 tasks
var analyzeTask = new CrewTaskBuilder()
    .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 = new CrewTaskBuilder()
    .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 Crew
var crew = new CrewBuilder()
    .Goal("Produce weekly sales analysis report")
    .Sequential()
    .WithAgent(analyst)
    .WithAgent(writer)
    .WithTask(analyzeTask)
    .WithTask(reportTask)
    .Planning(true)
    .EnableMemory(true)
    .Verbose(true)
    .Build();

Les mêmes agents et les mêmes tâches, construits dans une application .NET. Outils et exécution : Amorçage et exécution (nouvel onglet)

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.

En détail

Le runtime vérifie ce que la description déclare

  1. Aucune écriture n’est une étape provisoire (nouvel onglet)

    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.

  2. L’équipe est vérifiée avant le premier appel au modèle (nouvel onglet)

    L’option --validate charge l’équipe sans appeler de modèle et imprime VALIDATION OK ou VALIDATION FAILED. Un outil inconnu fait refuser l’équipe.

  3. Les dossiers et leurs droits sont déclarés (nouvel onglet)

    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.

  4. Dans cinq modes d’orchestration sur six, le fichier fixe l’ordre (nouvel onglet)

    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: 20
mounts: ["/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.

{ "Accounts": { "triage": {
  "Provider": "Gmail",
  "Rights": "Read, Organize, Draft"
} } }
Fermé par défaut
L’envoi, tant que Send n’est pas dans les droits ou qu’aucun destinataire n’est listé.

Outils éprouvés sur un vrai compte Gmail en octobre 2026. Le compte rendu (nouvel onglet) · Le tutoriel (nouvel onglet)

Forge

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.

Pour aller plus loin

Documentation