Typen hulpprogramma's in Foundry Agent Service

Hulpprogramma's breiden uit wat uw agents kunnen doen in Microsoft Foundry Agent Service. Hoewel een agent een Foundry-model kan gebruiken om antwoorden te genereren, kunnen met hulpprogramma's acties worden uitgevoerd zoals het zoeken op internet, het uitvoeren van code, het openen van zakelijke gegevens en het aanroepen van externe services of API's. In dit artikel worden de beschikbare hulpprogrammatypen geïntroduceerd, wordt uitgelegd hoe u hulpprogramma's verbindt met agents en hoe u rekening moet maken met verificatie- en autorisatieoverwegingen.

De aanbevolen manier om hulpprogramma's beschikbaar te maken voor agents is via een werkset. Een werkset maakt hulpprogramma's beschikbaar via een beheerd MCP-eindpunt, centraliseert referentie- en beleidsbeheer en kunt u hulpprogramma's voor updates of versies uitvoeren zonder agentcode te wijzigen. Hoewel hulpprogramma's ook rechtstreeks aan afzonderlijke agents kunnen worden gekoppeld, vereenvoudigt een werkset het beheer en bevordert het hergebruik van hulpprogramma's tussen agents. Als u hulpprogramma's wilt gebruiken, moet u machtigingen hebben in uw Foundry-project om hulpprogramma's te beheren en toegang te krijgen tot de foundry-hulpprogrammacatalogus. Zie Wat is een werkset?en Maak en beheer een werkset in Foundry voor meer informatie.

De catalogus met foundry-hulpprogramma's en werksets zijn algemeen beschikbaar. Sommige afzonderlijke hulpprogramma's zijn in preview en worden geïdentificeerd in de lijst met hulpprogramma's en hulpprogrammaspecifieke documentatie. Preview-hulpprogramma's zijn onderhevig aan aanvullende gebruiksvoorwaarden.

Wat zijn hulpprogramma's?

Een hulpprogramma is een mogelijkheid die een agent kan aanroepen tijdens een gesprek om een specifieke taak uit te voeren. Wanneer een agent een gebruikersbericht ontvangt, bepaalt het Foundry-model dat de agent aanroept of een hulpprogramma moet worden aangeroepen op basis van de instructies van de agent en de beschikbare hulpprogrammadefinities. De agent verzendt de aanvraag voor het tool, uw toepassing of de service voert deze uit en het resultaat wordt teruggekoppeld naar het gesprek, zodat de agent kan doorgaan met nauwkeurige, up-to-date gegevens.

Met hulpprogramma's kunnen agents verder gaan dan het genereren van tekst. Een agent kan bijvoorbeeld:

  • Zoek op internet naar actuele informatie voordat u antwoordt.
  • Voer Python code uit om een gegevensset te analyseren en een grafiek te genereren.
  • Voer een query uit op een vectoropslag van uw documenten om de reactie in uw gegevens te gronden.
  • Roep een externe API aan om een klantrecord op te zoeken of een ondersteuningsticket te maken.

Types of tools nl-NL: Typen gereedschappen

Foundry Agent Service groepeert hulpprogramma's in twee categorieën: ingebouwde hulpprogramma's die klaar zijn voor gebruik na basisconfiguratie en aangepaste hulpprogramma's waarmee u uw eigen mogelijkheden kunt gebruiken. Welke categorie een hulpprogramma ook behoort, de aanbevolen manier om het beschikbaar te maken voor een agent is via een werkset.

Ingebouwde hulpprogramma's

Foundry Agent Service biedt ingebouwde hulpprogramma's als vooraf geconfigureerde mogelijkheden. U schakelt deze hulpprogramma's in op uw agent en de service verwerkt de uitvoering. Voor deze hulpprogramma's is geen externe hosting of aangepaste code vereist.

