Aller au contenu
English

Le cycle de vie d'un agent

  • Leçon 9
  • 40 min
  • Module 3 : Enregistrer chaque agent

Où nous en sommes

Dans les deux dernières leçons, nous avons enregistré chaque agent et lui avons donné sa propre identité. La passerelle refuse maintenant tout appel sans ces éléments. Mais un enregistrement est exact le jour où quelqu'un le rédige. Les agents changent, les responsables partent et les dates de révision passent. Dans cette leçon, nous suivons un agent pendant toute sa vie, de son enregistrement à son retrait. Le registre du parc automobile suit aussi une fourgonnette, de sa première inspection au jour de sa vente.

Ce que vous saurez faire

Gardez chaque enregistrement exact pendant toute la vie de l’agent. Révisez-le à temps, modifiez-le dans une nouvelle version, suspendez-le en cas d’urgence et retirez-le définitivement. Chaque étape laisse un événement dans la piste d’audit. Une commande trouve les agents qui nécessitent une intervention humaine, comme une révision en retard ou un responsable parti.

Avant de commencerCe qu’il faut savoir et avoir sous la mainEnviron 40 minutes

Ce que vous devez savoir

Ce qu’il vous faut sur votre ordinateur

  • Le projet ~/projects/ai-estate, identique à l’instantané end-of-m03, avec son environnement virtuel actif. python -m pytest -q se termine par 135 passed, 1 deselected.
  • Le parc en marche (python -m estate up), avec six enregistrements et les identifiants de cinq applications, comme à la fin de la dernière leçon. Si vous partez de l’instantané, son README donne les commandes qui créent cet état.

Testé sur macOS (Apple silicon) avec Python 3.12.13. Les commandes Windows (PowerShell) et Linux sont fournies, mais le cours ne les a pas exécutées.

Revenons au registre du parc automobile. Une nouvelle fourgonnette reçoit sa fiche et passe sa première inspection avant son premier trajet. Chaque année, elle passe une nouvelle inspection, dont la date figure sur la fiche. Quand l’entreprise installe une grue sur la fourgonnette, la fiche change. La fourgonnette doit passer une nouvelle inspection avant de soulever quoi que ce soit. Quand les freins lâchent, on la retire de la route jusqu’à la réparation. Et quand on la vend, on archive sa fiche. On ne donne jamais son numéro à une autre fourgonnette. Ainsi, une ancienne amende ou un ancien rapport d’accident ne désigne jamais la mauvaise fourgonnette.

Une personne au bureau lit aussi le registre chaque semaine. Elle cherche deux choses : une inspection en retard et une fourgonnette dont la personne responsable a quitté l’entreprise.

Le problème : des enregistrements qui ne sont plus exacts

Section intitulée « Le problème : des enregistrements qui ne sont plus exacts »

Le registre de Larkfield est récent et contient déjà un enregistrement périmé. Kwame demande tous les enregistrements qui nécessitent une intervention, à la date du jour du cours, le 22 octobre 2026 :

Fenêtre de terminal
python -m estate review-due --today 2026-10-22
release-judge review overdue since 2026-10-01 (21 days)
1 item(s) need attention

Le juge des mises en production de Priya aurait dû être révisé le 1 octobre. Personne ne l’a remarqué, car rien ne vérifiait les dates. Le résumé hebdomadaire montre un cas plus grave : Lee est parti le 31 août. Le script a continué à s’exécuter chaque lundi. Un enregistrement que personne ne révise devient peu à peu le récit d’un agent qui n’existe plus.

Utilisez --today 2026-10-22 dans cette leçon pour obtenir la même sortie que le cours. Sans cette option, la commande utilise la date de votre ordinateur, et davantage de révisions pourraient être en retard.

L’idée : un cycle de vie, avec une vérification à chaque étape

Section intitulée « L’idée : un cycle de vie, avec une vérification à chaque étape »

Le cycle de vie d’un agent comprend les statuts possibles d’un enregistrement et les étapes entre ces statuts. Chaque étape est une commande. Chaque commande vérifie quelque chose avant de modifier le registre :

