Lab 023: Outils et mémoire dans Microsoft Agent Framework¶
Phase 3 · local first
Le parcours obligatoire est déterministe et local. Le parcours Réel est facultatif, estimé et nettoyé.
Ce que vous apprendrez¶
- Exposer des outils typés avec autorisation explicite
- Utiliser une mémoire courte et durable bornée
- Remplacer les planners SK obsolètes par une orchestration explicite
- Tester injection et isolation de mémoire
Prérequis¶
- Python 3.10+ et un terminal
- Aucun identifiant pour le parcours obligatoire
- Lisez la spécification officielle avant un adaptateur hébergé
Modèle visuel¶
flowchart LR
A[MAF Agent] --> P[Policy]
P --> T[Typed tools]
P --> S[Session memory]
P --> D[Durable store]
T --> E[Evidence]
Scénario¶
OutdoorGear a besoin d'une implémentation révisable pour atelier, avec fixtures déterministes, frontières de confiance explicites, critères mesurables et adaptateur hébergé facultatif et réversible.
Exercice guidé¶
Step 1: define_tools¶
- Exécutez la fixture déterministe de cette étape.
- Notez entrée, sortie, décision de politique et comportement d'échec.
- Modifiez un comportement borné et relancez le test local.
Evidence: Conservez la commande, le résultat et une phrase expliquant pourquoi la preuve est fiable.
Step 2: bound_memory¶
- Exécutez la fixture déterministe de cette étape.
- Notez entrée, sortie, décision de politique et comportement d'échec.
- Modifiez un comportement borné et relancez le test local.
Evidence: Conservez la commande, le résultat et une phrase expliquant pourquoi la preuve est fiable.
Step 3: route_explicitly¶
- Exécutez la fixture déterministe de cette étape.
- Notez entrée, sortie, décision de politique et comportement d'échec.
- Modifiez un comportement borné et relancez le test local.
Evidence: Conservez la commande, le résultat et une phrase expliquant pourquoi la preuve est fiable.
Step 4: red_team¶
- Exécutez la fixture déterministe de cette étape.
- Notez entrée, sortie, décision de politique et comportement d'échec.
- Modifiez un comportement borné et relancez le test local.
Evidence: Conservez la commande, le résultat et une phrase expliquant pourquoi la preuve est fiable.
Exécuter localement¶
Simulation / Parcours Réel¶
Kit d'accompagnement¶
Le build du site génère des téléchargements PDF et ZIP stables. La CI conserve aussi un miroir temporaire pendant 30 jours.
README.md: démarrage et preuvesCHEATSHEET.md: guide de décisionscenario.json: contrat déterministetest_scenario.py: tests locaux- Télécharger le PDF généré
- Télécharger le ZIP généré
Quiz noté¶
Pourquoi garder un contrat local ?
Réponse
Il fournit une base déterministe avant la variabilité et le coût hébergés.
Quand le parcours Réel est-il terminé ?
Réponse
Après enregistrement des preuves de validation et de nettoyage.
Comment traiter la sortie des outils ?
Réponse
Comme donnée non fiable avant validation de politique et de schéma.
Critères de sortie¶
- Les tests locaux passent sans identifiants.
- Le diagramme a une explication textuelle et ne dépend pas de la couleur.
- Le quiz noté a été revu.
- Le parcours Réel a un plafond et un plan de nettoyage.
- Sources et stabilité ont été vérifiées.