De meest gebruikte ingebouwde hulpprogramma's zijn:

  • Webzoekopdrachten : voeg webzoekopdrachten toe aan uw agent. De agent haalt realtime informatie op van het openbare web en retourneert antwoorden met inline bronvermeldingen. Deze methode is de aanbevolen manier om web grounding toe te voegen. Voor geavanceerde scenario's zoals marktspecifieke filtering, zie Gronding met Bing-tools en het webgrondingsoverzicht.
  • Code Interpreter — Laat agents Python code schrijven en uitvoeren in een sandboxomgeving voor gegevensanalyse, wiskunde en grafiekgeneratie.
  • Bestandszoekopdracht - Agents voorzien van kennis van geüploade bestanden of eigen documenten met behulp van vectorzoekopdracht.
  • Functieoproepen : definieer aangepaste functies die de agent kan aanroepen. De toepassing voert de functie uit en retourneert het resultaat.

Zie Alle ingebouwde hulpprogramma's voor de volledige lijst met ingebouwde hulpprogramma's.

Aangepaste hulpprogramma's

Met aangepaste hulpprogramma's kunt u uw agent uitbreiden met uw eigen API's, services of andere agents. Gebruik aangepaste hulpprogramma's wanneer ingebouwde hulpprogramma's uw scenario niet behandelen.

De meest voorkomende opties voor aangepaste hulpprogramma's zijn:

  • Model Context Protocol (MCP): verbind uw agent met hulpprogramma's die worden gehost op een MCP-servereindpunt. Het is het beste voor hulpprogramma's die worden gedeeld door meerdere agents of worden onderhouden door een ander team.
  • Agent-naar-agent (A2A) (preview): verbind uw agent met andere agents via A2A-compatibele eindpunten voor communicatie tussen agents.
  • OpenAPI-hulpprogramma : verbind uw agent met externe HTTP-API's met behulp van een OpenAPI 3.0- of 3.1-specificatie.

Zie Alle aangepaste hulpprogramma's voor de volledige lijst met opties voor aangepaste hulpprogramma's.

Een hulpprogramma gebruiken in een agent

Als u een hulpprogramma aan een agent wilt toevoegen, plaatst u het hulpprogramma in een werkset en koppelt u de werkset als een MCP-hulpprogramma aan de agent. In het volgende voorbeeld wordt een werkset gemaakt met het webzoekprogramma, wordt de werkset gekoppeld aan een agent en wordt een query verzonden:

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient
from azure.ai.projects.models import PromptAgentDefinition, WebSearchTool, MCPTool

# Format: "https://resource_name.ai.azure.com/api/projects/project_name"
PROJECT_ENDPOINT = "your_project_endpoint"

# Create clients to call Foundry API
project = AIProjectClient(
    endpoint=PROJECT_ENDPOINT,
    credential=DefaultAzureCredential(),
)
openai = project.get_openai_client()

# 1. Add the tool to a toolbox. Using a toolbox is the recommended way to give
#    agents tools: you curate tools once and reuse the toolbox across agents.
toolbox = project.toolboxes.create_toolbox_version(
    name="web-search-toolbox",
    description="Toolbox with the web search tool",
    tools=[WebSearchTool()],
)

# 2. The toolbox exposes an MCP-compatible endpoint.
TOOLBOX_MCP_URL = (
    f"{PROJECT_ENDPOINT}/toolboxes/{toolbox.name}"
    f"/versions/{toolbox.version}/mcp?api-version=v1"
)

# 3. Create a remote-tool project connection that points at the toolbox endpoint.
#    Call a user Entra token so the caller's identity is passed through.
#    Create the connection once with the Azure Developer CLI:
#    
#    azd ai connection create web-search-toolbox-conn \
#      --kind remote-tool \
#      --target "<TOOLBOX_MCP_URL>" \
#      --auth-type user-entra-token \
#      --audience https://ai.azure.com
TOOLBOX_CONNECTION_NAME = "web-search-toolbox-conn"

# 4. Attach the toolbox to the agent as an MCP tool.
agent = project.agents.create_version(
    agent_name="web-search-agent",
    definition=PromptAgentDefinition(
        model="gpt-4.1-mini",
        instructions="You are a helpful assistant that can search the web.",
        tools=[
            MCPTool(
                server_label="toolbox",
                server_url=TOOLBOX_MCP_URL,
                require_approval="never",
                project_connection_id=TOOLBOX_CONNECTION_NAME,
            )
        ],
    ),
)