Un diagramme d'états. Au départ, l'enregistrement à risque élevé mène au statut en attente, après vérification du formulaire et du formulaire détaillé. L'enregistrement à risque faible ou moyen mène directement au statut actif, après vérification du formulaire. Depuis le statut en attente, une révision mène au statut actif. Une personne approuve l'agent et fixe la prochaine date. Depuis le statut actif, certains changements à un agent à risque élevé le remettent en attente : capacités, outils, données, autonomie ou limites. Une révision le garde actif. Une modification d'un agent à risque faible ou moyen, dans une nouvelle version, le garde aussi actif. La suspension exige une raison et mène du statut actif au statut suspendu. La reprise exige une raison et fait le chemin inverse. Le retrait exige une raison et mène du statut actif ou suspendu au statut retiré. Au statut retiré, les identifiants sont révoqués et l'identifiant de l'agent n'est jamais réutilisé.
Le cycle de vie d'un agent. Seul un agent actif passe la passerelle; un agent retiré ne revient jamais.
Description textuelle du diagramme
  • Enregistrer. Un agent à risque élevé commence en attente : le formulaire et le formulaire détaillé sont vérifiés. Un agent à risque faible ou moyen commence actif : le formulaire est vérifié.
  • Réviser. Une personne approuve l’agent et fixe la prochaine date de révision, dans l’intervalle de son niveau de risque. Un agent en attente devient actif.
  • Modifier. Une nouvelle version du formulaire. Un agent à risque faible ou moyen reste actif. Un agent à risque élevé retourne en attente si ses capacités, outils, classes de données, autonomie, niveau de risque ou limites changent. Il y reste jusqu’à la prochaine révision.
  • Suspendre et reprendre. D’actif à suspendu, et inversement. Une raison est obligatoire.
  • Retirer. D’actif ou suspendu à retiré. Une raison est obligatoire. Les identifiants sont révoqués et l’identifiant de l’agent n’est jamais réutilisé.

Deux autres règles relient le cycle de vie à la plateforme. Le point de terminaison des jetons donne des jetons seulement aux agents actifs et aux agents en cours d’arrêt. Ce dernier statut permet de terminer le travail proprement; le module 5 l’utilise. La passerelle laisse passer seulement les agents actifs. Un changement de statut dans le registre change donc aussi ce que l’agent peut faire, dès son prochain appel.

Chaque étape est aussi un événement. Un événement est une ligne contenant l’heure, l’agent, l’action, la personne et les détails, comme la raison. Les événements forment la piste d’audit du registre. Des mois plus tard, ils répondent à la question : « Qui a suspendu l’assistant documentaire, et pourquoi? »

python -m estate review-due joue le rôle de la personne qui lit le registre chaque semaine. La commande liste les révisions en retard et celles prévues dans les 30 prochains jours. Elle liste aussi les responsables partis et les versions fixées qui expirent dans les 60 jours. Voici les dates de révision des six enregistrements de Larkfield :

Une ligne du temps verticale de la fin septembre 2026 au début février 2027. Une ligne bleue marque aujourd'hui, le 22 octobre 2026. Avant aujourd'hui : release-judge, risque moyen, révision prévue le 1 octobre 2026, en rouge : 21 jours de retard. Après aujourd'hui : support-workflow et support-mcp, tous deux à risque élevé, révision prévue le 1 décembre 2026. Puis ticket-triage et helpdesk-assistant, tous deux à risque moyen, révision prévue le 15 janvier 2027. Enfin doc-assistant, risque faible, révision prévue le 1 février 2027.
Les dates de révision dans le registre de Larkfield. Seul le juge des mises en production est en retard le 22 octobre 2026.
Description textuelle du diagramme

Une ligne du temps de la fin septembre 2026 au début février 2027, avec une ligne pour aujourd’hui, le 22 octobre 2026.

  • 1 octobre 2026 : release-judge (moyen). En retard de 21 jours.
  • 1 décembre 2026 : support-workflow et support-mcp (tous deux élevés).
  • 15 janvier 2027 : ticket-triage et helpdesk-assistant (tous deux moyens).
  • 1 février 2027 : doc-assistant (faible).

Les agents à risque élevé reviennent en premier, car leur intervalle est le plus court : 3 mois.

Un petit exemple détaillé : suspendre et reprendre un agent

Section intitulée « Un petit exemple détaillé : suspendre et reprendre un agent »

