Aanbevolen procedures voor hulpprogramma's voor Microsoft Foundry Agent Service

Wanneer u agents in Microsoft Foundry Agent Service bouwt, breiden de hulpprogramma's uit wat uw agent kan doen: informatie ophalen, API's aanroepen en verbinding maken met externe services. Dit artikel helpt u bij het effectief configureren van hulpprogramma's, bepalen wanneer de agent deze aanroept en uw gegevens veilig te houden.

Tip

In de instructies van uw agent beschrijft u waar elk hulpprogramma voor is en wanneer u het moet gebruiken. Bijvoorbeeld:

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.

Voorwaarden

  • Toegang tot een Foundry-project in de Foundry-portal met de rol of gelijkwaardige machtigingen van de Azure AI Developer.
  • Een model dat in hetzelfde project is geïmplementeerd.
  • Alle vereiste verbindingen die zijn geconfigureerd voor de hulpprogramma's die u wilt gebruiken (bijvoorbeeld Azure AI Zoeken, SharePoint of Bing-gronding).

Hulpprogrammagebruik configureren en valideren

  • Hulpprogramma's en verbindingen configureren in de foundry-hulpprogrammacatalogus. Zie Hulpprogramma's ontdekken en beheren in de foundry-hulpprogrammacatalogus (preview).a0>
  • Controleer uitvoeringstraceringen om te bevestigen wanneer uw agent hulpprogramma's aanroept en om invoer en uitvoer van hulpprogramma's te controleren. Zie Uw toepassing traceren voor end-to-end-tracering.

Betrouwbaarheid van het aanroepen van hulpprogramma's verbeteren

Aanroepen van besturingshulpprogramma's met tool_choice

Gebruik tool_choice deze functie voor de meest deterministische controle over het aanroepen van hulpprogramma's.

  • auto: Het model bepaalt of hulpprogramma's moeten worden aangeroepen.
  • required: Het model moet een of meer hulpprogramma's aanroepen.
  • none: Het model roept geen hulpprogramma's aan.

Zie voor meer informatie tool_choice in Foundry project REST (preview).

Effectieve instructies voor hulpprogramma's schrijven

  • Houd de instructies specifiek en consistent met de installatie van uw hulpprogramma.
  • Vertel het model waarvoor elk hulpprogramma is bedoeld.
  • Als u meerdere hulpprogramma's hebt die elkaar overlappen, voegt u een beslissingsregel toe (bijvoorbeeld 'Bestandszoekopdracht gebruiken voor zoeken op internet voor interne inhoud.'

Gebruik van beveiligde hulpprogramma's

Hulpprogramma's verzenden en ontvangen gegevens buiten het model. Beperk beveiligings- en privacyrisico's met deze procedures:

  • Het hulpprogramma wordt uitgevoerd als niet-vertrouwde invoer en valideert kritieke waarden voordat u erop ingaat.
  • Alleen de gegevens verzenden die nodig zijn om de taak te voltooien.
  • Neem geen sleutels, tokens of andere referenties op in prompts.
  • Vermijd logboekregistratie van geheimen in traceringen of toepassingslogboeken.
  • Als u verbinding maakt met niet-Microsoft-services (bijvoorbeeld MCP-servers van derden), bekijkt u de overwegingen in Discover en beheer van hulpprogramma's in de foundry-hulpprogrammacatalogus (preview).
  • Zie Hulpprogramma's beheren met AI Gateway (preview) als u gecentraliseerde routering en beleidsafdwinging voor MCP-hulpprogramma's nodig hebt.

Hulpprogramma-ondersteuning per regio en model

Regio en model bepalen welke hulpprogramma's beschikbaar zijn voor uw agent.

Opmerking

In de onderstaande tabellen: Ja betekent volledig ondersteund, Nee betekent niet ondersteund en Beperkt betekent gedeeltelijke ondersteuning die verschilt per configuratie van het hulpprogramma. Raadpleeg de documentatie voor afzonderlijke hulpprogramma's voor meer informatie.

In de volgende tabel ziet u de beschikbaarheid van hulpprogramma's per regio.

Opmerking

Deze beschikbaarheidstabel regio's zijn alleen accounts voor service-beschikbaarheid. U moet ervoor zorgen dat het model dat u wilt gebruiken ook beschikbaar is in dezelfde regio.

Regionaam Agent2Agent Azure AI Zoeken Browserautomatisering Code-interpreter Computergebruik Fabric gegevensagent Zoeken naar bestanden Functie Grounding met Bing Custom Search Grounding met Bing Search Generatie van installatiekopieën MCP OpenAPI SharePoint Zoeken op internet
australiaeast Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
brazilsouth Ja Ja Ja Ja No Ja Ja No Ja Ja Ja Ja Ja Ja Ja
canadaeast Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
eastus Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
eastus2 Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
francecentral Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
germanywestcentral Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
italiënorth Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
japaneast Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
koreacentral Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
northcentralus Ja Ja Ja Ja No Ja Ja No Ja Ja Ja Ja Ja Ja Ja
noorwegeneast Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
Polencentral Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
southafricanorth Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
southcentralus Ja Ja Ja No No Ja Ja No Ja Ja Ja Ja Ja Ja Ja
southeastasia Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
southindia Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
spaincentral Ja Ja Ja No No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
swedencentral Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
zwitserlandnorth Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
uaenorth Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
uksouth Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja
westus Ja Ja Ja Ja No Ja Ja No Ja Ja Ja Ja Ja Ja Ja
westus3 Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja Ja Ja