# Send a query
response = openai.responses.create(
    input="What are the latest updates to Microsoft Foundry?",
    extra_body={"agent_reference": {"name": agent.name, "type": "agent_reference"}},
)
print(response.output_text)

Elk hulpprogrammatype heeft een eigen configuratie. Zie voor gedetailleerde instellingen en codevoorbeelden in alle ondersteunde talen de afzonderlijke handleidingen die zijn gekoppeld aan de typen hulpprogramma's .

Gedrag van hulpprogramma's tijdens runtime aanpassen met gestructureerde invoer

Standaard worden hulpprogrammaconfiguraties zoals bestands-id's, vectorarchief-id's en MCP-servereindpunten opgelost wanneer u de agent maakt. Met gestructureerde invoer in hulpprogramma-eigenschappen kunt u deze waarden tijdens runtime overschrijven zonder een nieuwe agentversie te maken.

Gestructureerde invoer is handig wanneer:

  • Verschillende gebruikers hebben verschillende vectorarchieven of bestanden nodig op basis van hun context.
  • U wilt dezelfde agentdefinitie hergebruiken in omgevingen (ontwikkeling, fasering, productie).
  • MCP-servereindpunten of verificatietokens variëren per aanvraag.

De volgende hulpprogramma-eigenschappen ondersteunen aanpassing via gestructureerde invoer:

Type gereedschap Eigenschap Beschrijving
file_search vector_store_ids Reeks van vectorwinkel-ID's. Lege waarden worden tijdens runtime verwijderd.
code_interpreter container, container.file_ids Container-ID's of bestands-ID's in een automatisch gegenereerde container. Lege waarden worden tijdens runtime verwijderd.
mcp server_label, , server_urlheaders WAARDEN voor MCP-serverlabel, URL en HTTP-header.

Bijvoorbeeld een agentdefinitie met een sjabloon vectoropslag.

{
  "tools": [
    {
      "type": "file_search",
      "vector_store_ids": ["vs_base_kb", "{{customer_kb}}"]
    }
  ],
  "structured_inputs": {
    "customer_kb": {
      "description": "Vector store ID for the customer's knowledge base",
      "required": true,
      "schema": { "type": "string" }
    }
  }
}

Geef tijdens runtime de werkelijke waarde op:

{
  "agent": { "type": "agent_reference", "name": "support-agent", "version": "1" },
  "input": [{ "type": "text", "text": "How do I upgrade my account?" }],
  "structured_inputs": {
    "customer_kb": "vs_premium_kb_2024"
  }
}

Authenticatie voor hulpprogramma's beheren

Voor verschillende hulpprogramma's zijn verschillende verificatiemethoden vereist. Als u deze opties begrijpt, kunt u hulpprogramma's veilig verbinden.

Ingebouwde hulpprogramma's

De meeste ingebouwde hulpprogramma's, zoals Code Interpreter en File Search, verifiëren automatisch via Foundry Agent Service en vereisen geen extra configuratie. Hulpprogramma's die verbinding maken met externe gegevensbronnen, zoals Azure AI Zoeken of SharePoint, gebruiken de connections die u in uw Foundry-project configureert.

MCP-servers

MCP-servers ondersteunen meerdere verificatiemethoden, afhankelijk van de server: verificatie op basis van sleutels (API-sleutel of token), Microsoft Entra verificatie (beheerde identiteit) en OAuth voor passthrough op gebruikersniveau.

In het volgende voorbeeld wordt verbinding gemaakt met een MCP-server met behulp van verificatie op basis van sleutels. Sla de referentie op in een projectverbinding en verwijs vervolgens naar de verbindingsnaam wanneer u het hulpprogramma maakt:

from azure.ai.projects.models import MCPTool

tool = MCPTool(
    server_label="github",
    server_url="https://api.githubcopilot.com/mcp",
    require_approval="always",
    project_connection_id="my-github-connection",
)

