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 AI 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 containerkonfigurationen 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

Publicering flyttar en agent från projektarbetsytan till en hanterad Azure-resurs som kallas agentprogram. Det här steget gör att din agent kan anropas externt via en stabil slutpunkt.

Vad publicering skapar

När du publicerar en agentversion skapar Foundry:

• Agentprogram – en Azure-resurs med en egen anrops-URL, autentiseringsprincip och Entra-agentidentitet.
• Driftsättning – En körande instans av en specifik agentversion i applikationen, med start-/stopplivscykelhantering.

Den viktigaste skillnaden mellan distribution och publicering är omfång. Införandet behåller agenten inom ditt projekt. Publicering skapar en dedikerad slutpunkt som externa konsumenter kan anropa utan att behöva åtkomst till ditt Foundry-projekt.

Publicera från Foundry-portalen

1. I portalen väljer du den agentversion som du vill publicera
2. Välj Publicera för att skapa agentprogrammet och distributionen

Publicera från Visual Studio Code

1. Öppna kommandopaletten (Ctrl+Skift+P) och kör Microsoft Foundry: Distribuera värdbaserad agent för värdbaserade agenter
2. Välj målarbetsytan och containerkonfigurationen
3. Bekräfta och distribuera

Efter publiceringen visas agenten i avsnittet Värdbaserade agenter (förhandsversion) i trädvyn för AI Toolkit-tillägget.

Slutpunkten för agentprogrammet

Publicerade agenter exponerar en stabil slutpunkt med hjälp av protokollet svars-API:

https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>/applications/<app-name>/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.

Autentisering och identitet

Agentprogram använder Microsoft Entra-ID för autentisering. Anropare måste ha rollen Azure AI-användare på agentprogramresursen. API-nyckelautentisering stöds inte för agentprogram.

Verifiera slutpunkten

När du har publicerat kontrollerar du att slutpunkten fungerar:

1. Hämta en åtkomsttoken:

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

2. Anropa agentprogrammets slutpunkt:

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

Om du får 403 Forbiddenbekräftar du att anroparen har rollen Azure AI-användare på agentprogramresursen.

Uppdatering av publicerade agenter

Så här distribuerar du en ny agentversion:

1. Gör ändringar i utvecklingsmiljön och testa noggrant
2. I Foundry-portalen väljer du Publicera uppdateringar från agentlekplatsen
3. Agentprogrammet dirigerar 100% trafik till den nya versionen automatiskt

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

Generera integrationskod

Tillägget Microsoft Foundry 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 – Agentprogramslutpunkter stöder för närvarande endast det tillståndslösa svars-API:et. Lagra konversationshistorik i klienten för interaktioner med flera dialogrundor.