---
title: "Kodama : exécution durable d’agents"
description: "Vue d’ensemble de Kodama, le runtime Go pour les sessions d’agents durables, l’exécution parallèle et les espaces de développement, avec PostgreSQL et NATS."
canonical_url: https://optimi.com/fr/docs/kodama
md_url: https://optimi.com/fr/docs/kodama.md
last_updated: 2026-10-23
---

# Kodama

Kodama est un **runtime Go pour l’exécution durable et parallèle d’agents**.
Il s’intègre à votre application pour soumettre du travail, vous déconnecter,
redémarrer les workers et retrouver la même session avec son historique.

Il constitue le socle d’exécution des agents dans l’approche d’usine logicielle
d’Optimi. Votre application fournit les processus métier, les modèles et les
outils ; Kodama coordonne l’exécution et la reprise.

> **Dépôt public à venir**
>
> Le dépôt est prévu à l’adresse **`github.com/optimiware/kodama`**. Il n’a pas
>   encore été publié.

## Ce que Kodama apporte

- **Sessions durables :** soumettre des tâches, suivre leur progression et
  ajouter du travail à une session existante.
- **Exécution parallèle :** répartir les sessions indépendantes entre les
  workers tout en conservant l’ordre des entrées dans chaque session.
- **Outils contrôlés :** définir les outils accessibles à un agent, fixer des
  limites d’exécution et demander une validation humaine pour certaines actions.
- **Espaces de développement optionnels :** permettre aux agents d’examiner des
  dépôts, de modifier du code et de lancer des tests dans un environnement séparé.

## L’architecture en bref

Kodama s’insère dans votre infrastructure et dans le cycle de vie de votre application.

| Composant | Rôle |
| --- | --- |
| **Application hôte** | Authentification, identité du tenant, points d’accès métier, secrets et déploiement |
| **Client** | Accepter les tâches, lire l’historique et demander une pause, une reprise ou une annulation |
| **Workers** | Exécuter les étapes modèle et outils, appliquer les limites et reprendre le travail interrompu |
| **PostgreSQL** | État de référence des sessions, historique d’exécution et informations de reprise |
| **NATS JetStream** | Notifications optionnelles pour signaler rapidement le travail disponible aux workers |

PostgreSQL fait autorité. Les workers le consultent aussi directement : une
indisponibilité temporaire de NATS ne fait pas perdre les tâches acceptées.
Un déploiement peut fonctionner avec PostgreSQL seul ; NATS apporte les
notifications et NATS Core peut diffuser la progression provisoire en direct.

## Le parcours d’une tâche

1. Votre application authentifie la demande, sélectionne un tenant et ouvre une
   session associée à une définition d’agent versionnée.
2. Le client enregistre l’entrée dans PostgreSQL et retourne un identifiant
   d’exécution. Le travail continue indépendamment de la connexion HTTP initiale.
3. Un worker exécute le modèle et les outils autorisés, en enregistrant les
   étapes terminées. Le travail peut attendre un résultat d’outil ou une
   approbation humaine, puis reprendre.
4. Le résultat final et l’historique restent accessibles à votre application.
   Les opérateurs peuvent examiner ou piloter la session, et les utilisateurs
   soumettre la tâche suivante.

La reprise s’appuie sur l’état enregistré. Si le résultat d’une action externe
est incertain, Kodama conserve cette incertitude pour permettre sa résolution,
plutôt que de répéter l’action à l’aveugle.

## Développement et intégration applicative

Le développement assisté par agent ajoute un fournisseur d’espaces de travail
et, si nécessaire, un stockage d’artefacts. Les agents peuvent lire et modifier
des fichiers, exécuter des commandes bornées et retourner des diffs, résultats
de tests ou artefacts. Des points de reprise préservent le travail interrompu.
Les sessions de développement parallèles utilisent des espaces d’écriture
distincts, avec une étape explicite de revue et de fusion.

Votre application garde la responsabilité de l’authentification, des permissions
et de la politique de publication. La publication Git et les mises en production
passent par des processus explicitement autorisés. Des adaptateurs de modèles
et d’outils relient Kodama aux fournisseurs et systèmes choisis ; MCP peut servir
d’adaptateur d’outils.

## Déploiement et exploitation

Exécutez le client et les workers dans un même service Go, ou séparez l’API d’un
ensemble de workers. Ces deux modèles s’adaptent au cloud du client comme à une
infrastructure sur site.

Le socle technique actuel est **Go 1.26+ et PostgreSQL 16+**, avec
**NATS Server 2.10+** lorsque NATS est utilisé. L’application hôte gère les
connexions, les migrations explicites de base de données, la configuration et l’arrêt.

Dimensionnez les files d’attente, la concurrence et les limites d’exécution selon
votre charge. Les interfaces de santé et de diagnostic exposent la disponibilité,
le travail en attente, les capacités manquantes et les résultats d’outils non
résolus. Les journaux et hooks s’intègrent à votre supervision.

## L’accompagnement Optimi

Optimi vous aide à intégrer Kodama à votre châssis d’entreprise, à configurer
les projets de modernisation et à former vos équipes au pilotage de l’usine.

- [Découvrir la modernisation du patrimoine](/fr/secteurs/modernisation-du-patrimoine).
- [Parler à un architecte Optimi](/fr/contact).