Gebruik voor Microsoft Entra verificatie agentidentiteit of door project beheerde identiteit in plaats van een verbinding. De service vraagt automatisch een token aan. Voor OAuth-identiteitspassthrough (verificatie per gebruiker) genereert Agent Service een toestemmingskoppeling die gebruikers autoriseren bij het eerste gebruik.

Zie McP-serververificatie instellen voor gedetailleerde installatiestappen voor alle methoden.

Tip

Wanneer u twijfelt, begint u met Microsoft Entra verificatie als de MCP-server dit ondersteunt. Het elimineert de noodzaak om geheimen te beheren en biedt ingebouwde tokenrotatie.

OpenAPI-hulpprogramma's

OpenAPI-hulpprogramma's ondersteunen anonieme verificatie, API-sleutel en beheerde identiteit. De verificatieconfiguratie maakt deel uit van de definitie van het hulpprogramma.

Anonieme verificatie : gebruik wanneer de API geen referenties nodig heeft:

from azure.ai.projects.models import (
    OpenApiTool,
    OpenApiFunctionDefinition,
    OpenApiAnonymousAuthDetails,
)

weather_tool = OpenApiTool(
    openapi=OpenApiFunctionDefinition(
        name="get_weather",
        spec=openapi_spec,
        description="Retrieve weather information for a location.",
        auth=OpenApiAnonymousAuthDetails(),
    )
)

API-sleutelverificatie : sla de sleutel op in een projectverbinding en verwijs ernaar. Uw OpenAPI-specificatie moet secties bevatten securitySchemes en security bevatten:

from azure.ai.projects.models import (
    OpenApiTool,
    OpenApiFunctionDefinition,
    OpenApiKeyAuthDetails,
)

api_tool = OpenApiTool(
    openapi=OpenApiFunctionDefinition(
        name="get_orders",
        spec=openapi_spec,
        description="Look up customer orders.",
        auth=OpenApiKeyAuthDetails(
            project_connection_id="my-api-connection"
        ),
    )
)

Zie Agents verbinden met OpenAPI-hulpprogramma's voor configuratie van beheerde identiteiten.

Tip

Behandel alle referenties als geheimen. Geef alleen de minimaal vereiste headers op, neem geen referenties op in prompts en bekijk de procedures voor gegevensverwerking van de provider. Zie McP-hulpprogramma's beheren met behulp van een AI-gateway voor besturingselementen zoals frequentielimieten en IP-beperkingen voor MCP-hulpprogramma's.

Alle ingebouwde hulpprogramma's

De volgende tabel bevat alle ingebouwde hulpprogramma's die beschikbaar zijn in Foundry Agent Service.

Hulpmiddel Beschrijving
Zoeken op internet Haal realtime informatie op van het openbare web en retourneer antwoorden met inline bronvermeldingen.
Code-interpreter Schrijf en voer Python code uit in een sandbox-omgeving.
Custom Code Interpreter (preview) Pas de resources van de code-interpreter, Python-pakketten en de Container Apps-omgeving aan.
Zoeken naar bestanden Agenten versterken met kennis uit geüploade bestanden of gepatenteerde documenten.
Azure AI Zoeken Agents grounden met gegevens uit een bestaande Azure AI Zoeken index.
Azure Functions Schakel agents in om uw Azure Functions aan te roepen om aangepaste acties uit te voeren en dynamische gegevens op te halen.
Functie aanroepen Definieer aangepaste functies die de agent kan aanroepen. De app voert de functie uit en retourneert het resultaat.
Afbeeldingengeneratie (preview) Afbeeldingen genereren als onderdeel van gesprekken en werkstromen.
Browserautomatisering (preview) Browsertaken uitvoeren via prompts voor natuurlijke taal.
Computergebruik (voorbeeldweergave) Interactie met computersystemen via hun gebruikersinterfaces.
Microsoft Fabric (preview) Maak verbinding met een Microsoft Fabric gegevensagent voor gegevensanalyse.
SharePoint (preview) Chatten met privédocumenten die zijn opgeslagen in SharePoint.