Hulpprogramma's worden ondersteund door de volgende modellen.

Opmerking

Voor het hulpprogramma voor het genereren van installatiekopieën hebt u zowel het gpt-image-1-model als een LLM (Large Language Model) nodig als de orchestrator in hetzelfde Microsoft Foundry-project.

Model Agent2Agent Azure AI Zoeken Azure Functions Bing Aangepaste aarding Grounding Bing Search Browserautomatisering Code-interpreter Computergebruik Fabric gegevensagent Zoeken naar bestanden Functies Generatie van installatiekopieën MCP OpenAPI SharePoint Zoeken op internet
Cohere-command-r No No No No No No Ja No No Ja No No No No No No
Cohere-command-r-plus No No No No No No Ja No No Ja No No No No No No
DeepSeek-R1-0528 No No No No No No Ja No No Ja No No No No No No
DeepSeek-V3-0324 No Ja No Ja Ja Ja Ja No Ja Ja Ja No Ja Ja Ja No
DeepSeek-V3.1 No No No Ja Ja Ja Ja No Ja Ja Ja No Ja Ja Ja No
FW-DeepSeek-V3.1 No Ja No No No No Ja No Ja Ja No No Ja Ja No No
FW-DeepSeek-V3.2 No Ja No No No No Ja No Ja Ja No No Ja Ja No No
FW-GLM-4.7 No Ja No No No No Ja No Ja Ja No No Ja Ja No No
FW-GLM-5 No Ja No No No No Ja No Ja Ja No No Ja Ja No No
FW-GPT-OSS-120B No Ja No No No No Ja No Ja Ja No No Ja Ja No No
FW-Kimi-K2-Instruct-0905 No Ja No No No No Ja No Ja Ja No No Ja Ja No No
FW-Kimi-K2-Thinking No Ja No No No No Ja No Ja Ja No No Ja Ja No No
FW-Kimi-K2.5 No No No No No No Ja No Ja Ja No No Ja Ja No No
FW-MiniMax-M2.5 No Ja No No No No Ja No Ja Ja No No Ja Ja No No
FW-Qwen3.5-122B-A10B No Ja No No No No Ja No Ja Ja No No Ja Ja No Ja
FW-Qwen3.5-397B-A17B No Ja No No No No Ja No Ja Ja No No Ja Ja No Ja
Llama-3.3-70B-Instruct No Ja No Ja Ja Ja Ja No Ja Ja Ja No Ja Ja Ja Ja
Llama-4-Maverick-17B-128E-Instruct-FP8 No No No No No No Ja No No Ja No No No No No No
Llama-4-Scout-17B-16E-Instruct No No No No No No Ja No No Ja No No No No No No
MAI-DS-R1 Ja No No No No Ja Ja No No Ja Ja No Ja No No No
Meta-Llama-3.1-405B-Instruct No No No No No No Ja No No Ja No No No No No No
Mistral-large-2407 No No No No No No Ja No No Ja No No No No No No
codex-mini No No No No No No Ja No No Ja No No No No No No
computergebruik-preview No No No No No No No Ja No No No No No No No No
gpt-35-turbo No No No No No No Ja No No Ja No No No No No No
gpt-4 No No No No No No Ja No No Ja No No No No No No
gpt-4.1 Ja Ja No Ja Ja Ja Ja No Ja Ja Ja No Ja Ja Ja Ja
gpt-4.1-mini Ja Ja No Ja Ja Ja Ja No Ja Ja Ja No Ja Ja Ja Ja
gpt-4.1-nano Ja Ja No Ja Ja Ja Ja No Ja Ja Ja No Ja Ja Ja Ja
gpt-4.5-preview No No No No No No Ja No No Ja No No No No No No
gpt-4o Ja Ja No Ja Ja Ja Ja No Ja Ja Ja No Ja Ja Ja Ja
gpt-4o-mini Ja No No Ja Ja Ja Ja No Ja Ja Ja No Ja Ja Ja Ja
gpt-5 Ja Ja No Ja Ja Ja Ja No Ja Ja Ja Ja Ja Ja Ja Ja
gpt-5-chat No No No No No No Ja No No Ja No No No No No No
gpt-5-codex No No No No No No Ja No No Ja No No Ja No No No
gpt-5-mini No No No No No No Ja No No Ja No No Ja No No Ja
gpt-5-nano No No No No No No Ja No No Ja No No No No No No
gpt-5-pro No No No No No No Ja No No Ja No No No No No No
gpt-5.1 No Ja Ja No Ja No Ja No Ja Ja Ja No Ja Ja Ja Ja
gpt-5.1-chat No No No No No No Ja No No Ja No No No No No No
gpt-5.1-codex No No No No No No Ja No No Ja No No Ja No No No
gpt-5.1-codex-max No No No No No No Ja No No Ja No No No No No No
gpt-5.1-codex-mini No No No No No No Ja No No Ja No No No No No No
gpt-5.2 No Ja Ja No Ja No Ja No Ja Ja Ja No Ja Ja Ja Ja
gpt-5.2-chat Ja Ja No Ja Ja Ja Ja No Ja Ja Ja No Ja Ja No Ja
gpt-5.2-codex No No No No No No Ja No No Ja No No Ja No No No
gpt-5.3-chat Ja Ja No Ja Ja Ja Ja No Ja Ja No No Ja Ja Ja Ja
gpt-5.3-codex Ja Ja No Ja Ja Ja Ja No Ja Ja No No Ja Ja Ja Ja
gpt-5.4 Ja Ja No Ja Ja Ja Ja No Ja Ja No No Ja Ja Ja Ja
gpt-5.4-mini Ja Ja No Ja Ja Ja Ja No Ja Ja No No Ja Ja Ja Ja
gpt-5.4-nano Ja Ja No Ja Ja Ja Ja No Ja Ja No No Ja Ja Ja Ja
gpt-5.4-pro Ja Ja No Ja Ja Ja Ja No Ja Ja No No Ja Ja Ja Ja
gpt-5.5 Ja Ja No Ja Ja Ja Ja No Ja Ja No No Ja Ja Ja Ja
gpt-oss-120b No No No No No No Ja No No Ja Ja No Ja No No No
grok-3 No Ja No Ja Ja Ja Ja No Ja Ja Ja No Ja Ja Ja No
grok-3-mini No No No No No No Ja No No Ja No No No No No No
grok-4 No No No No No No Ja No No Ja No No No No No No
grok-4-1-fast-non-reasoning No No No No No No Ja No No Ja No No No No No No
grok-4-1-fast-reasoning No No No No No No Ja No No Ja No No No No No No
grok-4-20-niet-redeneren No Ja No Ja Ja Ja Ja No Ja Ja Ja No Ja Ja Ja Ja
grok-4-20-reasoning No Ja No Ja Ja Ja Ja No Ja Ja Ja No Ja Ja Ja Ja
grok-4-fast-non-reasoning No No No No No No Ja No No Ja No No No No No No
grok-4-fast-reasoning No No No Ja No Ja Ja No No Ja Ja No Ja No No No
mistral-small-2503 No No No No No No Ja No No Ja No No No No No No
model-router No No No Ja Ja Ja Ja No Ja Ja Ja No Ja Ja Ja No
o1 No Ja No Ja No Ja Ja No No Ja Ja No Ja No Ja Ja
o1-mini No No No No No No Ja No No Ja No No No No No No
o1-preview No No No No No No Ja No No Ja No No No No No No
o3 Ja Ja No Ja No Ja Ja No Ja Ja Ja No Ja Ja No Ja
o3-deep-research No No No No No No No No No No No No Ja No No Ja
o3-mini Ja No No Ja Ja Ja Ja No Ja Ja No No No No No No
o3-pro No No No No No No Ja No No Ja No No No No No No
o4-mini Ja No No Ja Ja Ja Ja No Ja Ja Ja No Ja No Ja Ja