Une suspension est l’arrêt d’urgence d’un seul agent : la fourgonnette quitte la route, et rien d’autre ne change. Kwame s’exerce avec l’assistant documentaire. Faites d’abord une prédiction : l’assistant possède déjà un jeton valide obtenu avant la suspension. Ce jeton fonctionne-t-il encore?

  1. Gardez un jeton de l’assistant documentaire obtenu avant la suspension :

    Fenêtre de terminal
    OLD=$(python -m estate token doc-assistant)
  2. Suspendez l’assistant, avec une raison :

    Fenêtre de terminal
    python -m estate suspend doc-assistant --reason "drill: suspend one agent"
    doc-assistant is now suspended.
    Told 1 of 1 gateway replicas to refresh now.

    La commande a demandé à la passerelle de récupérer un nouvel instantané immédiatement. Elle n’attend pas la prochaine vérification périodique.

  3. Rejouez une question par la passerelle :

    Fenêtre de terminal
    python -m apps.replay doc-assistant --units 1 --via gateway
    The platform refused a token for doc-assistant: {"error":{"code":"invalid_client","message":"doc-assistant cannot get a token: its registration is suspended."}}

    L’application a demandé un nouveau jeton, et le plan de contrôle l’a refusé.

  4. Utilisez maintenant l’ancien jeton, avec la commande curl de la dernière leçon : -H "Authorization: Bearer $OLD" et le corps contenant « Hello » (bonjour).

    {"error":{"code":"agent_suspended","message":"doc-assistant is suspended: the gateway refuses its calls.","type":"gateway","check":"registration"}}

    Le jeton est encore valide : sa signature et sa période de validité sont correctes. Mais la vérification de l’enregistrement le refuse.

  5. Reprenez l’assistant et rejouez une question :

    Fenêtre de terminal
    python -m estate resume doc-assistant --reason "drill over"
    python -m apps.replay doc-assistant --units 1 --via gateway
    doc-assistant is now active.
    Told 1 of 1 gateway replicas to refresh now.
    doc-assistant: 1 requests through the gateway | status {200: 1}
    answered by: chat-small (gpt-6-luna-2026-09-22) x1
    tokens: 779 in, 439 out | cost: US$0.0003
  6. Lisez la piste d’audit de l’assistant documentaire :

    Fenêtre de terminal
    python -m estate events doc-assistant
    … doc-assistant register usr-kwame {"status": "active", "version": 1}
    … doc-assistant credentials_issued usr-kwame {"credential": "doc-assistant#1"}
    … doc-assistant suspended usr-kwame {"before": "active", "reason": "drill: suspend one agent"}
    … doc-assistant active usr-kwame {"before": "suspended", "reason": "drill over"}

    Chaque ligne commence par l’heure de l’événement, en UTC selon l’horloge du parc. Le cours omet les heures ici (…), car les vôtres diffèrent.

La suspension a fonctionné à deux endroits. Le plan de contrôle a refusé un nouveau jeton. La passerelle a refusé le jeton déjà délivré. Cette deuxième vérification explique pourquoi le jeton ne contient aucune autorisation : la passerelle consulte le registre à chaque appel. La suspension n’a rien changé pour les cinq autres agents. Avec la clé partagée az-key-1, le seul moyen d’arrêter un agent était d’arrêter deux applications.

Les prochaines étapes retirent un agent, et un retrait est irréversible. Vous vous exercez donc dans un deuxième registre, vide. ESTATE_STATE indique au parc où se trouve son état. Git ignore un dossier à l’intérieur de state/, et python -m estate reset le supprime.

  1. Utilisez le registre d’exercice dans ce terminal :

    Fenêtre de terminal
    export ESTATE_STATE=state/practice
  2. Vérifiez qu’il est vide : python -m estate list affiche 0 registrations (0 enregistrement).

Vos services en marche utilisent encore le vrai registre dans state/. Ils ont démarré avant que vous définissiez la variable.

  1. Enregistrez le juge des mises en production dans le registre d’exercice et listez ce qui nécessite une intervention :

    Fenêtre de terminal
    python -m estate register registrations/release-judge.yaml
    python -m estate review-due --today 2026-10-22
    Registered release-judge (version 1): active
    release-judge review overdue since 2026-10-01 (21 days)
    1 item(s) need attention
  2. Révisez-le. Un agent à risque moyen exige une révision au moins tous les 6 mois. Choisissez donc le 1 avril 2027 :

    Fenêtre de terminal
    python -m estate review release-judge --next 2027-04-01 --note "judge agreement checked: 99 of 101"
    Reviewed release-judge: active, next review by 2027-04-01.

    La note cite la preuve de la révision : le juge concordait avec les vérifications du code sur 99 réponses sur 101 dans le module 2.

  3. Essayez une date trop éloignée :

    Fenêtre de terminal
    python -m estate review release-judge --next 2027-10-01 --note "too late"
    review_date: a medium risk registration is reviewed at least every 6 months

    Le registre l’a refusée et a gardé le 1 avril 2027.

  4. Exécutez de nouveau python -m estate review-due --today 2026-10-22. La commande affiche 0 item(s) need attention (aucun élément ne nécessite une intervention).

