VESICA
FQSYS_FQ_3Brouillon

SYS_FQ_3 — Manifeste des agents (`/config/agents.json`)

Formulaire· Direction des Systèmes d'Information (DSI) — Système & Infrastructure IA· émetteur VESICA SYS_PRO_3

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é par sync_agents_manifest. Prototype-fichier de la future table config.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éTypeRôleProvenance
base_pathstringracine du vault (/vault)constant [CORPUS]
directionsobjet {CODE: "NN - CODE - Label"}dossier Direction par trigrammedérivé du scan [CORPUS]
agentsobjet { "CODE-NN": {…} }dictionnaire des agentsdérivé du scan [CORPUS]
agents[].dossierstringdossier agent NN - Nom (relatif Direction)dérivé du chemin [CORPUS]
agents[].modestring|nullmodel | profil | dynamic | null (coquille)config_agent.json [CORPUS]
agents[].model_resolvedstring|nullmodèle effectif (cache) ou nullré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-NN dérivée du chemin, jamais du contenu (coquilles {} — P-6f-1). [CORPUS]
  • Exclusions : 00 - TEMPLATE AGENT, SYS-01, hors-pattern. [CORPUS]
  • model_resolved:null encode 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.json réé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]