Meilleures pratiques d’outil pour Microsoft Service De l’Agent Foundry

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.

Pointe

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 envisagez d’utiliser (par exemple, Recherche Azure AI, SharePoint ou bing).

Configurer et valider l’utilisation de l’outil

Améliorer la fiabilité des appels d’outils

Outil de contrôle appelant 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 le rest du projet Foundry (préversion).

É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.
  • 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 journaliser les secrets dans les journaux d’activité des traces ou des applications.
  • Si vous vous connectez à des serveurs MCP non services Microsoft (par exemple, des serveurs MCP tiers), passez en revue les considérations de Discover et gérez les outils dans le catalogue d’outils Foundry (préversion).
  • 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) .

Prise en charge des outils par région et modèle

La région et le modèle déterminent quels outils sont disponibles pour votre agent.

Note

Dans les tableaux ci-dessous : Oui signifie entièrement pris en charge, Non signifie non pris en charge et limité signifie une prise en charge partielle qui varie selon la configuration de l’outil. Pour plus d’informations, consultez la documentation de l’outil individuel.

Le tableau suivant présente la disponibilité des outils par région.

Note

Cette table de disponibilité de région compte uniquement pour la disponibilité du service. Vous devez vous assurer que le modèle que vous souhaitez utiliser est également disponible dans la même région.

Nom de la région Agent2Agent Recherche Azure AI Browser Automation Interpréteur de code Utilisation de l’ordinateur Fabric Data Agent Recherche de fichiers Fonction Mise à l’aide de la recherche personnalisée Bing Mise à l’terre avec Recherche Bing Génération d’images MCP OpenAPI SharePoint Recherche web
australiaeast Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
brésilsouth Oui Oui Oui Oui non Oui Oui non Oui Oui Oui Oui Oui Oui Oui
canadaeast Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
eastus Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
eastus2 Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
francecentral Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
allemagnewestcentral Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
italynorth Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
japaneast Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
koreacentral Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
northcentralus Oui Oui Oui Oui non Oui Oui non Oui Oui Oui Oui Oui Oui Oui
norvège Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
polognecentral Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
south africanorth Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
southcentralus Oui Oui Oui non non Oui Oui non Oui Oui Oui Oui Oui Oui Oui
sud-estasia Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
southindia Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
spaincentral Oui Oui Oui non non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
suèdecentral Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
suissenorth Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
uaenorth Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
uksouth Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui
westus Oui Oui Oui Oui non Oui Oui non Oui Oui Oui Oui Oui Oui Oui
westus3 Oui Oui Oui Oui non Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui

Les outils sont pris en charge par les modèles suivants.

Note

Pour l’outil de génération d’images, vous avez besoin du modèle gpt-image-1 et d’un modèle de langage volumineux (LLM) comme orchestrateur dans le même projet Microsoft Foundry.

