SYS_FQ_3 — Manifeste des agents (/config/agents.json)
Formulaire / enregistrement. Fichier JSON réel sur
/config(host souverain, ADR-031), régénéré parsync_agents_manifest. Prototype-fichier de la future tableconfig.agents(ADR-033). [CORPUS]
Objet (quoi enregistrer)
La carte de tous les agents appelables : pour chaque clé canonique CODE-NN, son dossier Drive, son mode de résolution de modèle et le modèle résolu (cache). Sert deux consommateurs : prepare_agent_call (chemin) et notify_expiring_models (modèle). [CORPUS]
Champs / structure (prototype de table — clés du JSON)
| Clé | Type | Rôle | Provenance |
|---|---|---|---|
base_path | string | racine du vault (/vault) | constant [CORPUS] |
directions | objet {CODE: "NN - CODE - Label"} | dossier Direction par trigramme | dérivé du scan [CORPUS] |
agents | objet { "CODE-NN": {…} } | dictionnaire des agents | dérivé du scan [CORPUS] |
agents[].dossier | string | dossier agent NN - Nom (relatif Direction) | dérivé du chemin [CORPUS] |
agents[].mode | string|null | model | profil | dynamic | null (coquille) | config_agent.json [CORPUS] |
agents[].model_resolved | string|null | modèle effectif (cache) ou null | résolu [CORPUS] |
Structure projetée vers Postgres : config.agents(agent_key PK, code_direction, dossier, mode, model_resolved, …) — la résolution model_resolved deviendra une vue/colonne calculée. [CORPUS]
Règles de remplissage
- Jamais édité à la main : régénéré par
sync_agents_manifest(édition manuelle = dette ; ADR-031). [CORPUS] - Clé
CODE-NNdérivée du chemin, jamais du contenu (coquilles{}— P-6f-1). [CORPUS] - Exclusions :
00 - TEMPLATE AGENT,SYS-01, hors-pattern. [CORPUS] model_resolved:nullencode le statut « coquille / non résolu » (pas de sous-liste séparée). [CORPUS]- Le miroir Drive est décoratif (lecture seule) ; la source de vérité est
/config/agents.json. [CORPUS]
Rattachement (procédure/instruction)
- Procédure :
SYS_PQ_3. Instruction :SYS_IQ_3(résolution). [CORPUS] - Workflow producteur :
sync_agents_manifest(07§B2.3bis). [CORPUS]
Enregistrement résultant
- Fichier
/config/agents.jsonréécrit à chaque run. Exemple (extrait) :
{ "base_path": "/vault",
"directions": { "SYS": "00 - SYS - Systeme", "DEX": "...", "ADV": "..." },
"agents": {
"SYS-99": { "dossier": "99 - Agent Test", "mode": "model",
"model_resolved": "mistralai/mistral-small-latest" },
"DEX-01": { "dossier": "01 - Agent Generaliste", "mode": null, "model_resolved": null }
} }
[CORPUS]