Tip

Zie Grounding met Bing-hulpprogramma's en het overzicht van webgronding voor geavanceerde webaardingscenario's.

Alle aangepaste hulpprogramma's

De volgende tabel bevat alle aangepaste hulpprogrammaopties voor het verbinden van uw eigen mogelijkheden met een agent.

Hulpmiddel Beschrijving
Model Context Protocol (MCP) Verbind uw agent met hulpprogramma's die worden gehost op een MCP-servereindpunt.
OpenAPI-hulpprogramma Verbind uw agent met externe API's met behulp van een OpenAPI 3.0- of 3.1-specificatie.
Agent-to-Agent (A2A) (voorbeeldweergave) Verbind uw agent met andere agents via A2A-compatibele eindpunten.
Gereedschapskist Bundel meerdere hulpprogramma's in één MCP-eindpunt voor hergebruik tussen agents.

Sleutelbegrippen

Gebruik deze definities om terminologie consistent te houden:

Termijn Betekenis
Gieterijgereedschappen De portalervaring waar u hulpprogramma's voor agents ontdekt, configureert en beheert.
Catalogus met hulpprogramma's De lijst met beschikbare hulpprogramma's, inclusief openbare en organisatorische hulpprogramma's.
Catalogus met persoonlijke hulpprogramma's Een catalogus met organisatiebereik voor hulpprogramma's die alleen gebruikers in uw organisatie kunnen detecteren en configureren.
MCP-server Een server die hulpprogramma's beschikbaar maakt met behulp van het Model Context Protocol (MCP).
Externe MCP-server Een MCP-server die wordt gehost door de uitgever. U configureert deze door de vereiste instellingen op te geven, zoals een eindpunt en verificatiegegevens.
Lokale MCP-server Een MCP-server die u zelf host en maak vervolgens verbinding met Foundry door het externe eindpunt op te geven.
Aangepast hulpprogramma Een hulpprogramma dat u toevoegt door uw eigen eindpunt of specificatie op te geven, zoals een MCP-eindpunt, een OpenAPI-specificatie of A2A-eindpunten (Agent-to-Agent).
Gereedschapskist Een gecureerde bundel hulpprogramma's die u eenmaal configureert en beschikbaar maakt als één MCP-eindpunt voor gebruik in meerdere agents.

Opmerking

Als u geïnteresseerd bent in het overbrengen van uw officiële, externe MCP-servers naar alle Foundry-klanten, vult u dit formulier in.

Overwegingen voor het gebruik van niet-Microsoft-services en servers

Uw gebruik van verbonden niet-Microsoft-services en servers ('niet-Microsoft-services') is onderhevig aan de voorwaarden tussen u en de serviceprovider. Niet-Microsoft-services zijn niet-Microsoft producten onder uw overeenkomst voor het gebruik van Microsoft onlineservices. Wanneer u verbinding maakt met niet-Microsoft-services, worden sommige van uw gegevens (zoals de inhoud van prompts) verzonden naar deze niet-Microsoft-service, of uw toepassing kan gegevens ontvangen van de niet-Microsoft-service. U bent verantwoordelijk voor uw gebruik van niet-Microsoft-services en gegevens, samen met eventuele kosten voor dat gebruik.

Derden (niet Microsoft) maken de niet-Microsoft-services, inclusief externe MCP-servers, die u wilt verbinden. Microsoft test of verifieert deze servers niet. Microsoft heeft geen verantwoordelijkheid voor u of anderen met betrekking tot uw gebruik van niet-Microsoft-services.

Controleer en volg de MCP-servers die u toevoegt aan Foundry Agent Service zorgvuldig. Vertrouw op servers die worden gehost door vertrouwde serviceproviders zelf in plaats van proxy's.

