Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Foundry Agent Service is een beheerd platform voor het bouwen, implementeren en schalen van AI-agents. Gebruik elk framework, elk ondersteund model uit de Foundry-modelcatalogus en de Response-API als één toegangspunt.
U kiest hoeveel van het platform u wilt:
- Promptagenten : maak een promptagent in de Foundry-portal of definieer deze met SDK's en REST, en Foundry voert deze voor u uit. Er is geen toepassingscode om te onderhouden, geen rekenkracht om voor te betalen en geen containers of pakketten om te optimaliseren, te schalen of patchen.
- Hosted agents — schrijf uw agentcode met Agent Framework, LangGraph, de OpenAI Agents SDK, de Anthropic Agent SDK, de GitHub Copilot SDK of uw eigen code, verpakt deze als een container en laat Foundry het uitvoeren met een beheerd eindpunt, schalen, identiteit en waarneembaarheid.
Hebt u al agentcode uitgevoerd buiten Foundry? Roep de Antwoorden-API aan van uw bestaande proces om Foundry-modellen en platformhulpprogramma's op te halen zonder uw code te verplaatsen.
Wat is een agent?
Een agent is een AI-toepassing die gebruikmaakt van een model uit de Foundry-modelcatalogus om te redeneren over gebruikersaanvragen en autonome acties te ondernemen om deze te vervullen. In tegenstelling tot een eenvoudige chatbot die alleen tekst genereert, kan een agent hulpprogramma's aanroepen, externe gegevens openen en beslissingen nemen over meerdere stappen om een taak te voltooien. In sommige gevallen handelen agents helemaal zonder een chatinterface: autonoom werken op de achtergrond, geactiveerd door systeemgebeurtenissen, om taken namens een gebruiker of organisatie uit te voeren.
Elke agent combineert drie kernonderdelen:
- Model: Een model uit de Foundry-modelcatalogus die redenerings- en taalmogelijkheden biedt.
- Instructies: Doelen, beperkingen en gedrag definiëren. In Foundry kunnen instructies worden gebaseerd op prompts of code in een gehoste agent.
- Hulpprogramma's: Toegang bieden tot gegevens of acties, zoals zoeken, bestandsbewerkingen of API-aanroepen.
Agentservice in één oogopslag
| Component | Wat het doet |
|---|---|
| Antwoord-API | Eén toegangspunt voor elk type agent. Biedt elk framework, proces of elke runtime toegang tot Foundry-modellen en platformtools (bestandszoekfunctie, code-interpreter, geheugen, webzoekfunctie, MCP-servers). |
| Agent Runtime | Hostt en schaalt promptgestuurde agents en gehoste agents. Beheert gesprekken, hulpprogramma-aanroepen en levenscyclus van agents. |
| Tools | Ingebouwde hulpprogramma's, waaronder zoeken op internet, zoeken in bestanden, geheugen, code-interpreter, MCP-servers en aangepaste functies. Beheerde verificatie omvat door de service beheerde referenties en On-Behalf-Of (OBO). |
| Modellen | Werkt met veel modellen uit de Foundry-modelcatalogus, zoals GPT-4o, Llama en DeepSeek. Modellen wisselen zonder de agentcode te wijzigen. |
| Observeerbaarheid | End-to-end tracering, metrische gegevens en Application Insights-integratie. Bekijk elke beslissing die uw agent neemt. |
| Identiteit en beveiliging | Microsoft Entra identiteit, RBAC, inhoudsfilters en isolatie van virtuele netwerken. Ingebouwde vertrouwensrelatie op ondernemingsniveau. |
| Publiceren | Versiebeheersagenten, stabiele eindpunten maken en delen via Microsoft Teams, Microsoft 365 Copilot en de Entra Agent Registry. |
Aan de slag met agents
Kies uw pad op basis van wat u wilt doen:
- Nieuw bij agenten?Begin met een promptagent : maak een agent in de Foundry-portal, kies een model, koppel hulpprogramma's en roep deze vervolgens aan vanuit code. Er is geen runtimecode om te schrijven of te onderhouden. Foundry voert de agent voor u uit.
- Wilt u een op code gebaseerde agent bouwen in Foundry?Implementeer een gehoste agent : schrijf uw agent met Agent Framework, LangGraph, de OpenAI Agents SDK of uw eigen code, verpakt deze als een container en laat Foundry deze uitvoeren met een beheerd eindpunt, schalen en identiteit.
- Wilt u Foundry-modellen en -hulpprogramma's gebruiken vanuit agentcode die u al ergens anders uitvoert?Roep de Antwoorden-API aan van uw bestaande proces om Foundry-modellen en platformhulpprogramma's op te halen zonder uw code te verplaatsen.
Agenttypen
Er zijn twee hoofdagenttypen in agentservice:
- Promptagents — maken in de portal of in code, met een volledig beheerde runtime.
- Gehoste agents : uw agentcode, uitgevoerd door Foundry.
Agents aansturen
Promptagents worden volledig gedefinieerd via configuratie: instructies, modelselectie en hulpprogramma's. U maakt ze in de Foundry-portal voor een quickstart of definieert ze programmatisch met de SDK's of REST API om te integreren met uw CI/CD-werkstromen. Hoe dan ook, Foundry draait de agent voor u — er is geen toepassingscode om te onderhouden, geen rekenkracht om voor te betalen en geen containers of pakketten om te optimaliseren, te schalen of op beveiliging te controleren.
Twee paden om aan de slag te gaan:
- Portal-first : maak interactief een agent in de Foundry-portal, test deze in de speeltuin en roep deze vervolgens aan vanuit uw toepassingscode.
- Code-first : definieer de agent met behulp van de SDK of REST API in uw implementatiepijplijn, waardoor versiebeheer, codebeoordeling en geautomatiseerde implementatie mogelijk zijn.
Het beste voor: Snel aan de slag, interne hulpprogramma's, productieagents die geen aangepaste indelingslogica nodig hebben en teams die een beheerde runtime willen zonder infrastructuuroverhead.
Gehoste agents
Hosted agents zijn agents op basis van code die u bouwt met Agent Framework, LangGraphOpenAI Agents SDK, de Anthropic Agent SDK, de GitHub Copilot SDK, of uw eigen code. Verzend uw agent als een containerinstallatiekopie of een zip van uw broncode. Foundry bouwt de installatiekopie voor u wanneer u een zip-bestand meebrengt, en Foundry voert deze uit met een beheerd eindpunt, automatisch schalen, een toegewezen Microsoft Entra identiteit, statuspersistentie op sessieniveau en end-to-end waarneembaarheid.
Onder de schermen roept uw agentcode de Responses-API aan op het eindpunt van het Foundry-project voor modeldeductie en indeling van hulpprogramma's, waarmee u toegang hebt tot Foundry-modellen uit de catalogus en een uniforme set platformhulpprogramma's— standaard OpenAI-hulpprogramma's zoals bestandszoekopdrachten, code-interpreter en webzoekopdrachten, plus Foundry-exclusieve hulpprogramma's zoals SharePoint, WorkIQ en Fabric IQ.
Geschikt voor: agents die uw eigen aangepaste code aanroepen; in tweede instantie aangepaste orkestratielogica, multi-agentsystemen en aangepaste protocollen (webhooks, spraak, AG-UI) waarbij u volledige controle over de agentlogica wilt, terwijl u Foundry hosting, schaling en identiteit laat afhandelen.
Als u liever uw agentcode buiten Foundry wilt blijven uitvoeren, bijvoorbeeld ingesloten in een bestaande toepassing, kunt u de modellen en platformhulpprogramma's van Foundry nog steeds ophalen door de Response-API rechtstreeks vanuit uw proces aan te roepen. Zie De Antwoorden-API gebruiken vanuit uw eigen code.
Agenttypen vergelijken
| Agents aansturen | Gehoste agents | |
|---|---|---|
| Ontwerpoppervlak | Portal, SDK of REST | Agent Framework, LangGraph, OpenAI Agents SDK, Anthropic Agent SDK, GitHub Copilot SDK, aangepaste code |
| Foundry-modellen + platformtools | Ja | Ja (via de Antwoorden-API op het eindpunt van het Foundry-project) |
| Ondersteuning voor vaardigheden | Ja | Ja |
| Runtimecode die moet worden onderhouden | Geen | Ja, uw agentlogica |
| Compute voor beheerdoeleinden | Geen — volledig beheerd | Containerrekenkracht, door Foundry beheerd |
| Beheerd eindpunt | Ja | Ja |
| Autoscale | Automatisch, door Foundry beheerd; schaalt mee met het aanvraagvolume | Automatisch en door Foundry beheerd; schaalt containerinstanties per sessie en verzoekvolume |
| Agentidentiteit (Entra) | Ja | Automatisch, toegewezen per agent |
| Kostenmodel | Inferentie per aanroep + gebruik van tools | Inferentie per aanroep + gebruik van tools + containerrekenkracht |
| Het beste voor | Snel aan de slag, productie-agents zonder aangepaste orkestratie | Agents die aangepaste code aanroepen; in tweede instantie aangepaste orkestratielogica |
De Antwoorden-API gebruiken vanuit uw eigen code
De Antwoorden-API is het eindpunt voor één model en hulpprogramma's achter elk agenttype. U kunt deze rechtstreeks vanuit uw eigen code aanroepen om Foundry-modellen en platformhulpprogramma's op te halen zonder een agentresource te maken in Foundry. Dit patroon is additief voor gehoste agents, geen alternatief. Dezelfde Agent Framework-code kan de Response-API vandaag nog aanroepen vanuit uw eigen proces en later worden verpakt als een container-gehoste agent wanneer u een door Foundry beheerd eindpunt wilt.
Zie quickstart: De antwoorden-API gebruiken voor eindpuntopties en end-to-end voorbeelden.
Modelondersteuning
Agent Service werkt met veel modellen die beschikbaar zijn in de foundry-modelcatalogus. Zie Quota, limieten en regionale ondersteuning voor de volledige lijst.
Hulpmiddelen
Agent Service biedt ingebouwde hulpprogramma's en ondersteunt aangepaste hulpprogramma's, zodat uw agents acties kunnen ondernemen en toegang kunnen krijgen tot gegevens. Zie de catalogus met foundry-hulpprogramma's voor een volledige lijst. Zie Aanbevolen procedures voor hulpprogramma's voor geavanceerde selectiepatronen voor hulpprogramma's.
Foundry ondersteunt externe MCP-servers die u kunt toevoegen vanuit de catalogus Extra toevoegen in de Foundry-portal. De Azure DevOps MCP-server (openbare preview) kan bijvoorbeeld rechtstreeks vanuit de catalogus worden toegevoegd. Verbind uw Azure DevOps organisatie om agenttoegang in te schakelen en configureer een subset van beschikbare hulpprogramma's om te bepalen welke acties agents kunnen uitvoeren. U kunt ook aangepaste MCP-servers verbinden die worden gehost op Azure Functions met behulp van het Mchook-eindpunt van Functions (/runtime/webhooks/mcp) om aangepaste hulpprogramma's beschikbaar te maken voor uw agents.
Ondersteunde verificatieopties voor MCP-servers en andere hulpprogrammaverbindingen zijn:
- Toegang op basis van sleutels
- Microsoft Entra (met behulp van de beheerde identiteit van de agent of de beheerde identiteit van het project)
- Passthrough voor OAuth-identiteit (aan-Behalf-Of)
- Niet-geverifieerde toegang, indien van toepassing
Deze verificatieopties zijn ook van toepassing bij het verbinden van externe MCP-servers, met inloggegevens en toegangsrechten die worden beheerd in de configuratie van de tool.
Gereedschapskist
Met toolbox kunt u eenmaal een gecureerde set hulpprogramma's definiëren, deze centraal beheren in Foundry en deze beschikbaar maken via één met MCP compatibel eindpunt. Elke MCP-compatibele agentruntime of -client kan een gereedschapskist gebruiken, ongeacht het framework dat u gebruikt. Versiebeheer van werksets geeft u expliciet controle over wanneer wijzigingen van kracht worden: maak een nieuwe versie, test deze en promoveer deze naar de standaardwaarde wanneer u klaar bent.
Opmerking
Sommige hulpprogramma's, waaronder geheugen- en webzoekopdrachten, zijn in preview. Zie de ondersteuning van hulpprogramma's per regio en model voor beschikbaarheid per regio en preview-status.
Ontwikkelingslevenscyclus
Agent Service ondersteunt de volledige werkstroom voor bouwen, testen, inzetten en monitoren:
- Maken : definieer een promptagent in de portal of met de SDK of schrijf een gehoste agent die de Antwoorden-API aanroept.
- Test — Chat met uw agent in de oefenomgeving of lokaal uitvoeren. MCP-serverintegraties, inclusief aangepaste MCP-servers die worden gehost op Azure Functions, kunnen rechtstreeks in de speeltuin worden uitgevoerd om de connectiviteit, machtigingen en het gedrag van hulpprogramma's te valideren voordat ze worden gepubliceerd.
- Tracering : inspecteer elke modeloproep, aanroep van hulpprogramma's en beslissingen met agenttracering.
- Evalueren : voer evaluaties uit om kwaliteit en vangstregressies te meten.
- Optimaliseren : verbeter automatisch de instructies van uw gehoste agent met behulp van de agentoptimalisatie.
- Publiceren : promoot uw agent naar een beheerde resource met een stabiel eindpunt.
- Bewaken : prestaties en betrouwbaarheid bijhouden met metrische servicegegevens en dashboards.
Zie de levenscyclus van agentontwikkeling voor een gedetailleerd overzicht.
Enterprise-mogelijkheden
Agent Service biedt hoogwaardige infrastructuur voor elke agent die u implementeert:
- Agent identity — Elke agent kan een toegewezen Microsoft Entra-identiteit hebben, waardoor beveiligde en beperkte toegang tot resources en API's mogelijk is zonder referenties te delen. Agentidentiteiten kunnen worden geverifieerd bij externe MCP-servers, waaronder die worden gehost op Azure Functions, en OAuth On-Behalf-Of (OBO) passthrough wordt ondersteund wanneer deze zijn geconfigureerd.
- Privé-netwerken — Voer agents uit binnen uw Azure virtuele netwerk voor volledige netwerkisolatie en naleving van de locatievereisten voor gegevens. Privénetwerken zijn beschikbaar voor prompt-agents. Gehoste agents ondersteunen bring-your-own Azure Virtual Network (BYO VNet), waarbij elke sessie wordt uitgevoerd in een vm-geïsoleerde sandbox die is verbonden met uw VNet.
- Rolgebaseerd toegangbeheer — Fijnmazige machtigingen via Microsoft Entra en Azure RBAC. Bepalen wie agents kan maken, aanroepen en beheren.
- Inhoudsveiligheid : geïntegreerde inhoudsfilters helpen promptinjectierisico's (inclusief kruispromptinjectie) te beperken en onveilige uitvoer te voorkomen.
Zie Uw omgeving instellen voor instructies voor het instellen van de omgeving.
Publiceren en delen
Agent Service biedt ingebouwde versiebeheer en publicatie, zodat uw agents met vertrouwen van ontwikkeling naar productie kunnen overstappen.
- Versiebeheer — Terwijl u uw agent verder ontwikkelt, worden van versies automatisch momentopnamen gemaakt. Ga terug naar een eerdere versie of vergelijk wijzigingen tussen versies.
- Publiceren : een agent promoveren naar een beheerde resource met een stabiel eindpunt. Gepubliceerde agents nemen de bedrijfsidentiteit en toegangsbeheer over die zijn geconfigureerd voor uw project en kunnen programmatisch worden aangeroepen.
- Distribution — Deel gepubliceerde agents via Microsoft 365 Copilot en Teams en het Register van de Entra-agent, waarbij uw agents worden geplaatst waar uw gebruikers al werken. Foundry Agent Service ondersteunt de OpenResponses- en activiteitsprotocollen voor Microsoft 365 publiceren, een aanroepprotocol voor flexibele eindpuntintegratie met aangepaste apps en services en het A2A-protocol (preview) voor communicatie tussen agents.
Beveiliging, privacy en naleving
Agent Service is ontworpen voor bedrijfsworkloads waar u sterke controles nodig hebt over identiteit, netwerken, gegevensverwerking en veiligheid.
- Veiligheidscontroles: Gebruik geïntegreerde kaders om onveilige uitvoer te verminderen en risico's voor promptinjectie te beperken, waaronder aanvallen met kruispromptinjectie (XPIA).
- Controlemechanismen voor netwerkisolatie en gegevenslocatie: gebruik virtuele netwerken en bring-your-own resources om aan uw eisen te voldoen.
- Bring your own resources: Gebruik uw eigen azure-resources (bijvoorbeeld opslag, Azure AI Zoeken en Azure Cosmos DB voor gesprekstoestand) om te voldoen aan uw nalevings- en operationele eisen. Zie Gebruik uw eigen resources.
- Responsible AI guidance: Zie Responsible AI for Microsoft Foundry voor een bredere set aanbevelingen en governanceresources.
Verwante inhoud
- Uw omgeving instellen
- Levenscyclus van agentontwikkeling
- Uw eerste gehoste agent implementeren
- Catalogus met hulpprogramma's
- Quota, limieten en regionale ondersteuning
- Voor hulp of om verbinding te maken met de community, kunt u deelnemen aan de Microsoft AI Discord.