Meilleures pratiques relatives aux outils pour Microsoft Foundry Agent Service

Lorsque vous générez des agents dans Microsoft Service De l’agent Foundry, les outils étendent ce que votre agent peut faire, en récupérant des informations, en appelant des API et en se connectant à des services externes. Cet article vous aide à configurer efficacement les outils, à contrôler le moment où l’agent les appelle et à sécuriser vos données.

Conseil

Dans les instructions de votre agent, décrivez ce que chaque outil est pour et quand l’utiliser. Par exemple :

When you need information from my indexed documents, use File Search. When you need to call an API, use the OpenAPI tool. When a tool call fails or returns no results, explain what happened and ask a follow-up question.

Conditions préalables

  • Accès à un projet Foundry dans le portail Foundry avec le rôle Azure AI Developer ou des autorisations équivalentes.
  • Modèle déployé dans le même projet.
  • Toutes les connexions requises configurées pour les outils que vous prévoyez d’utiliser (par exemple, Recherche Azure AI, SharePoint ou Bing grounding).
  • Un modèle et une région de projet qui prennent tous deux en charge l’outil. Consultez la prise en charge des outils par région et par modèle.

Configurer et valider l’utilisation de l’outil

Améliorer la fiabilité des appels d’outils

Contrôler l’appel d’outils avec tool_choice

Utiliser tool_choice pour le contrôle le plus déterministe sur l’appel d’outils.

  • auto: le modèle décide s’il faut appeler des outils.
  • required: le modèle doit appeler un ou plusieurs outils.
  • none: le modèle n’appelle pas d’outils.

Pour plus d’informations, consultez tool_choice la référence REST du projet Foundry.

Écrire des instructions efficaces sur l’outil

  • Conservez des instructions spécifiques et cohérentes avec la configuration de votre outil.
  • Indiquez le modèle pour lequel chaque outil est destiné.
  • Si vous avez plusieurs outils qui se chevauchent, ajoutez une règle de décision (par exemple, « Utiliser la recherche de fichiers avant la recherche de contenu interne »).

Sécuriser l’utilisation des outils

Les outils envoient et reçoivent des données en dehors du modèle. Réduisez les risques de sécurité et de confidentialité avec ces pratiques :

  • Traitez les sorties de l’outil comme une entrée non approuvée et validez les valeurs critiques avant d’agir dessus.
  • Validez les sorties structurées par rapport à un schéma attendu, autorisez uniquement les champs et opérations connus et exigez l’approbation de l’utilisateur avant les actions consécutives.
  • Envoyez uniquement les informations requises pour terminer la tâche.
  • N’incluez pas de clés, de jetons ou d’autres informations d’identification dans les invites.
  • Évitez de consigner des secrets dans les traces ou les journaux d’application.
  • Si vous vous connectez à des serveurs MCP non services Microsoft (par exemple, des serveurs MCP tiers), passez en revue les considérations relatives à la gestion des données dans Créer et gérer une boîte à outils dans Foundry.
  • Si vous avez besoin d’un routage centralisé et d’une application de stratégie pour les outils MCP, consultez Gouvernance des outils avec AI Gateway (préversion) .

Dépannage

Utilisez ces vérifications pour résoudre les problèmes courants :

  • Votre agent n’utilise aucun outil :
    • Vérifiez que l’outil est attaché à l’agent.
    • Vérifiez que le modèle prend en charge l’outil.
    • Si vous avez besoin d’un comportement déterministe, définissez tool_choice sur required.
    • Passez en revue les traces pour vérifier si le modèle a produit un appel d’outil.
  • Les appels d’outil retournent des résultats vides ou non pertinents :
    • Améliorez les descriptions des outils et les instructions de l’agent.
    • Pour les outils de recherche, assurez-vous que vos données sont importées et peuvent être recherchées.
  • Les appels d’outils échouent :
    • Vérifiez la configuration et l’authentification des outils.
    • Pour les outils MCP et OpenAPI, vérifiez que le point de terminaison est accessible et retourne les réponses attendues.
  • Foundry renvoie une erreur « outil non pris en charge » même si les tableaux indiquent qu’il est pris en charge :
    • La disponibilité des outils nécessite la prise en charge par le modèle et la région. Vérifiez la table de disponibilité de la région pour votre région et la table de prise en charge du modèle pour votre modèle. Si l’un ou l’autre tableau s’affiche No, l’outil ne peut pas s’exécuter, même si l’autre table s’affiche Yes.
    • Vérifiez que le modèle est réellement déployé dans le projet et la région que vous ciblez. Un modèle qui prend en charge un outil en général peut ne pas être déployé dans chaque région.
    • Essayez une autre région ou un déploiement de modèle différent qui prend en charge l’outil. Par exemple, Code Interpreter ne s’exécute pas dans les régions qui affichent no pour Code Interpreter (comme southcentralus et spaincentral), quel que soit le modèle que vous utilisez.

FAQ

Comment vérifier si un outil a été appelé ?

Passez en revue les traces pour vérifier si votre agent a appelé un outil et pour inspecter les entrées et sorties de l’outil. Pour obtenir des instructions de configuration, consultez Configurer le traçage pour les agents Foundry.

Comment rendre l’utilisation des outils plus fiable ?

Commencez par des instructions claires pour l’outil. Si vous avez besoin d’un appel d’outil déterministe, utilisez tool_choice. Pour plus d’informations, consultez Contrôle l’outil de gestion des appels avec tool_choice.

Contenu connexe

Gestion des outils

Outils de récupération et de recherche

Outils d’intégration et de données

Outils d’automatisation et de génération

  • Last updated on