Objectif : distinguer une proposition, une préparation et une exécution réelle. Accès : capacités de lecture et, pour l'application, opération autorisée disponible. Utilisez un workspace de test et une ressource de démonstration.
Ce parcours ne rend pas publique une route d'écriture interne. Choisissez une méthode et un chemin au catalogue publié, ou une action explicitement disponible dans votre interface. Si aucune opération compatible n'est disponible, arrêtez-vous à une proposition documentée.
1. Lire l'état initial
Choisissez la ressource et relevez son identifiant, son workspace, ses valeurs et sa version lorsque le contrat en expose une. Pour Client–Commande, indiquez précisément CMD-001 plutôt que « la dernière commande ACME ».
Notez l'état attendu après l'opération et les effets associés. Une action peut affecter plusieurs ressources ; la portée doit être comprise avant l'application.
2. Préparer les paramètres
Dans l'agent, vérifiez Profil de capacités, Outils et API puis Vérification. Une opération de préparation produit une proposition ou un plan ; elle ne prouve pas que les données ont changé.
Examinez la cible, les champs modifiés, les dépendances et les éventuelles erreurs de validation. Si le contrat propose une prévisualisation, utilisez-la. N'inventez pas un bouton de prévisualisation pour une opération qui n'en dispose pas.
3. Vérifier l'autorisation applicable
Distinguez le droit de lire, celui de préparer et celui d'appliquer. Une instruction de prompt ou une compétence n'accorde aucun de ces droits. Si un flux d'approbation est exigé, utilisez son étape prévue et vérifiez son état avant l'exécution.
Pour les plans d'action et leurs étapes, consultez le SDK et le contrat de l'opération choisie. Une approbation dans la conversation ne remplace pas une approbation enregistrée lorsque le contrat en exige une.
4. Appliquer une fois puis relire
Appliquez uniquement par la capacité autorisée. Conservez l'identifiant d'exécution et la réponse. Relisez la ressource pour comparer l'état final à l'état attendu.
En cas de timeout, ne répétez pas immédiatement une écriture : vérifiez d'abord si l'opération a eu lieu. En cas de conflit de version, relisez l'état actuel et préparez une nouvelle proposition. Utilisez les garanties d'idempotence uniquement lorsqu'elles sont documentées pour cette opération.
Résultat et limites
Le résultat attendu est soit une proposition vérifiée sans modification, soit une exécution autorisée dont les effets ont été contrôlés. Une session d'agent terminée ne prouve pas qu'une action a réussi. Arrêter une session n'annule pas automatiquement une opération déjà réalisée.
Conservez l'état initial, les paramètres validés et la preuve de relecture. Complétez avec Tester et évaluer.