Modifier : un agent à risque élevé reçoit un nouvel outil

Section intitulée « Modifier : un agent à risque élevé reçoit un nouvel outil »

Amira veut que le flux de travail utilise aussi l’outil propose_refund du serveur de soutien. Elle modifie une copie du formulaire pour garder le vrai fichier intact.

  1. Enregistrez et révisez le flux de travail dans le registre d’exercice :

    Fenêtre de terminal
    python -m estate register registrations/support-workflow.yaml
    python -m estate review support-workflow --next 2026-12-01 --note "first review"
  2. Créez un dossier drafts et copiez-y le formulaire sous le nom drafts/support-workflow.yaml. Dans la copie, ajoutez une ligne à la fin de la liste tools (outils) :

    drafts/support-workflow.yaml (the end of the tools list)
    - orders.add_ticket_note
    - support.propose_refund
  3. Enregistrez le formulaire modifié :

    Fenêtre de terminal
    python -m estate register drafts/support-workflow.yaml
    Registered support-workflow (version 2): pending until a review approves it (python -m estate review support-workflow)
  4. Révisez le changement : python -m estate review support-workflow --next 2026-12-01 --note "propose_refund: approvals stay with a person".

  5. Lisez les événements du flux de travail : python -m estate events support-workflow.

… support-workflow register usr-kwame {"status": "pending", "version": 1}
… support-workflow review usr-kwame {"approved": true, "next_review": "2026-12-01", "note": "first review", "status": "active"}
… support-workflow change usr-kwame {"changed": ["tools"], "status": "pending", "version": 2}
… support-workflow review usr-kwame {"approved": true, "next_review": "2026-12-01", "note": "propose_refund: approvals stay with a person", "status": "active"}

Un nouvel outil a remis l’agent à risque élevé en attente. Entre le changement et la révision, le flux de travail ne pouvait pas obtenir de jeton. La passerelle aurait aussi refusé ses appels. C’est la grue sur la fourgonnette : une nouvelle inspection avant de soulever quoi que ce soit. L’événement indique exactement ce qui a changé, ["tools"], pour que le réviseur sache quoi examiner. Une modification d’un agent à risque faible ou moyen le garde actif. Son événement consigne le changement de la même façon.

Omar trouve cela lent : « Un seul outil, et le flux de travail s’arrête jusqu’à ce que Kwame regarde? » Kwame répond : une révision prend une commande. Un agent à risque élevé doté d’un nouvel outil d’écriture est justement un cas qui mérite une révision. Une équipe qui fait souvent des changements peut planifier la révision avec le changement. La pause ne dure alors que quelques minutes.

Mei remplace l’assistant documentaire par une nouvelle version. L’ancien est retiré.

  1. Enregistrez l’assistant dans le registre d’exercice et délivrez ses identifiants :

    Fenêtre de terminal
    python -m estate register registrations/doc-assistant.yaml
    python -m estate credentials issue doc-assistant
  2. Retirez-le :

    Fenêtre de terminal
    python -m estate retire doc-assistant --reason "replaced by the new document assistant"
    doc-assistant is now retired.
  3. Essayez d’obtenir un jeton avec ses identifiants :

    Fenêtre de terminal
    python -m estate token doc-assistant
    invalid_client: Unknown client, wrong secret, or revoked credentials.
  4. Essayez d’enregistrer de nouveau le même formulaire :

    Fenêtre de terminal
    python -m estate register registrations/doc-assistant.yaml
    Not registered:
    - doc-assistant is retired: a retired ID is never used again; choose a new ID
  5. Affichez l’enregistrement et lisez ses événements :

    Fenêtre de terminal
    python -m estate show doc-assistant
    python -m estate events doc-assistant
    doc-assistant | Document assistant | retired | version 1
    owner usr-mei (data) | risk low | autonomy suggests | data internal
    capabilities: fast-small
    tools: none
    budget US$3/month | 60 requests/min | 500,000 tokens/day | 2 model calls per run
    review by 2027-02-01 | credentials: doc-assistant (revoked …)
    … doc-assistant register usr-kwame {"status": "active", "version": 1}
    … doc-assistant credentials_issued usr-kwame {"credential": "doc-assistant#1"}
    … doc-assistant retired usr-kwame {"before": "active", "reason": "replaced by the new document assistant"}
    … doc-assistant credentials_revoked usr-kwame {"credentials": ["doc-assistant#1"], "reason": "retired"}

