Agenter i Microsoft Foundry

Foundry Agent Service är en hanterad plattform för att skapa, distribuera och skala AI-agenter. Skapa med alla ramverk, alla modeller som stöds från Foundry-modellkatalogen och en enda startpunkt för modellinferens och verktyg.

Foundry möter dig var som helst i spektrumet från deklarativ till fullständig kod: definiera en promptagent eller en röstbaserad promptagent och låt Foundry köra den, paketera din egen kod som en värdbaserad agent eller anropa svars-API:et från en agent som du redan kör någon annanstans. Välj hur du bygger beskriver varje sätt.

En snabb överblick över agenttjänsten

Välj hur du vill bygga

Foundry ger dig flera sätt att skapa, från ett enda modellanrop till en helt containerbaserad agent. Välj din sökväg baserat på vad du försöker göra:

• Vill du ha minst att hantera för text?Börja med en promptagent. Konfigurera instruktioner, en modell och verktyg; Foundry kör den utan kod eller infrastruktur.
• Vill du ha en hanterad röstupplevelse i realtid?Skapa en röstbaserad promptagent. Konfigurera röstupplevelsen och anslut den via Voice Live utan att vara värd för orkestreringskoden själv.
• Vill du ha fullständig kontroll i Foundry?Distribuera en värdbaserad agent. Ta med din egen kod och ditt ramverk som en container. Foundry kör den med en hanterad slutpunkt, skalning och identitet.
• Kör du redan agentkod någon annanstans?Anropa SVARS-API:et direkt för att använda Foundry-modeller och -verktyg, utan agentresurs att hantera.

Promptagenter, röstbaserade promptagenter och värdbaserade agenter är de agenttyper som beskrivs i den här översikten. Nästa avsnitt delar upp värdet för var och en så att du kan välja med säkerhet.

Agenttyper

Agenttjänsten erbjuder tre agenttyper. Ditt val anger hur mycket du skapar jämfört med hur mycket Foundry hanterar:

• Promptagenter: den snabbaste vägen. Definiera instruktioner, en modell och verktyg, och Foundry kör agenten åt dig utan kod eller infrastruktur att hantera.
• Röstbaserade promptagenter: hanterade röstagenter i realtid. Konfigurera modellen, instruktionerna, ljudet och verktygen och anslut sedan till agenten via Voice Live.
• Värdbaserade agenter: störst kontroll. Ta med din egen kod och ditt ramverk, och Foundry kör den som en container med en hanterad slutpunkt, skalning och identitet.

Aktivera agenter

Du definierar promptagenter helt genom konfiguration, inklusive instruktioner, val av modell och verktyg. Skapa dem i Foundry-portalen för en snabbstart eller definiera dem programmatiskt med SDK:erna eller REST-API:et för att integrera med dina CI/CD-arbetsflöden. Hur som helst, Foundry kör agenten åt dig. Det finns ingen programkod att underhålla och inga containrar eller paket för att optimera, skala eller övervaka för säkerhet.

Två sätt att komma igång:

• Portal– först: skapa en agent interaktivt i Foundry-portalen, testa den på lekplatsen och anropa den sedan från programkoden.
• Kod först: definiera agenten med hjälp av SDK eller REST API i distributionspipelinen, aktivera versionskontroll, kodgranskning och automatisk distribution.

Bäst för: Komma igång snabbt, interna verktyg, produktionsagenter som inte behöver anpassad orkestreringslogik och team som vill ha en hanterad körning utan infrastrukturkostnader.

Röstbaserade promptagenter

Röstbaserade promptagenter är hanterade agenter för talade konversationer i realtid. Konfigurera en modell, instruktioner, ljudinställningar, valfri hälsning och verktyg i agentdefinitionen. Foundry Agent Service hanterar agentens livscykel och använder Voice Live för taligenkänning, turtagning, modellinteraktion och talsyntes.

Röstbaserade promptagenter stöder hanterade modeller och, där det stöds, din egen modelldistribution. Du ansluter till agenten via en WebSocket i realtid i stället för att skicka enskilda textbegäranden. Information om konfiguration och klientspråk som stöds finns i Snabbstart: Skapa en röstbaserad promptagent. Information om röstarkitekturer, resurser och aktuella förhandsgranskningsgränser finns i Så här fungerar röstbaserade agenter.

