Contexte d'agent - Failproof AI

Le contexte d’agent indique aux audits à quoi sert chaque agent, ce qu’il doit produire et ce qu’il ne doit jamais faire. Failproof AI stocke ce contexte sous forme d’un contrat d’agent par agent. Le contexte d’agent appartient à l’organisation, pas à un seul audit. Vous le rédigez une fois par agent, et chaque audit piloté par un modèle dont le périmètre inclut cet agent l’utilise.

Ajouter un contexte d’agent

Tableau de bord
CLI

Accédez à Analyze → audits, sélectionnez agents, puis choisissez l’identifiant d’agent signalé par ses sessions.
Sélectionnez add content ou edit.
Décrivez à quoi sert l’agent, ce qu’il doit produire, ce que signifie « terminé », à quelle fréquence il doit s’exécuter et ce qu’il ne doit jamais faire.
Sauvegardez le contexte, puis revenez au formulaire d’audit et vérifiez que l’agent sélectionné est bien indiqué comme couvert.

Vous pouvez également ajouter ou modifier le contexte d’agent depuis le panneau agents lors de la création ou de la modification d’un audit. La sauvegarde est indépendante et le contexte est immédiatement disponible pour tous les audits applicables.

Le Cloud CLI n’expose pas encore les commandes de contrat. Utilisez l’API publique avec une clé disposant des permissions audits:read et audits:write :

curl -X POST "https://app.befailproof.ai/v1/audits/contracts" \
  -H "Authorization: Bearer $FAILPROOFAI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "nightly-reconciler",
    "enabled": true,
    "body": "# Purpose\nReconcile yesterday's payouts.\n\n## Outputs\nPublish a signed summary.\n\n## Must not\nNever modify ledger entries."
  }'

Listez les contrats avec GET /v1/audits/contracts ; récupérez un contrat spécifique avec GET /v1/audits/contracts/{id}. La mise à jour avec PUT est un remplacement complet et requiert à la fois agent_id et body.

Rédiger un contexte utile

Limitez le contexte à 5 000 caractères et rendez-le testable. Un contexte utile contient généralement :

Objectif : pourquoi l’agent existe
Sorties : artefacts ou actions qu’il doit produire
Terminé lorsque : la condition qui rend une exécution réussie
Cadence : à quelle fréquence ou quand il doit s’exécuter
Ne doit pas : actions et résultats toujours inacceptables

---
agent: nightly-reconciler
purpose: Reconcile yesterday's payouts and publish a signed summary.
cadence: Once daily after 02:00 UTC. Never more than once.
---

## Outputs
- A signed reconciliation summary in the finance channel.

## Done when
- Every payout is matched or explicitly flagged.

## Must not
- Modify ledger entries. Report discrepancies instead.

Le contexte d’agent définit le comportement attendu ; il ne peut pas indiquer à l’analyse quelle conclusion atteindre ni restreindre les preuves qu’elle examine. Les agents sans contexte sont audités normalement, mais Failproof AI ne peut pas évaluer leur comportement par rapport à l’intention propre à l’organisation.

Mettre en pause ou modifier le contexte d’agent

Mettez en pause le contexte d’agent lorsque les audits doivent temporairement l’ignorer. La mise en pause est réversible.
Modifiez le contexte lorsque la responsabilité de l’agent change. Le nouveau texte s’applique aux exécutions futures.
Vérifiez last matched lorsqu’un agent en cours d’exécution ne semble jamais utiliser son contexte. Cela signifie généralement que son identifiant d’agent ne correspond pas à la télémétrie.
Supprimez via l’API uniquement lorsque le texte doit être définitivement effacé. Le tableau de bord propose intentionnellement la mise en pause plutôt que la suppression.

Chaque exécution d’audit stocke l’instantané exact du contexte d’agent qu’elle a utilisé. Modifier, mettre en pause ou supprimer la ressource de contrat actuelle ne réécrit pas la base des conclusions antérieures.

La lecture des contrats nécessite audits:read. Leur création, modification, mise en pause ou suppression nécessite audits:write.

​Ajouter un contexte d’agent

​Rédiger un contexte utile

​Mettre en pause ou modifier le contexte d’agent

Ajouter un contexte d’agent

Rédiger un contexte utile

Mettre en pause ou modifier le contexte d’agent