Aller au contenu

Guide pratique

Configurer les outils

Activez les outils et le contexte que votre agent pourra utiliser lors de ses interactions.

3 min

La Console distingue les instructions, le contexte sélectionné et les capacités effectivement autorisées. Cette distinction vous aide à diagnostiquer un outil absent ou une réponse qui ne s'appuie pas sur les bonnes données.

Avant de commencer

Ouvrez un agent que vous pouvez modifier. Choisissez une mission de lecture et une question dont le résultat est connu. Pour interroger Client et Commande, vérifiez d'abord leurs instances dans le même workspace.

1. Choisir un profil de capacités

Dans Profil de capacités, sélectionnez le profil adapté. Un profil de lecture sert à consulter les données. Les actions approuvées nécessitent un profil et une capacité compatibles ; leur disponibilité dépend du contexte d'exécution.

Les outils proposés sont filtrés par le profil et les autorisations. Le nombre global d'outils du produit ne décrit pas ceux accessibles à votre agent.

2. Sélectionner les outils et API

Dans Outils et API, activez les capacités utiles. Pour une API métier, choisissez une opération publiée et vérifiez son usage autorisé. Une opération de lecture et une opération de préparation d'action ont des effets différents. Le catalogue interne complet n'est pas le contrat public.

BesoinVérification avant test
Lire les commandesType cible, filtres et outil de lecture disponibles
Consulter un contratDocument traité, périmètre de recherche et preuve retournée
Préparer une actionOpération publiée compatible et paramètres vérifiables
Utiliser une compétenceInstructions pertinentes et capacités nécessaires déjà autorisées

La sélection effective est limitée par les capacités autorisées. Cocher une option ne crée pas une permission.

3. Définir le contexte et les sources

Dans Contexte et sources, choisissez le modèle et les documents pertinents. Un contexte restreint améliore le ciblage ; les frontières d'accès reposent sur les permissions et les contrôles du workspace. Une instruction « ne consulte que Client » n'est pas un mécanisme de sécurité.

Pour la mission Client–Commande, précisez comment identifier le client et quelle période examiner. Ajoutez le contrat seulement si la question demande une condition documentaire.

4. Contrôler la configuration appliquée

Enregistrez puis ouvrez Vérification. Comparez les choix du brouillon, la configuration enregistrée et celle réellement appliquée. Distinguez les contraintes imposées des indications consultatives. Les droits sont revérifiés au lancement.

Lancez une lecture et examinez l'appel d'outil dans l'observation : nom de la capacité, arguments, résultat et éventuelle erreur. Si l'outil attendu est absent, vérifiez le profil, la sélection, la publication de l'API et les permissions avant de modifier le prompt.

Résultat attendu

Vous savez expliquer quelles capacités l'agent peut utiliser et vous avez observé leur emploi sur un cas connu. Complétez avec Tester et évaluer et Préparer une action contrôlée.

Cette page vous a-t-elle permis d’atteindre votre objectif ?