VESICA
PQSYS_PQ_3Brouillon

SYS_PQ_3 — Procédure de gestion des modèles et du manifeste agents

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

SYS_PQ_3 — Procédure de gestion des modèles et du manifeste agents

Procédure légère. Détails dans les 4 workflows + ADR. [CORPUS]

Objet

Décrire comment le système tient à jour le catalogue de capacité des modèles, le manifeste des agents, et la sonde d'expiration ; et comment un agent voit son modèle résolu à l'appel. [CORPUS]

Domaine d'application

Tous les agents du système (toutes Directions). Le manifeste exclut : 00 - TEMPLATE AGENT, le Routeur SYS-01, et tout dossier hors-pattern (_CONFIG notamment). [CORPUS]

Références

  • Workflows : 07 §B2.9 / §B2.3bis / §B2.10 / §B2.3ter. [CORPUS]
  • ADR-031 — agents.json généré sur /config (host souverain), pas sur Drive (anti-dette rclone). [CORPUS]
  • ADR-032 — tout fichier de config consommé par un workflow = JSON (lu fromJson). [CORPUS]
  • ADR-028 — registre de capacité externalisé (vues), plancher/plafond. [CORPUS]
  • Pas de norme externe applicable. [STANDARD]

Définitions

  • Manifeste (agents.json) : carte CODE-NN → {dossier, mode, model_resolved} + directions + base_path. [CORPUS]
  • model_resolved : modèle effectif d'un agent, cache régénéré par le scan ; le runtime relit config_agent.json pour mode/model/temp. [CORPUS]
  • Clé canonique dérivée du chemin : CODE-NN se déduit du chemin du dossier (binary.data.directory), jamais du contenu (les coquilles ont un config_agent.json à {} — P-6f-1). [CORPUS]
  • Vue d'expiration : view_expiration.json (modèles avec expiration_date, triés ASC). [CORPUS]

Responsabilités (RACI)

Activitésync_model_capabilitiessync_agents_manifestnotify_expiring_modelsget_agent_configGérant
Rafraîchir catalogue + vuesR———A
Régénérer le manifeste—R——A
Surveiller les expirations—CR—I
Résoudre la config à l'appel—C (fournit dossier)—R—
Créer/renommer un agent (Drive)—I——R (+ DEX/ADV…)
Maintenir credentials/CRON————R/A

Déroulement (qui/quoi/quand/où)

  1. Hebdo (lundi 03:00) — sync_model_capabilities : 1 GET OpenRouter models?supported_parameters=structured_outputs → écrit catalogue + 3 vues dans /config/Agent_Model_Open_Router/ ; notif succès. [CORPUS]
  2. Hebdo / à la demande (Webhook) / debug (Manual) — sync_agents_manifest : glob /vault/*/*/config_agent.json → clé CODE-NN (chemin) → résout model_resolved → écrit /config/agents.json (+ miroir Drive). [CORPUS]
  3. Quotidien (06:00) — notify_expiring_models : carte model_resolved utilisés × view_expiration.json → modèles utilisés expirant ≤ 7 j → notify_system event model_expiring ; sinon NoOp (no-throw). [CORPUS]
  4. À chaque appel d'agent — get_agent_config lit agents.json (dossier) + les fichiers de l'agent, résout model_resolved (mode→model | profil→profils.json | dynamic→sonnet) et la capacité supports_structured_outputs (JOIN view_native_output_schema.json). [CORPUS]
  5. Création d'un agent : déposer le dossier NN - Nom sous la bonne Direction avec config_agent.json rempli → déclencher sync_agents_manifest (Webhook) pour rendre l'agent appelable. [STANDARD] [À CONFIRMER]

Enregistrements associés

  • /config/agents.json (cf. SYS_FQ_3). [CORPUS]
  • /config/Agent_Model_Open_Router/*.json (catalogue + 3 vues). [CORPUS]

Annexes

  • Résolution model_resolved : mode=model→config.model ; mode=profil→profils.json[profil].model ; mode=dynamic→anthropic/claude-sonnet-4.6 ; coquille→null. [CORPUS]
  • Triggers écartés : Drive Trigger, watcher inotify FUSE (P-6f-1). [CORPUS]