Le retrait répond à trois questions. Le registre ne répond lui-même qu’à certaines d’entre elles :

  • Identifiants : révoqués immédiatement par le registre. L’événement credentials_revoked (identifiants révoqués) le montre. La passerelle refuse aussi les jetons délivrés avant le retrait : leur identifiant d’accès, doc-assistant#1, est révoqué définitivement.
  • L’enregistrement : conservé. L’enregistrement, ses versions et ses événements restent dans le registre, et review-due les ignore. L’identifiant de l’agent n’est jamais donné à un autre agent. Un rapport de coûts de septembre désigne encore cet assistant. Il ne désigne jamais un nouvel agent portant le même nom.
  • Les données propres à l’agent : le registre n’y touche pas. Le champ data_retention (conservation des données) du formulaire détaillé indique ce que l’agent conserve et pendant combien de temps. Pour le flux de travail : « Le flux de travail conserve ses exécutions dans work/runs.sqlite pendant 30 jours. » Supprimer ces données, ou les conserver pour un audit, relève du responsable. Inscrivez la décision dans la raison du retrait. Les enregistrements d’utilisation de la passerelle restent aussi, comme preuves pour le module 6.

Erreur courante

Retiré au lieu de suspendu

Symptôme : Tomás veut arrêter l’assistant documentaire pour un après-midi, mais tape retire (retirer) au lieu de suspend (suspendre). Le soir, python -m estate resume doc-assistant --reason "undo" affiche :

doc-assistant is retired: it cannot change any more.

L’application reçoit invalid_client (client invalide) pour chaque jeton.

Cause : le retrait est définitif par conception. Les identifiants sont révoqués et l’identifiant de l’agent est fermé définitivement. Ainsi, les anciens enregistrements ne désignent jamais un nouvel agent.

Diagnostic : python -m estate show doc-assistant indique retired (retiré). python -m estate events doc-assistant montre qui l’a retiré, quand et pour quelle raison.

Rétablissement : enregistrez l’assistant sous un nouvel identifiant, avec de nouveaux identifiants d’accès. Modifiez le fichier d’identifiants de l’application. Dans le registre d’exercice, copiez le formulaire vers drafts/doc-assistant-2.yaml et remplacez sa première ligne par id: doc-assistant-2. Puis enregistrez-le et délivrez ses identifiants :

Fenêtre de terminal
python -m estate register drafts/doc-assistant-2.yaml
python -m estate credentials issue doc-assistant-2
Registered doc-assistant-2 (version 1): active
New credentials for doc-assistant-2: client ID doc-assistant-2, credential doc-assistant-2#1; the secret is in state/practice/credentials/doc-assistant-2.json (shown nowhere else; keep it out of code and out of Git).

Conséquence pour le travail en IA : un arrêt pour un après-midi est une suspension. Réservez le retrait à un agent qui ne reviendra pas. Les deux commandes ne diffèrent que d’un mot. Larkfield s’exerce donc d’abord au retrait dans un registre d’exercice, comme vous l’avez fait ici.

Exécutez review-due selon un horaire, par exemple chaque lundi, et envoyez sa liste aux responsables. Révisez chaque agent à risque élevé au moins tous les 3 mois et après chaque changement de ses actions permises. En cas d’urgence, suspendez d’abord; vous pouvez reprendre ensuite. Retirez un agent quand il est remplacé ou n’est plus nécessaire. Retirez-le aussi quand son responsable part et que personne ne prend la relève.

Le coût est le temps des personnes : les révisions et la lecture de la liste. Un registre sans révisions coûte moins cher, mais devient inexact en quelques mois. L’autre coût est la friction. Un changement à risque élevé met un agent en pause jusqu’à ce qu’une personne le révise. Une équipe qui planifie ses révisions avec ses changements y consacre quelques minutes. Une équipe qui ne planifie pas se retrouve avec un agent arrêté.

