Construire un agent industrialisable
Ce manuel décrit le produit agent : ce qu’on déclare dans project.yaml, comment le runtime l’exécute, et comment le valider avant mise en production.
Il est autonome — utilisable par une équipe runtime, un intégrateur ou un générateur de code, sans connaître l’éditeur agent-maker.
En une minute
Un agent Specificat, c’est :
- Une instruction avec placeholders (
{question},{topic}…) et livrables markdown explicites - Des capacités — outils intégrés, connecteurs MCP, délégation vers d’autres agents
- Une façade — ce que l’agent expose au monde (facettes nommées)
- Des triggers — chat web, API REST, cron, passerelle externe
- Des evals — scénarios de test alignés sur l’instruction (contrat input + critères)
Par où commencer ?
| Profil | Parcours | Durée |
|---|---|---|
| Décideur / PO | Parcours démo → Exemples | 10 min |
| Architecte / intégrateur | Modèle en bref → Capacités & URI | 20 min |
| Équipe runtime | Wiki exécution → Glossaire ACP / A2A / MCP | 1 h |
Ouvrir le pattern Coach exécutif : instruction structurée en 3 sections, evals qui vérifient le format de réponse, trigger chat — c’est le meilleur « wow » en 2 minutes.
Les trois piliers du manuel
Produit agent
Grammaire du modèle YAML : agents, URI tool: / mcp: / agent:, façade, lexique métier.
Runtime
Specs d’exécution : résolution d’instruction, délégation intra-projet (ACP), exposition publique (A2A), connecteurs MCP, triggers, evals.
Exemples
Douze patterns presque livrables client — du coach dialogue au worker JSON, du deal room au radar concurrentiel.
Promesse « industrialisable »
| Critère | Concrètement |
|---|---|
| Livrables visibles | Sections markdown nommées dans l’instruction (## Diagnostic, ## TL;DR…) |
| Entrées typées | Placeholders dérivés automatiquement — pas de JSON libre |
| Tests comportementaux | agents[].evals[] · scenarios[].input = placeholders + contains / matches sur la réponse |
| Exposition claire | Façade + facettes = contrat public de l’agent |
| Interopérabilité | MCP (outils), A2A (agents distants), triggers nommés |
Glossaire rapide
| Terme | Sens |
|---|---|
| Facette | Capacité exposée par un agent (facade.facets[]) |
| Connexion agent | Délégation vers un autre agent du projet (agent:worker:execute) |
| Connecteur MCP | Outils / prompts / resources externes (mcp:github:tool:*) |
| Trigger | Point d’entrée (chat, API, cron, gateway externe) |
Détail : Lexique produit · Glossaire runtime.
Vision long terme
Intent → Architecture → déploiement multi-projets : EVOLUTION-INTENT.