Bäst för: Kundinriktade röstupplevelser, samtalscenterscenarier och program som behöver ljudinteraktion med låg latens utan att implementera röstorkestreringstjänsten själv.

Hostade agenter

Hosted-agenter är kodbaserade agenter som du skapar med Agent Framework, LangGraph, OpenAI Agents SDK, Anthropic Agent SDK, GitHub Copilot SDK, eller din egen kod. Skicka din agent som antingen en containeravbildning eller en .zip fil med källkoden (Foundry skapar avbildningen åt dig när du tar med en .zip fil) och Foundry kör den med en hanterad slutpunkt, automatisk skalning, en dedikerad Microsoft Entra identitet, statusbeständighet på sessionsnivå och observerbarhet från slutpunkt till slutpunkt.

Under huven anropar agentkoden slutpunkten för Foundry-projektet för modellinferens och verktygsorkestrering, vilket ger dig åtkomst till Foundry-modeller från katalogen och en enhetlig uppsättning plattformsverktyg: standardverktyg som filsökning, kodtolk och webbsökning, plus ytterligare verktyg som SharePoint, WorkIQ och Fabric IQ.

Bäst för: Agenter som anropar till din egen anpassade kod; i andra hand anpassad orkestreringslogik, system med flera agenter och anpassade protokoll (webhooks, röst, AG-UI) där du vill ha fullständig kontroll över agentlogik samtidigt som Foundry kan hantera värd-, skalnings- och identitetshantering.

Jämföra agenttyper

Använda svars-API:et för tillfälliga agenter

När du anropar svars-API:et direkt från din egen kod skapar du en tillfällig agent: agentens definition (instruktioner, verktyg och modell) finns i programkoden i stället för som en bevarad resurs i Foundry. Varje anrop monterar agenten i din process och kör den mot svars-API:et, så det finns ingen agent att skapa, uppdatera eller ta bort i Foundry.

Använd det här mönstret när du vill:

• Agentlogik som levereras med din app. Definitionsversionerna tillsammans med resten av koden via källkodskontroll och kodgranskning, i stället för som en separat Foundry-resurs som någon måste synkronisera med appen.
• Foundrys funktioner utan extra resursbelastning. Du får fortfarande katalogmodeller, plattformsverktyg, projektavgränsade data, On-Behalf-Of-autentisering samt observerbarhet och styrning på projektnivå. Allt genom ändpunkten för ditt Foundry-projekt.

Mer information finns i Snabbstart: Använd svars-API:et .

Så här fungerar röstbaserade agenter

Röstbaserade promptagenter kör talade konversationer i realtid. Du konfigurerar agenten i Foundry-portalen eller via SDK:t, testar den med en mikrofon och gör den tillgänglig via en webbläsarupplevelse eller en telefonnummerkanal. Foundry hanterar agentens livscykel och röstorkestrering, så du behöver inte driva den infrastrukturen själv.

Röstbaserade agenter stöder två modellarkitekturer.

Direkt tal-till-tal

Caller audio
  -> realtime speech model
  -> spoken response

Den här arkitekturen är optimerad för naturlig konversation med låg latens. Realtidsmodellen hanterar talade indata och utdata direkt. Inställningar som stöds och röstfamiljer är beroende av den valda modellen.

Överlappande textmodell

Caller audio
  -> speech recognition
  -> text model
  -> speech synthesis
  -> spoken response

Den här arkitekturen ger bredare textmodell och Azure röstval. Det ger också explicit kontroll över transkription, fraslistor, turidentifiering och interimsvar, men varje steg bidrar till svarstid från slutpunkt till slutpunkt.

Kärnresurser

En vanlig röstagent som skapats av portalen använder:

• En Foundry-resurs och ett projekt.
• En versionsbaserad röstbaserad promptagent.
• En fullständigt hanterad Voice Live-modell eller en berättigad kunddistribuerad modell.
• Azure Speech in Foundry Tools-funktioner för transkription eller syntes när det krävs av den valda arkitekturen.
• Application Insights för spårnings-, övervaknings- och utvärderingsdata.
• Azure Communication Services och Azure Event Grid för utökningsbara inkommande samtal i Teams Phone eller en Twilio-projektanslutning för Twilio-telefonnummerkanaler.