Changez une condition : une responsable quitte l’entreprise. Priya, responsable du juge des mises en production, quitte Larkfield le 30 octobre 2026. Restez dans le registre d’exercice. Faites d’abord une prédiction : que listera review-due (révisions à faire) le 2 novembre, et que faut-il changer dans l’enregistrement?

  1. Dans config/people.yaml, ajoutez left: 2026-10-30 à la ligne de Priya. Gardez d’abord une copie du fichier, par exemple drafts/people-backup.yaml.

  2. Exécutez python -m estate review-due --today 2026-11-02.

  3. Vérifiez le formulaire du juge des mises en production avec python -m estate check registrations/release-judge.yaml.

  4. Kwame prend en charge le juge jusqu’à ce que l’équipe d’évaluation ait un nouveau responsable. Copiez le formulaire dans drafts/release-judge.yaml. Remplacez le responsable par usr-kwame, et la date de révision par celle que vous avez fixée pendant la révision, 2027-04-01.

  5. Enregistrez la copie, puis exécutez de nouveau review-due pour le 2 novembre.

  6. Restaurez config/people.yaml à partir de votre copie, puis nettoyez l’environnement d’exercice :

    Fenêtre de terminal
    cp drafts/people-backup.yaml config/people.yaml
    rm -rf drafts state/practice
    unset ESTATE_STATE
    python -m estate list

    La liste affiche de nouveau le vrai registre : 6 enregistrements, tous actifs.

Vérifiez votre travail

La ligne de Priya dans config/people.yaml :

usr-priya: {name: Priya, team: evaluation, title: data scientist, left: 2026-10-30}

review-due le 2 novembre :

release-judge owner usr-priya left on 2026-10-30: find a new owner or retire it
support-workflow review due on 2026-12-01
2 item(s) need attention

La révision du flux de travail doit avoir lieu dans les 30 prochains jours. Il figure donc aussi dans la liste. La vérification du formulaire :

- owner usr-priya: left the company on 2026-10-30; a registration needs an owner who is here

Votre copie diffère du formulaire sur deux lignes :

4c4
< owner: usr-priya
---
> owner: usr-kwame
18c18
< review_date: 2026-10-01
---
> review_date: 2027-04-01

La nouvelle version, et la liste qui suit :

Registered release-judge (version 2): active
support-workflow review due on 2026-12-01
1 item(s) need attention

L’événement du changement indique {"changed": ["owner"], "status": "active", "version": 2}. Pourquoi changer la date de révision dans la copie? Une nouvelle version remplace tout le formulaire. Avec l’ancienne date, le 1er octobre, le juge aurait de nouveau une révision en retard. L’équipe du cours a constaté exactement cela lors de son premier essai. Remarquez aussi ce qui ne s’est pas produit : le juge a continué de fonctionner après le départ de Priya. Le registre n’arrête pas un agent quand son responsable quitte l’entreprise. Il inscrit l’agent sur la liste, et une personne décide.

Vérifiez votre compréhension

Vérification du module. Lisez cette description, puis définissez le niveau de risque, les classes de données, les capacités, les outils, l'autonomie et les limites de l'agent. Justifiez chaque choix. L'assistant de soutien rédige des réponses pour les agents de soutien à partir des politiques de Larkfield et du billet de soutien. Il passe par le serveur MCP de soutien. Il lit les billets et cherche dans les politiques. L'agent de soutien lit le brouillon et envoie la réponse. Comparez ensuite votre réponse avec registrations/helpdesk-assistant.yaml.

Afficher la réponse