Modèle Agent2Agent Recherche Azure AI Azure Functions Mise à l’aide d’une base personnalisée Bing Recherche Bing à la base Browser Automation Interpréteur de code Utilisation de l’ordinateur Fabric Data Agent Recherche de fichiers Fonctions Génération d’images MCP OpenAPI SharePoint Recherche web
Cohere-command-r Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
Cohere-command-r-plus Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
DeepSeek-R1-0528 Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
DeepSeek-V3-0324 Non Oui Non Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Oui Non
DeepSeek-V3.1 Non Non Non Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Oui Non
FW-DeepSeek-V3.1 Non Oui Non Non Non Non Oui Non Oui Oui Non Non Oui Oui Non Non
FW-DeepSeek-V3.2 Non Oui Non Non Non Non Oui Non Oui Oui Non Non Oui Oui Non Non
FW-GLM-4.7 Non Oui Non Non Non Non Oui Non Oui Oui Non Non Oui Oui Non Non
FW-GLM-5 Non Oui Non Non Non Non Oui Non Oui Oui Non Non Oui Oui Non Non
FW-GPT-OSS-120B Non Oui Non Non Non Non Oui Non Oui Oui Non Non Oui Oui Non Non
FW-Kimi-K2-Instruct-0905 Non Oui Non Non Non Non Oui Non Oui Oui Non Non Oui Oui Non Non
FW-Kimi-K2-Thinking Non Oui Non Non Non Non Oui Non Oui Oui Non Non Oui Oui Non Non
FW-Kimi-K2.5 Non Non Non Non Non Non Oui Non Oui Oui Non Non Oui Oui Non Non
FW-MiniMax-M2.5 Non Oui Non Non Non Non Oui Non Oui Oui Non Non Oui Oui Non Non
FW-Qwen3.5-122B-A10B Non Oui Non Non Non Non Oui Non Oui Oui Non Non Oui Oui Non Oui
FW-Qwen3.5-397B-A17B Non Oui Non Non Non Non Oui Non Oui Oui Non Non Oui Oui Non Oui
Llama-3.3-70B-Instruct Non Oui Non Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Oui Oui
Llama-4-Maverick-17B-128E-Instruct-FP8 Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
Llama-4-Scout-17B-16E-Instruct Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
MAI-DS-R1 Oui Non Non Non Non Oui Oui Non Non Oui Oui Non Oui Non Non Non
Meta-Llama-3.1-405B-Instruct Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
Mistral-large-2407 Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
codex-mini Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
computer-use-preview Non Non Non Non Non Non Non Oui Non Non Non Non Non Non Non Non
gpt-35-turbo Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
gpt-4 Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
gpt-4.1 Oui Oui Non Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Oui Oui
gpt-4.1-mini Oui Oui Non Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Oui Oui
gpt-4.1-nano Oui Oui Non Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Oui Oui
gpt-4.5-preview Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
gpt-4o Oui Oui Non Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Oui Oui
gpt-4o-mini Oui Non Non Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Oui Oui
gpt-5 Oui Oui Non Oui Oui Oui Oui Non Oui Oui Oui Oui Oui Oui Oui Oui
gpt-5-chat Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
gpt-5-codex Non Non Non Non Non Non Oui Non Non Oui Non Non Oui Non Non Non
gpt-5-mini Non Non Non Non Non Non Oui Non Non Oui Non Non Oui Non Non Oui
gpt-5-nano Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
gpt-5-pro Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
gpt-5.1 Non Oui Oui Non Oui Non Oui Non Oui Oui Oui Non Oui Oui Oui Oui
gpt-5.1-chat Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
gpt-5.1-codex Non Non Non Non Non Non Oui Non Non Oui Non Non Oui Non Non Non
gpt-5.1-codex-max Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
gpt-5.1-codex-mini Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
gpt-5.2 Non Oui Oui Non Oui Non Oui Non Oui Oui Oui Non Oui Oui Oui Oui
gpt-5.2-chat Oui Oui Non Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Non Oui
gpt-5.2-codex Non Non Non Non Non Non Oui Non Non Oui Non Non Oui Non Non Non
gpt-5.3-chat Oui Oui Non Oui Oui Oui Oui Non Oui Oui Non Non Oui Oui Oui Oui
gpt-5.3-codex Oui Oui Non Oui Oui Oui Oui Non Oui Oui Non Non Oui Oui Oui Oui
gpt-5.4 Oui Oui Non Oui Oui Oui Oui Non Oui Oui Non Non Oui Oui Oui Oui
gpt-5.4-mini Oui Oui Non Oui Oui Oui Oui Non Oui Oui Non Non Oui Oui Oui Oui
gpt-5.4-nano Oui Oui Non Oui Oui Oui Oui Non Oui Oui Non Non Oui Oui Oui Oui
gpt-5.4-pro Oui Oui Non Oui Oui Oui Oui Non Oui Oui Non Non Oui Oui Oui Oui
gpt-5.5 Oui Oui Non Oui Oui Oui Oui Non Oui Oui Non Non Oui Oui Oui Oui
gpt-oss-120b Non Non Non Non Non Non Oui Non Non Oui Oui Non Oui Non Non Non
grok-3 Non Oui Non Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Oui Non
grok-3-mini Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
grok-4 Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
grok-4-1-fast-non-raisonnement Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
grok-4-1-fast-raisonnement Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
grok-4-20-non-raisonnement Non Oui Non Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Oui Oui
grok-4-20-raisonnement Non Oui Non Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Oui Oui
grok-4-fast-non-raisonnement Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
grok-4-fast-reasoning Non Non Non Oui Non Oui Oui Non Non Oui Oui Non Oui Non Non Non
mistral-small-2503 Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
model-router Non Non Non Oui Oui Oui Oui Non Oui Oui Oui Non Oui Oui Oui Non
o1 Non Oui Non Oui Non Oui Oui Non Non Oui Oui Non Oui Non Oui Oui
o1-mini Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
o1-preview Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
o3 Oui Oui Non Oui Non Oui Oui Non Oui Oui Oui Non Oui Oui Non Oui
o3-deep-research Non Non Non Non Non Non Non Non Non Non Non Non Oui Non Non Oui
o3-mini Oui Non Non Oui Oui Oui Oui Non Oui Oui Non Non Non Non Non Non
o3-pro Non Non Non Non Non Non Oui Non Non Oui Non Non Non Non Non Non
o4-mini Oui Non Non Oui Oui Oui Oui Non Oui Oui Oui Non Oui Non Oui Oui

Dépannage

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

  • Votre agent n’appelle pas d’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éfini sur tool_choicerequired.
    • Passez en revue les traces d’exécution 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 récupération, vérifiez que vos données sont ingérées et pouvant faire l’objet d’une recherche.
  • 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.

FAQ

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

Passez en revue les traces d’exécution pour vérifier si votre agent a appelé un outil et pour inspecter les entrées et sorties de l’outil. Pour connaître la configuration du suivi de bout en bout, consultez Tracer votre application.

Comment rendre l’utilisation des outils plus fiable ?

Commencez par effacer les instructions de l’outil. Si vous avez besoin d’un appel d’outil déterministe, utilisez tool_choice. Pour plus d’informations, consultez l’outil Contrôle appelant 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