Du behöver inte distribuera en separat ljudmodell när du använder en fullständigt hanterad Voice Live-modell. Modelltillgänglighet och beteende läses in dynamiskt för din resurs och region.

Stödgränser i den aktuella portalen

Tillgänglighet och priser

Tillgänglighet beror på resursregionen Foundry, vald modell, vald röst, prenumeration och aktiverade förhandsgranskningsfunktioner. Kontrollera portalen innan du förlitar dig på en specifik modell.

Potentiella avgifter inkluderar generativ AI-modellinmatning och -utdata, taligenkänning och syntes, anpassad röstträning och värd, avataranvändning, Application Insights-inmatning och kvarhållning, Azure Communication Services samtal och telefonnummer, Microsoft Teams- och telefonitjänster samt anslutna verktyg och datatjänster. Information om kostnader finns i Priser för röstbaserade agenter.

Dokumentation om röstbaserad agent

Modellstöd

Agenttjänsten fungerar med många tillgängliga modeller i Foundry-modellkatalogen. Den fullständiga listan finns i Foundry-portalen.

Verktyg och verktygslådor

Agenter agerar i världen genom verktyg. Foundry erbjuder inbyggda verktyg som webbsökning, filsökning, kodtolkare och minne, samtidigt som du kan lägga till anpassade verktyg via funktioner, OpenAPI-specifikationer och MCP-servrar. Fullständig uppsättning finns i översikten över verktygslådan.

En verktygslåda grupperar dessa verktyg i en enda återanvändbar enhet. Du sammanställer verktygen en gång, och Foundry exponerar dem via en hanterad MCP-kompatibel endpoint som alla agenter eller körmiljöer kan använda, oavsett ramverk. Verktygslådor centraliserar autentisering, styrning och versionshantering, så att du uppdaterar verktygen på ett ställe i stället för att ändra om varje agent. Skapa en ny version, testa den och höj upp den till standard när du är redo. Mer information finns i Vad är Verktygslåda i Foundry?.

Ansluta och autentisera till MCP-fjärrservrar

Foundry stöder fjärranslutna MCP-servrar som du kan lägga till i din agent, till exempel Azure DevOps MCP-server. Anslut din Azure DevOps organisation för att aktivera agentåtkomst och konfigurera en delmängd av tillgängliga verktyg för att styra vilka åtgärder agenter kan utföra. Du kan också ansluta anpassade MCP-servrar som finns på Azure Functions med hjälp av Functions MCP webhook-slutpunkten (/runtime/webhooks/mcp) för att exponera anpassade verktyg för dina agenter.

Autentiseringsalternativ som stöds för MCP-servrar och andra verktygsanslutningar är:

• Nyckelbaserad åtkomst
• Microsoft Entra (med agentens hanterade identitet eller projektets hanterade identitet)
• OAuth-identitetsgenomströmning (påBehalf-Of)
• Oautentiserad åtkomst, i förekommande fall

De här autentiseringsalternativen gäller även vid anslutning av fjärranslutna MCP-servrar, med autentiseringsuppgifter och omfång som hanteras i verktygskonfigurationen.

Livscykel för utveckling

Agenttjänsten stöder det kompletta arbetsflödet för bygg, test, distribution och övervakning:

1. Skapa: Definiera en promptagent i portalen eller med SDK eller skriv en värdbaserad agent som anropar svars-API:et.
2. Test: Chatta med din agent på agenternas lekplats eller kör lokalt. MCP-serverintegreringar, inklusive anpassade MCP-servrar som finns på Azure Functions, kan utövas direkt på lekplatsen för att verifiera verktygsanslutning, behörigheter och beteende innan publicering.
3. Spårning: Inspektera varje modellanrop, verktygsanrop och beslut med agentspårning.
4. Utvärdera: Kör utvärderingar för att mäta kvalitet och fånga regressioner.
5. Optimera: Förbättra automatiskt den värdbaserade agentens instruktioner med hjälp av agentoptimeraren.
6. Publicera: Befordra din agent till en hanterad resurs med en stabil slutpunkt.
7. Övervaka: Spåra prestanda och tillförlitlighet med tjänstmått och instrumentpaneler.

