Skapa en Azure AI-agent med Microsoft Agent Framework

Foundry Agent Service är den rekommenderade providern för produktionsmiljöer som skapats med Microsoft Agent Framework. Den hanterar beständig konversationshistorik på tjänstsidan, stöder inbyggda verktyg som kodkörning och filsökning och integreras sömlöst med Azure identitetshantering. Med de här funktionerna kan du fokusera på agentens beteende i stället för dess infrastrukturkostnader.

Konfigurera en Foundry-agent

När du skapar och interagerar med en Foundry-agent följer du en konsekvent sekvens med steg.

1. Konfigurera ditt Foundry-projekt

Innan du skriver någon kod behöver du ett Microsoft Foundry-projekt med en distribuerad modell. Du ansluter till projektet med hjälp av två typer av information:

• Projektets slutpunkt—URL-adressen till ditt Foundry-projekt.
• Namn på modelldistribution – namnet på den modelldistribution som du vill använda för din agent.

2. Konfigurera autentisering

Agent Framework ansluter till ditt Foundry-projekt med Azure autentiseringsuppgifter. I de flesta scenarier DefaultAzureCredential löser du rätt autentiseringsuppgifter automatiskt baserat på din miljö – Azure CLI under utveckling, hanterad identitet i produktion. Inga anslutningssträngar eller API-nycklar behöver hårdkodas.

3. Initiera Foundry-chattklienten

Skapa en Foundry-chattklient genom att ange dina autentiseringsuppgifter, projektslutpunkt och modellnamn. Den här klienten är bryggan mellan ditt program och Foundry Agent Service. Den hanterar autentisering, routning av begäranden och sessionshantering på tjänstsidan.

4. Skapa agenten

Skapa en agent med hjälp av chattklienten genom att ange en uppsättning instruktioner som definierar dess beteende:

• Instruktioner – systemprompten som definierar agentens roll, mål och begränsningar
• Verktyg(valfritt)– Anpassade funktioner som agenten kan anropa för att vidta åtgärder eller hämta information

Ramverket registrerar alla verktyg som du tillhandahåller och genererar automatiskt deras scheman, så att modellen vet när och hur de ska anropas.

5. Upprätta en session och kör agenten

Om du vill börja interagera öppnar du en session via agentinstansen. Sessionen fungerar som container för konversationstillståndet. Du skickar användarmeddelanden till sessionens körningsmetod, som bearbetar prompten, samordnar alla nödvändiga verktygsanrop och returnerar modellens svar.

Konversationer med flera omgångar

Ett enda anrop till agentens metod run hanterar en interaktion – ett användarmeddelande, ett svar. För en verklig konversation behöver du att agenten kommer ihåg vad som sades i tidigare repliker. Det är vad en session är till för.

För Foundry-providern backas sessionerna upp av lagring på tjänstsidan – konversationshistoriken finns i Foundry Agent Service i stället för i programmets minne.

• Beständig historik – Eftersom tillståndet finns på tjänstsidan kan en användares konversation fortsätta över flera begäranden, även om programmet startas om eller skalas ut till flera instanser.

• Lokal historik – För leverantörer som inte stöder historik på tjänstsidan upprätthåller ramverket konversationstillståndet i minnet i sessionsobjektet. Lokal historik är lämplig för kortvariga eller tillståndslösa program, men den bevaras inte mellan processomstarter.

Svar utan strömning jämfört med svar med strömning

Agent Framework stöder två svarslägen:

• Icke-direktuppspelning (synkron)– körningsmetoden väntar på att agenten ska slutföra bearbetningen och returnerar ett fullständigt svarsobjekt. Icke-direktuppspelning är det enklaste mönstret och fungerar bra när du inte behöver visa utdata stegvis.

• Direktuppspelning (asynkron) – körningsmetoden returnerar en svarsström som du itererar över asynkront och tar emot partiella uppdateringar när modellen genererar dem. Direktuppspelning passar bättre för användarriktade gränssnitt där utdata gradvis förbättrar upplevelsen.

I båda fallen exponerar svaret en text egenskap som aggregerar allt textinnehåll från agentens utdata, vilket gör det enkelt att extrahera det slutliga svaret oavsett vilket läge du använder.