Sortie structurée et appel d'outils
Les données structurées aident le logiciel à lire une réponse, mais la structure et la signification nécessitent une validation.
Ce que vous apprendrez
- Expliquez : le modèle propose, l'outil exécute
- Appliquez l'idée dans un exemple : sortie structurée et appel d'outil
- Reconnaître les limites et vérifier le résultat de l'exercice
Les données structurées aident le logiciel à lire une réponse, mais la structure et la signification nécessitent une validation.
Vous pouvez suivre ce cours sans compte ni programmation. Les exemples utilisent des données synthétiques et les résultats de l’IA doivent être vérifiés.
Comment ça marche, étape par étape
Le modèle propose, l'outil exécute
L'appel d'outil produit une demande d'appel avec un nom et des arguments. L'application valide le schéma, les autorisations et les limites avant exécution. Le résultat revient au contexte pour l'étape suivante. Par exemple, get_product_stock prend un SKU et renvoie une quantité ; sa description doit expliquer qu'il ne réserve pas de produits. Distinguez les résultats vides, les erreurs de validation, les accès manquants et les délais d’attente. Un JSON valide ne prouve pas que les arguments sont corrects ou que l'action est autorisée. Pour les effets externes, envisagez également une exécution en double.
Une instruction est un contrat
Une bonne invite spécifie la tâche, les données disponibles, le format de sortie et les critères de réussite. Séparez le rôle des données et incluez un exemple pour les cas ambigus. « Soyez précis » est plus faible que « indiquez uniquement le délai dans la politique fournie ; s'il manque, demandez des éclaircissements ». Quelques plans signifient quelques exemples résolus, pas une liste interminable. Le contenu du document reste une donnée même lorsqu'il contient des commandes. Les délimiteurs sont utiles, mais le logiciel doit appliquer les autorisations et la validation plutôt que de s'appuyer sur l'invite.
Vérifier l'accès avant utilisation
Les autorisations doivent être appliquées par les serveurs et la couche de données. Ne laissez pas le modèle décider si un utilisateur peut voir un document. Filtrez les sources avant qu'elles n'entrent dans le contexte, et non après avoir généré la réponse. Utilisez des informations d'identification à accès minimal, gardez-les à l'écart des invites, des captures d'écran et du code du navigateur, et faites pivoter les clés exposées. Une liste blanche de domaines de widgets ne remplace pas l'authentification API. L'authentification vous identifie ; l’autorisation détermine les opérations et les données que vous pouvez utiliser. Test d'accès refusé également.
Le schéma explicatif
Suivez les flèches pleines pour le flux principal. Les flèches bleues en pointillés fournissent des données ou un contexte ; les flèches roses en pointillés affichent des commentaires ou des résultats renvoyés. Les couleurs et les formes distinguent les modèles, les magasins, les décisions et les sorties. Sur un petit écran, faites défiler horizontalement pour suivre le schéma complet.
Un exemple complet
Un classificateur renvoie la catégorie et les needs_review. JSON aveccategory="refund_now" est syntaxiquement valide mais viole les catégories autorisées et n'autorise pas de remboursement.
{"category":"returns","needs_review":false}
Essayez-le vous-même
- Définissez un schéma et testez une catégorie inconnue et un champ manquant.
- Enregistrez l’entrée, la source et le résultat attendu avant d’exécuter l’expérience. Utilisez uniquement les données fictives de l'exemple.
- Suivez les étapes du diagramme. À chaque étape, enregistrez les informations reçues et produites ; ne confondez pas le résultat intermédiaire avec le résultat final.
- Répétez après avoir supprimé les informations nécessaires ou rendu la saisie ambiguë. Vérifiez si le système clarifie, arrête ou invente une réponse.
- Comparez avec la solution expliquée. Conservez la configuration, la date, le résultat et une explication des différences. Changez une chose et retestez.
Une solution expliquée
Le validateur n'accepte que la livraison, les retours ou le produit et un booléen ; les actions restent séparées. Un exercice réussi vous permet de montrer le lien entre les contributions, les étapes et les résultats. Lorsqu’une information manque, une réponse prudente est plus utile que des détails inventés. Comparez bien plus que le style : vérifiez également les conditions, les sources et les opérations.
Quand cette approche est utile et quelles sont ses limites
JSON syntaxiquement correct n’est pas sémantiquement correct. Choisissez cette approche lorsqu’elle améliore un besoin mesuré. Gardez une base de référence simple et comparez les résultats en utilisant des entrées identiques. Un exemple réussi n’établit pas la fiabilité dans toutes les situations.
Vérifiez vos connaissances
Qui exécute un appel proposé par le modèle ?
L'application ou le service hôte après validation. Le modèle n'obtient pas automatiquement un accès illimité.
Une invite peut-elle remplacer le contrôle d’accès ?
Non. Une instruction n’est pas une limite d’autorisation.
Quel résultat cet exercice devrait-il produire ?
Le validateur n'accepte que la livraison, les retours ou le produit et un booléen ; les actions restent séparées.
Les mots à retenir
- Appel d'outil: Une demande structurée pour utiliser une capacité externe.
- Quelques coups: Exemples résolus fournis en contexte.
- Autoriser / Autorisation: Vérification du droit d'accès à une opération ou une ressource.
Sources et votre prochaine étape
Pour préparer : P04 — Comment choisir un modèle d'IA adapté