En detaljerad genomgång finns i Livscykel för agentutveckling.

Företagsfunktioner

Agent service tillhandahåller infrastruktur i företagsklass för varje agent som du distribuerar:

• Agentidentitet: Varje agent kan ha en dedikerad Microsoft Entra identitet, vilket ger säker, begränsad åtkomst till resurser och API:er utan att dela autentiseringsuppgifter. Agentidentiteter kan autentisera mot externa MCP-servrar, inklusive de som finns på Azure Functions, och OAuth On-Behalf-Of (OBO) vidarebefordran stöds när de är konfigurerade.
• Privat nätverk: Kör agenter i ditt Azure virtuella nätverk för fullständig nätverksisolering och efterlevnad av kraven på datahemvist. Privat nätverk är tillgängligt för prompt-agenter. Värdbaserade agenter stöder bring-your-own Azure Virtual Network (BYO VNet), där varje session körs i en VM-isolerad sandbox som är ansluten till ditt virtuella nätverk.
• Rollbaserad åtkomstkontroll: Detaljerade behörigheter via Microsoft Entra och Azure RBAC. Kontrollera vem som kan skapa, anropa och hantera agenter.
• Innehållssäkerhet: Integrerade innehållsfilter hjälper till att minska risken för snabbinmatning (inklusive korsinmatning) och förhindra osäkra utdata.

Anvisningar för miljökonfiguration finns i Konfigurera din miljö.

Publicera och dela

Agent service tillhandahåller inbyggd versionshantering och publicering så att dina agenter kan gå från utveckling till produktion med tillförsikt.

• Versionshantering: När du itererar på din agent ögonblicksbilderas versionerna automatiskt. Återställ till en tidigare version eller jämför ändringar mellan versioner.
• Publicering: Befordra en agent till en hanterad resurs med en stabil slutpunkt. Publicerade agenter ärver de företagsidentitets- och åtkomstkontroller som konfigurerats för projektet och kan anropas programmatiskt.
• Distribution: Dela publicerade agenter via Microsoft Copilot och Teams och Entra Agent Registry, vilket placerar dina agenter där dina användare redan arbetar. Foundry Agent Service stöder OpenResponses- och aktivitetsprotokoll för Microsoft 365 publicering, ett anropsprotokoll för flexibel slutpunktsintegrering med anpassade appar och tjänster samt A2A-protokollet för agent-till-agent-kommunikation. A2A v1.0 är allmänt tillgängligt och v0.3 förblir i förhandsversion.

Säkerhet, sekretess och efterlevnad

Agenttjänsten är utformad för företagsarbetsbelastningar där du behöver starka kontroller över identitet, nätverk, datahantering och säkerhet.

• Säkerhetskontroller: Använd integrerade skyddsmekanismer för att minska osäkra utdata och minimera risken för promptinjektion, inklusive korspromptinjektionsattacker (XPIA).
• Kontroller för nätverksisolering och datahemvist: Använd virtuella nätverk och egna resurser för att uppfylla dina krav.
• Ta med egna resurser: Använd egna Azure-resurser (till exempel lagring, Azure AI-sökning och Azure Cosmos DB för konversationstillstånd) för att uppfylla efterlevnads- och driftbehov. Se Använda dina egna resurser.
• Responsible AI guidance: En bredare uppsättning rekommendationer och styrningsresurser finns i Responsible AI for Microsoft Foundry.

Relaterat innehåll

• Konfigurera din miljö
• Livscykel för agentutveckling
• Distribuera din första värdbaserade agent
• Översikt över Foundry Toolbox
• Distribuera din första värdbaserade agent
• Skapa en röstbaserad promptagent
• Metodtips för röstbaserade agenter
• Verktygskatalog
• Kvoter, gränser och regionalt stöd
• Om du vill ha hjälp eller ansluta till communityn går du med i Microsoft AI Discord.