Test, udrul og integrer agenter

  • 9 minutter

Tip

Se fanen Tekst og billeder for flere detaljer!

Test, udrulning og publicering af agenter er afgørende skridt i overgangen fra udvikling til produktion. Microsoft Foundry tilbyder omfattende funktioner til validering af agentadfærd, udrulning til dit Foundry-projekt og publicering af agenter som kaldbare endepunkter, som eksterne brugere og applikationer kan bruge.

Teststrategier for agenter

Grundig test sikrer, at dine agenter opfører sig pålideligt på tværs af forskellige scenarier, før de når brugerne. Både Foundry-portalen og Visual Studio Code-udvidelsen tilbyder legepladser til interaktiv testning.

Effektiv brug af legepladsen:

  • Happy path testing - Bekræfte, at agenten håndterer almindelige, forventede forespørgsler korrekt.
  • Edge case-test – Prøv tvetydige input, ufuldstændig information og usædvanlige anmodninger for at afsløre, hvordan agenter håndterer usikkerhed.
  • Grænsetest - Bekræft at agenten respekterer grænserne defineret i instruktionerne ved at teste anmodninger uden for omfanget.
  • Multi-turn samtaletest - Verdsig, at agenten opretholder konteksten på tværs af flere udvekslinger og bygger videre på tidligere svar.
  • Værktøjsinkaldelsestest - Verificér at agenter kalder de rigtige værktøjer på de rigtige tidspunkter og indarbejder resultaterne korrekt.

Optag testresultater for at spore forbedringer og fangstregressioner.

Udsendelse af agenter til dit projekt

Microsoft Foundry understøtter udrulning af agenter fra portalen eller Visual Studio Code. Udrulning gemmer din agentkonfiguration til dit Foundry-projekt, så du kan teste og iterere.

Udrulning fra Foundry-portalen

  1. Navigér til din agent i Foundry-portalen
  2. Verificér konfiguration og testresultater er tilfredsstillende
  3. Vælg Gem fra agentens side
  4. Bekræft version og udrulningsindstillinger

Udrulning fra Visual Studio Code

  1. Åbn din agent i AI Toolkit
  2. Vælg Save to Foundry for at skubbe konfigurationsændringer
  3. For hostede agenter skal du åbne +Byg-menuen i udviklerværktøjerne og vælge Deploy to Microsoft Foundry
  4. Vælg din containerkonfiguration og bekræft

Begge tilgange holder din agent inden for projektets arbejdsområde, hvor teammedlemmer kan få adgang til og teste det.

Publiceringsagenter til et endpoint

Publicering flytter en agent fra dit projektarbejdsområde til en administreret Azure-ressource kaldet en Agent Application. Dette trin er det, der gør din agent eksternt kaldbar gennem et stabilt endepunkt.

Hvad forlagsbranchen skaber

Når du udgiver en agentversion, opretter Foundry:

  • Agent Application - En Azure-ressource med sin egen kald-URL, autentificeringspolitik og Entra-agentidentitet.
  • Deployment - En kørende instans af en specifik agentversion inde i applikationen med start/stop livscyklusstyring.

Den væsentlige forskel mellem at implementere og udgive er omfanget. Udsendelsen holder agenten inden for dit projekt. Publicering skaber et dedikeret endpoint, som eksterne forbrugere kan kalde uden at skulle have adgang til dit Foundry-projekt.

Udgivelse fra Foundry-portalen

  1. I portalen vælger du den agentversion, du ønsker at udgive
  2. Vælg Publicér for at oprette agentapplikationen og implementeringen

Udgivelse fra Visual Studio Code

  1. Åbn Command Palette (Ctrl+Shift+P) og kør Microsoft Foundry: Deploy Hosted Agent for hosted agents
  2. Vælg mål-workspace og containerkonfiguration
  3. Bekræft og udsend

Efter publicering vises agenten i sektionen Hosted Agents (Preview) i AI Toolkit-udvidelsestrævisningen.