L’enregistrement dans le parc :

  • Niveau de risque medium (moyen). Il lit les billets, donc il voit des données personnelles. Mais il ne change rien, et une personne lit chaque brouillon avant qu’un client le voie. Son risque n’est pas élevé, car il ne peut déplacer ni argent ni biens. Il n’est pas faible, à cause des données personnelles.
  • data_classes: [personal] (classe de données : personnelles). Les billets nomment les clients. Il n’a jamais besoin de données de paiement.
  • capabilities: [fast-small] (capacité : modèle petit et rapide). De courts brouillons nécessitent un modèle rapide et peu coûteux. Aucune évaluation ne justifierait strong-reasoning.
  • tools: [support.search_knowledge, support.get_ticket] (outils de recherche et de lecture de billets). Seulement les deux outils de lecture. support.propose_refund (proposer un remboursement) est un outil d’écriture. L’assistant rédige seulement du texte, donc il n’y a pas accès. Le module 5 montre la passerelle d’outils refuser cet outil, même quand le modèle le demande.
  • autonomy: suggests (autonomie : suggère). L’agent de soutien envoie la réponse.
  • Limites : 2 $ US par mois, 60 requêtes par minute, 300 000 jetons (tokens) par jour, 6 appels de modèle par exécution. Une exécution correspond à un billet. Ainsi, 6 appels arrêtent une boucle rapidement et laissent de la place au travail normal.
  • review_date: 2027-01-15 (date de révision : 15 janvier 2027). Dans les 6 mois, comme l’exige le niveau moyen.

Un réviseur accepte d’autres limites si vous les justifiez à partir du trafic. Il n’accepte pas l’outil d’écriture, autonomy: acts (autonomie : agit), ni une classe de données manquante.

Vérifiez votre compréhension

Faites une prédiction : Kwame suspend le flux de travail de soutien alors que son jeton reste valide pendant 7 minutes. Qu'arrive-t-il à son prochain appel de modèle et à sa prochaine demande de jeton? Que change son retrait plutôt que sa suspension?

Afficher la réponse

La passerelle refuse le prochain appel de modèle avec 403 agent_suspended, lors de la vérification de l’enregistrement. Le jeton est valide, mais l’enregistrement n’est pas actif. La prochaine demande de jeton est refusée avec invalid_client, « son enregistrement est suspendu ». Les autres agents ne sont pas touchés. S’il le retire, les deux sont aussi refusés. Mais les identifiants d’accès sont également révoqués, et le statut ne peut jamais redevenir actif. L’identifiant support-workflow est fermé définitivement. Le flux de travail aurait donc besoin d’un nouvel identifiant et de nouveaux identifiants d’accès.

Vérifiez votre compréhension

Pourquoi un changement aux outils d'un agent à risque élevé le remet-il en attente, contrairement à un changement au texte de son objectif?

Afficher la réponse

Les outils, les capacités, les classes de données, l’autonomie, le niveau de risque et les limites déterminent ce que l’agent peut faire. Un nouvel outil d’écriture peut déplacer de l’argent. Une personne doit donc le vérifier avant que l’agent l’utilise. Le texte de l’objectif décrit l’agent, mais ne lui donne aucun nouveau pouvoir. Le registre consigne quand même ce changement comme une nouvelle version, avec un événement qui nomme le champ modifié. Un réviseur le voit à la prochaine révision.

Récapitulatif

  • Le cycle de vie d’un agent compte cinq étapes : enregistrer, réviser, modifier, suspendre et reprendre, puis retirer. Un agent à risque élevé commence en attente. Un changement à ses autorisations le remet en attente.
  • Chaque étape vérifie quelque chose : le formulaire, l’intervalle de révision ou une raison. Chaque étape est aussi un événement avec l’heure, la personne et les détails : la piste d’audit.
  • Une suspension arrête un agent à deux endroits : aucun nouveau jeton, et la passerelle refuse les jetons déjà émis. Un retrait révoque aussi les identifiants d’accès et ferme l’identifiant définitivement. Le responsable gère les données propres à l’agent, selon data_retention (conservation des données) dans le formulaire long.
  • python -m estate review-due liste les révisions en retard, les responsables partis et les versions épinglées qui arrivent à échéance. Le 22 octobre 2026, la révision du juge des mises en production a 21 jours de retard. Quand un responsable part, l’agent continue de fonctionner jusqu’à ce qu’une personne lui attribue un nouveau responsable ou le retire.

Ce module est terminé. Votre projet est identique à l’instantané end-of-m03. Il contient six enregistrements et cinq applications avec leurs propres identifiants d’accès. Sa passerelle refuse tout appel sans jeton valide et sans enregistrement actif. Vous pouvez maintenant dire qui est chaque agent, ce qu’il peut faire et qui en est responsable. Mais la passerelle vérifie seulement qui appelle et quelle capacité est demandée. Elle ne consigne pas encore le coût de chaque appel, n’arrête pas les boucles et ne résiste pas aux pannes partielles. Ensuite, dans le module 4, nous construisons le parcours complet de la passerelle de modèles.

Leçon suivante : Une seule porte pour les appels de modèles