Probleemoplossing

Gebruik deze controles om veelvoorkomende problemen op te lossen:

  • Uw agent roept geen hulpprogramma aan:
    • Controleer of het hulpprogramma is gekoppeld aan de agent.
    • Controleer of het model het hulpprogramma ondersteunt.
    • Als u deterministisch gedrag nodig hebt, stelt u deze in tool_choice op required.
    • Bekijk uitvoeringstraceringen om te controleren of het model een hulpprogramma-aanroep heeft geproduceerd.
  • Aanroepen van hulpprogramma's retourneren lege of irrelevante resultaten:
    • Beschrijvingen van hulpprogramma's en agentinstructies verbeteren.
    • Voor het ophalen van hulpprogramma's moet u ervoor zorgen dat uw gegevens worden opgenomen en doorzoekbaar zijn.
  • Aanroepen van hulpprogramma's mislukken:
    • Configuratie en verificatie van hulpprogramma's controleren.
    • Controleer voor MCP- en OpenAPI-hulpprogramma's of het eindpunt bereikbaar is en retourneert verwachte antwoorden.

FAQ

Hoe kan ik valideren of een hulpprogramma is aangeroepen?

Controleer uitvoeringstraceringen om te controleren of uw agent een hulpprogramma heeft aangeroepen en om de invoer en uitvoer van het hulpprogramma te controleren. Zie Uw toepassing traceren voor end-to-end-tracering.

Hoe kan ik het gebruik van hulpprogramma's betrouwbaarder maken?

Begin met duidelijke instructies voor het hulpprogramma. Als u het aanroepen van deterministische hulpprogramma's nodig hebt, gebruikt u tool_choice. Zie Het besturingselement waarmee wordt aangeroepen voor tool_choicemeer informatie.

Verwante inhoud

Hulpprogrammabeheer

Hulpprogramma's ophalen en zoeken

Hulpprogramma's voor gegevens en integratie

Hulpprogramma's voor automatisering en generatie

  • Last updated on