Aanbevolen procedures voor hulpmiddelen 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).
  • Een model en projectregio die beide ondersteuning bieden voor het hulpprogramma. Zie Hulpprogramma-ondersteuning per regio en model.

Hulpprogrammagebruik configureren en valideren

Betrouwbaarheid van het aanroepen van hulpprogramma's verbeteren

Beheer het aanroepen van tools 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 in de tool_choice voor meer informatie.

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:

  • Behandel tooluitvoer als niet-vertrouwde invoer en valideer kritieke waarden voordat u erop handelt.
  • Valideer gestructureerde uitvoer op basis van een verwacht schema, sta alleen bekende velden en bewerkingen toe en vereist goedkeuring van gebruikers voor gevolgacties.
  • Alleen de gegevens verzenden die nodig zijn om de taak te voltooien.
  • Neem geen sleutels, tokens of andere referenties op in prompts.
  • Vermijd het loggen van gevoelige gegevens in traces of applicatielogboeken.
  • Als u verbinding maakt met niet-Microsoft-services (bijvoorbeeld MCP-servers van derden), bekijkt u de aandachtspunten voor gegevensverwerking in Een toolbox maken en beheren in Foundry.
  • Zie Hulpprogramma's beheren met AI Gateway (preview) als u gecentraliseerde routering en beleidsafdwinging voor MCP-hulpprogramma's nodig hebt.

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, stel tool_choice dan in op required.
    • Controleer traces om te bevestigen of het model een tooloproep heeft gedaan.
  • Aanroepen van hulpprogramma's retourneren lege of irrelevante resultaten:
    • Beschrijvingen van hulpprogramma's en agentinstructies verbeteren.
    • Voor zoekhulpmiddelen: zorg ervoor dat uw gegevens zijn geïmporteerd 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 de verwachte antwoorden geeft.
  • Foundry retourneert een fout 'tool niet ondersteund', ook al geven de tabellen ondersteuning weer:
    • Beschikbaarheid van hulpprogramma's vereist ondersteuning van zowel het model als de regio. Controleer de beschikbaarheidstabel van de regio voor uw regio en de ondersteuningstabel voor het model. Als een van beide tabellen wordt weergegeven No, kan het hulpprogramma niet worden uitgevoerd, zelfs niet als de andere tabel wordt weergegeven Yes.
    • Controleer of het model daadwerkelijk is geïmplementeerd in het project en de regio die u wilt gebruiken. Een model dat ondersteuning biedt voor een hulpprogramma in het algemeen, wordt mogelijk niet in elke regio geïmplementeerd.
    • Probeer een andere regio of een andere modelimplementatie die het hulpprogramma ondersteunt. Code Interpreter werkt bijvoorbeeld niet in regio's die voor Code Interpreter het label no weergeven (zoals southcentralus en spaincentral), ongeacht welk model u gebruikt.

FAQ

Hoe kan ik valideren of een hulpprogramma is aangeroepen?

Controleer traceringen om te controleren of uw agent een hulpprogramma heeft aangeroepen en om de invoer en uitvoer van het hulpprogramma te controleren. Zie Tracering instellen voor Foundry-agents voor installatie-instructies.

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

Begin met duidelijke instructies voor de tool. Als u het aanroepen van deterministische hulpprogramma's nodig hebt, gebruikt u tool_choice. Zie Toolaanroepen beheren met tool_choice voor meer informatie.

Verwante inhoud

Gereedschapsbeheer

Hulpmiddelen voor ophalen en zoeken

Hulpprogramma's voor gegevens en integratie

Hulpprogramma's voor automatisering en generatie

  • Last updated on