Testa, distribuera och integrera agenter

Testning, distribution och publicering av agenter är viktiga steg i övergången från utveckling till produktion. Microsoft Foundry innehåller omfattande funktioner för att verifiera agentbeteende, distribuera till ditt Foundry-projekt och publicera agenter som anropbara slutpunkter som externa konsumenter och program kan använda.

Testa strategier för agenter

Noggrann testning säkerställer att dina agenter beter sig tillförlitligt i olika scenarier innan de når användarna. Både Foundry-portalen och Visual Studio Code-tillägget tillhandahåller lekplatser för interaktiv testning.

Använda lekplatsen effektivt:

• Lyckad sökvägstestning – Kontrollera att agenten hanterar vanliga, förväntade begäranden korrekt.
• Edge-falltestning – Prova tvetydiga indata, ofullständig information och ovanliga begäranden för att avslöja hur agenter hanterar osäkerhet.
• Gränstestning – Bekräfta att agenten respekterar gränser som definierats i instruktionerna genom att testa förfrågningar utanför omfånget.
• Konversationstestning med flera turer – Kontrollera att agenten upprätthåller kontexten över flera utbyten och bygger på tidigare svar.
• Test av verktygsanrop – Kontrollera att agenter anropar rätt verktyg vid rätt tidpunkter och införlivar resultaten korrekt.

Registrera testresultat för att spåra förbättringar och fånga regressioner.

Distribuera agenter till projektet

Microsoft Foundry stöder distribution av agenter från portalen eller Visual Studio Code. När du distribuerar sparas agentkonfigurationen i Foundry-projektet så att du kan testa och iterera.

Distribuera från Foundry-portalen

1. Navigera till din agent i Foundry-portalen
2. Kontrollera att konfigurations- och testresultaten är tillfredsställande
3. Välj Spara på agentens sida
4. Bekräfta inställningarna för version och distribution

Distribuera från Visual Studio Code

1. Öppna din agent i Foundry Toolkit
2. Välj Spara till Foundry för att push-överföra konfigurationsändringar
3. För värdbaserade agenter öppnar du menyn +Build i utvecklarverktygen och väljer Distribuera till Microsoft Foundry
4. Välj en distributionsmetod:
   • Kod (ZIP Code Deploy) – Paketerar källkoden och distribuerar den direkt utan en containeravbildning
   • Container (BYOI) – Distribuera med en fördefinierad containeravbildning från Azure Container Registry
5. Välj din modell och bekräfta

Båda metoderna håller din agent inom din projektarbetsyta där teammedlemmar kan komma åt och testa den.

Publicera agenter till en slutpunkt

När du skapar en agent i Microsoft Foundry får den automatiskt en stabil slutpunkt/endpoint, en egen Entra-agentidentitet och en agentplan. Publicering syftar sedan på att distribuera agenten så att externa konsumenter och program – inklusive Microsoft Teams och Microsoft 365 Copilot – kan anropa den.

Vad varje agent innehåller

Varje agent som skapas i Foundry provisioneras med:

• Stabil endpoint – En produktionsklar anrops-URL som förblir konstant även när du uppdaterar agentversioner.
• Entra-agentidentitet – en dedikerad Microsoft Entra identitet med ett eget RBAC-omfång, separat från projektets delade identitet.
• Autentiseringsprincip – inbyggd Microsoft Entra ID autentisering. Anropare måste ha rollen Foundry User på agentresursen. API-nyckelautentisering stöds inte.

Publicera till Microsoft Teams och Microsoft 365 Copilot

Från Foundry-portalen kan du publicera agenter till Microsoft Teams och Microsoft 365 Copilot med ett enda steg – ingen ombyggnad krävs. Agenten rör sig genom en enhetlig pipeline till de program där användarna redan arbetar.

Agentslutpunkt

Agenter tillhandahåller en stabil endpoint med hjälp av protokollet Responses API:

https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>/agents/<agent-name>/endpoint/protocols/openai/responses

Den här URL:en förblir densamma även när du distribuerar nya agentversioner, så nedströmskonsumenter störs inte av uppdateringar.

Verifiera slutpunkten

När du har skapat och konfigurerat din agent kontrollerar du att slutpunkten fungerar:

1. Hämta en åtkomsttoken:

   az account get-access-token --resource https://ai.azure.com
   

2. Anropa agentslutpunkten:

   curl -X POST \
     "https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>/agents/<agent-name>/endpoint/protocols/openai/responses?api-version=2025-11-15-preview" \
     -H "Authorization: ******" \
     -H "Content-Type: application/json" \
     -d '{"input":"Say hello"}'
   

Om du får 403 Forbidden, bekräfta att anroparen har rollen Foundry-användare på agentresursen.

Uppdaterar agenter

Så här distribuerar du en ny agentversion:

1. Gör ändringar i utvecklingsmiljön och testa noggrant
2. Spara den uppdaterade agentkonfigurationen i Foundry-portalen
3. Endpoint dirigerar trafik till den nya versionen automatiskt

Slutpunkts-URL:en förblir oförändrad, så befintliga integreringar fortsätter att fungera.

Generera integrationskod

Foundry Toolkit för VS Code genererar exempelintegreringskod för att ansluta ditt program till en publicerad agent:

1. Välj din distribuerade agent i vyn Mina resurser
2. Välj Visa kod
3. Välj din mapp
4. Tillägget genererar kod för att autentisera, ansluta, skicka meddelanden och bearbeta svar

Integrationsmönster

Vanliga mönster för integrering av publicerade agenter är:

• Webbprogram – Skicka användarmeddelanden till svars-API-slutpunkten och visa svar i användargränssnittet. Lagra konversationshistorik på klientsidan för interaktioner med flera turer.
• API-drivna arbetsflöden – Anropa agentslutpunkten från serverdelstjänster som utlöses av händelser eller scheman. Bearbeta svar programmatiskt för att driva nedströmsåtgärder.
• Chattrobotgränssnitt – Mappa användarsessioner till konversationer. Hantera meddelandeutbyte i realtid via slutpunkten.
• Bakgrundsautomatisering – Schemalägg agentanrop för återkommande uppgifter. Mata in systemdata i agenter och bearbeta utdata för att uppdatera affärssystem.

Produktionsöverväganden

Att köra agenter i produktion kräver uppmärksamhet på flera verksamhetsområden:

• Övervakning – Spåra svarstider, framgångsfrekvenser för verktygsanrop, felmönster och tokenförbrukning med hjälp av Application Insights-integrering.
• Säkerhet – Använd hanterade identiteter för autentisering, tillämpa åtkomst med lägsta behörighet och definiera principer för datakvarhållning.
• Kostnadshantering – Övervaka tokenanvändning, ange svarslängdsgränser och implementera hastighetsbegränsning för att förhindra oväntade toppar.
• Felhantering – Implementera logik för återförsök med exponentiell backoff för tillfälliga fel. Hantera hastighetsbegränsning med backoff-strategier. Verifiera indata innan du skickar till agenter.
• Konversationshantering – Agentändpunkter stöder för närvarande endast det tillståndslösa Responses API:et. Lagra konversationshistorik i klienten för interaktioner med flera dialogrundor.