Het hulpprogramma MCP kan aangepaste headers doorgeven die een externe MCP-server mogelijk vereist voor authenticatie. Alle inloggegevens behandelen als geheimen:

  • Geef alleen de minimaal vereiste headers op.
  • Neem geen referenties op in prompts.
  • Als u aanvragen voor controle in een logboek opgeeft, vermijdt u logboekregistratie van geheimen of gevoelige promptinhoud.
  • Bekijk de procedures voor gegevensverwerking van de provider, inclusief retentie en locatie van gegevens.

Hulpprogramma's ontdekken en beheren in de portal

Ga in de Foundry-portal naar uw project en selecteer Build> Tools om FoundryTools te openen. Hier kunt u door de catalogus met hulpprogramma's bladeren, hulpprogramma's configureren en deze toevoegen aan agents. Als u hulpprogramma's nodig hebt die alleen zichtbaar zijn binnen uw organisatie, maakt u een catalogus met persoonlijke hulpprogramma's.

Als u hulpprogramma's wilt verkennen terwijl u bouwt, gebruikt u de speeltuin Agents. Zie Microsoft Foundry Playgrounds voor meer informatie.

Typen gereedschappen in de catalogus

De hulpprogrammacatalogus bevat drie typen vermeldingen:

Externe MCP-server: de uitgever host de server en biedt een statisch of dynamisch eindpunt. Volg de configuratierichtlijnen om de vereiste instellingen op te geven, zoals een eindpunt en verificatiegegevens.

Lokale MCP-server: u host de server zelf en verbindt deze vervolgens met Foundry door het eindpunt op te geven. Zie Een MCP-server bouwen en registreren om uw eigen server te bouwen en te registreren. Zie Verbinding maken met MCP-servers om een MCP-eindpunt te verbinden met een agent.

Custom: MCP-servers geconverteerd van Azure Logic App Connectors. Voor deze servers is extra configuratie vereist om te converteren naar externe MCP-servers.

Foundry Tools biedt de volgende filters waarmee u de juiste hulpprogramma's kunt vinden:

Filter Beschrijving
Uitgever Microsoft of niet-Microsoft uitgever
Categorie Categorieën zoals databases, analyses, web en meer
Register Openbaar: Publieke externe en lokale MCP-servers in de catalogus.
Logic Apps-connectors: Azure Logic Apps-connectors die u converteert naar externe MCP-servers voor gebruik in een privétoolcatalogus.
Ondersteunde verificatie Verificatiemethode die een MCP-server ondersteunt. Zie Verificatiemethoden voor meer informatie.

Schermopname van een pagina met hulpprogrammagegevens in de Foundry-portal met configuratie- en installatiegegevens.

Wanneer u een hulpprogramma selecteert, worden in Foundry Tools de installatiedetails weergegeven die u nodig hebt om het te configureren.

Geconfigureerde hulpprogramma's beheren

In de lijst met hulpprogramma's vindt u de hulpprogramma's die u hebt geconfigureerd, samen met details zoals eindpunten en verificatie-instellingen. U kunt ook hulpprogramma's toevoegen aan agents.

Voordat u een hulpprogramma verwijdert, controleert u welke agents dit gebruiken. Het verwijderen van een tool kan uitvoeringen die ervan afhankelijk zijn verstoren.

Beschikbaarheid en beperkingen

Beschikbaarheid van hulpprogramma's verschilt per model en regio.

Zie Best practices voor het gebruik van hulpprogramma's in Foundry Agent Service voor de meest recente details over model- en regio-ondersteuning in verschillende tools.

Probleemoplossing

Gebruik deze controles om veelvoorkomende problemen op te lossen:

  • U kunt de catalogus met hulpprogramma's niet vinden: Controleer of u zich in het juiste project hebt en ga vervolgens naar Build>Tools.
  • Een hulpprogramma is zichtbaar, maar u kunt het niet configureren: controleer de vereiste verificatie- en configuratie-invoer van het hulpprogramma en controleer of u toegang hebt tot afhankelijke services.
  • Uw agent roept geen hulpprogramma aan: gebruik de validatierichtlijnen in best practices voor het gebruik van hulpprogramma's in Foundry Agent Service.

Verwante inhoud

  • Last updated on