Agent Applikationens endepunkt

Publicerede agenter eksponerer et stabilt endepunkt ved hjælp af Responses API-protokollen:

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

Denne URL forbliver den samme, selv når du udruller nye agentversioner, så downstream-forbrugere ikke bliver forstyrret af opdateringer.

Autentificering og identitet

Agent-applikationer bruger Microsoft Entra ID til autentificering. Opkaldere skal have Azure AI User-rollen på Agent Application-ressourcen. API-nøgleautentificering understøttes ikke for agentapplikationer.

Vigtigt!

Når du udgiver en agent, modtager den sin egen dedikerede Entra-identitet, adskilt fra projektets fælles identitet. Tilladelser overføres ikke automatisk. Du skal omfordele RBAC-roller til den nye agentidentitet for alle ressourcer, agenten får adgang til. Hvis du springer dette trin over, fejler værktøjskald, der arbejder under udviklingen, med autorisationsfejl, når agenten er offentliggjort.

Verificering af endepunktet

Efter publicering, verificér at endepunktet virker:

  1. Få en adgangstok:

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

  2. Kald Agent Application-endpointet:

    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"}'

Hvis du modtager 403 Forbidden, bekræft at opkalderen har Azure AI Bruger-rollen på Agent Application-ressourcen.

Opdatering af offentliggjorte agenter

For at rulle en ny agentversion ud:

  1. Foretag ændringer i dit udviklingsmiljø og test grundigt
  2. I Foundry-portalen vælger du Publish Updates fra Agent-legepladsen
  3. Agentapplikationen dirigerer automatisk 100% trafik til den nye version

Endpoint-URL'en forbliver uændret, så eksisterende integrationer fortsætter med at fungere.

Generering af integrationskode

Microsoft Foundry VS Code-udvidelsen genererer eksempelintegrationskode, der forbinder din applikation til en publiceret agent:

  1. Vælg din deployerede agent i My Resources-visningen
  2. Vælg Visningskode
  3. Vælg din mappe
  4. Udvidelsen genererer kode til autentificering, forbindelse, afsendelse af beskeder og behandling af svar

Integrationsmønstre

Almindelige mønstre til integration af offentliggjorte midler inkluderer:

  • Webapplikationer - Send brugerbeskeder til Responses API-endpointet og vis svarene i dit brugerinterface. Gem samtalehistorik på klientsiden til interaktioner med flere ture.
  • API-drevne workflows - Kald agentens endpoint fra backend-tjenester, der udløses af events eller tidsplaner. Procesreaktioner programmatisk for at drive nedstrøms handlinger.
  • Chatbot-grænseflader - Kortlæg brugersessioner til samtaler. Håndter realtidsudveksling af beskeder gennem endpointet.
  • Baggrundsautomatisering - Planlæg agentopkald til tilbagevendende opgaver. Indsend systemdata til agenter og processoutput for at opdatere forretningssystemer.

Produktionshensyn

At køre agenter i produktion kræver opmærksomhed på flere driftsområder:

  • Overvågning - Spor responstider, succesrater for værktøjsinkald, fejlmønstre og tokenforbrug ved hjælp af Application Insights-integration.
  • Sikkerhed - Brug administrerede identiteter til autentificering, anvend mindst privilegier-adgang og definer dataopbevaringspolitikker.
  • Omkostningsstyring - Overvåg tokenbrug, sæt grænser for responslængde, og implementér hastighedsbegrænsning for at forhindre uventede stigninger.
  • Fejlhåndtering - Implementér genprøvningslogik med eksponentiel backoff for midlertidige fejl. Håndter hastighedsbegrænsning med backoff-strategier. Valider input, før du sender dem til agenter.
  • Samtalestyring - Agent Applikationens endepunkter understøtter i øjeblikket kun den stateless Responses API. Gem samtalehistorik i din klient for oplevelser med flere ture.