Documentation Specificat
Deux complémentarités pour utilisateurs, clients et intégrateurs :
- Plateforme Agent Maker — organisations, projets, édition, collaboration, droits, catalogue
- Produit agent — ce qu’on déclare dans
project.yaml, comment le runtime l’exécute, et comment le valider avant mise en production
Le manuel agent est autonome : une équipe runtime ou un générateur de code peut s’en servir sans connaître l’éditeur.
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 |
|---|---|---|
| Utilisateur Agent Maker | Parcours plateforme → Espace projet | 15 min |
| Invité sur un projet | Partage et droits | 5 min |
| Conformité / CGU | Compte et légal | 10 min |
| Décideur / PO (agent) | Parcours démo → Exemples | 10 min |
| Architecte / intégrateur | Modèle en bref → Capacités & URI | 20 min |
| Équipe runtime | Wiki exécution → Glossaire | 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 quatre piliers
Plateforme
Agent Maker côté utilisateur — routes réelles, onglets projet, état de livraison UI/API, partage viewer/editor. Aligné sur le code, pas sur la cible RBAC seule.
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 (A2A), 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.