Agents testen, implementeren en integreren

Testen, implementeren en publiceren van agents zijn essentiële stappen bij het overstappen van ontwikkeling naar productie. Microsoft Foundry biedt uitgebreide mogelijkheden voor het valideren van agentgedrag, het implementeren in uw Foundry-project en het publiceren van agents als aanroepbare eindpunten die externe consumenten en toepassingen kunnen gebruiken.

Teststrategieën voor agents

Grondige tests zorgen ervoor dat uw agents zich betrouwbaar gedragen in diverse scenario's voordat ze gebruikers bereiken. Zowel de Foundry-portal als Visual Studio Code-extensie bieden speeltuinen voor interactieve tests.

De speeltuin effectief gebruiken:

• Gelukkige padtests : controleer of de agent veelvoorkomende, verwachte aanvragen correct verwerkt.
• Edge case testen - Probeer dubbelzinnige invoer, onvolledige informatie en ongebruikelijke aanvragen om aan te geven hoe agenten onzekerheid verwerken.
• Grenstests : controleer of de agent de grenzen respecteert die zijn gedefinieerd in de instructies door aanvragen buiten het bereik te testen.
• Gesprekstests met meerdere paden : controleer of de agent context behoudt in meerdere uitwisselingen en bouwt voort op eerdere antwoorden.
• Aanroepen van hulpprogramma's: controleer of agents de juiste hulpprogramma's op de juiste momenten aanroepen en de resultaten correct opnemen.

Noteer testresultaten om verbeteringen bij te houden en regressies te vangen.

Agents inzetten in uw project

Microsoft Foundry biedt ondersteuning voor het implementeren van agents vanuit de portal of Visual Studio Code. Door de implementatie wordt uw agentconfiguratie opgeslagen in uw Foundry-project, zodat u deze kunt testen en herhalen.

Implementeren vanuit de Foundry-portal

1. Navigeer naar uw agent in de Foundry-portal
2. Controleer of de configuratie- en testresultaten voldoende zijn
3. Selecteer Opslaan op de pagina van de agent
4. Versie- en implementatie-instellingen bevestigen

Implementeren vanuit Visual Studio Code

1. Open uw agent in de Foundry Toolkit
2. Selecteer Opslaan in Foundry om configuratiewijzigingen te pushen
3. Voor gehoste agents opent u het menu +Build in de ontwikkelhulpprogramma's en selecteert u Implementeren in Microsoft Foundry
4. Kies een implementatiemethode:
   • Code (ZIP Code Deploy) - Verpakt uw broncode en implementeert deze rechtstreeks zonder een containerimage
   • Container (BYOI) - Implementeren met behulp van een vooraf gebouwde containerimage uit Azure Container Registry
5. Selecteer uw model en bevestig

Bij beide benaderingen blijft uw agent binnen uw projectwerkruimte waar teamleden deze kunnen openen en testen.

Agents publiceren naar een eindpunt

Wanneer u een agent maakt in Microsoft Foundry, ontvangt deze automatisch een stabiel eindpunt, een eigen Entra-agentidentiteit en een agentblauwdruk. Publiceren verwijst vervolgens naar het distribueren van de agent, zodat externe consumenten en toepassingen, waaronder Microsoft Teams en Microsoft 365 Copilot, deze kunnen aanroepen.

Wat elke agent bevat

Elke agent die in Foundry is gemaakt, wordt ingericht met:

• Stabiel eindpunt : een aanroep-URL die gereed is voor productie die constant blijft, zelfs wanneer u agentversies bijwerkt.
• Entra-agentidentiteit: een toegewezen Microsoft Entra identiteit met een eigen RBAC-bereik, gescheiden van de gedeelde identiteit van het project.
• Authenticatiebeleid - ingebouwde Microsoft Entra ID-authenticatie. Oproepers moeten de rol Foundry User hebben voor de agentresource. Verificatie van API-sleutels wordt niet ondersteund.

Publiceren naar Microsoft Teams en Microsoft 365 Copilot

Vanuit de Foundry-portal kunt u agents publiceren naar Microsoft Teams en Microsoft 365 Copilot met één stap, zonder opnieuw te hoeven bouwen. De agent gaat door een geïntegreerde pijplijn naar de toepassingen waar gebruikers al werken.

Het endpoint van de agent

Agents maken een stabiel eindpunt beschikbaar met behulp van het Responses API-protocol:

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

Deze URL blijft hetzelfde, zelfs als u nieuwe agentversies uitrolt, zodat downstreamgebruikers niet worden onderbroken door updates.

Het eindpunt verifiëren

Nadat u de agent hebt gemaakt en geconfigureerd, controleert u of het eindpunt werkt:

1. Een toegangstoken ophalen:

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

2. Roep het eindpunt van de agent aan:

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

Als u het bericht ontvangt 403 Forbidden, controleert u of de aanroeper de rol Foundry User heeft op de agentresource.

Agents bijwerken

Een nieuwe agentversie implementeren:

1. Breng wijzigingen aan in uw ontwikkelomgeving en test grondig
2. Sla in de Foundry-portal de bijgewerkte agentconfiguratie op
3. Het eindpunt routeert verkeer automatisch naar de nieuwe versie

De eindpunt-URL blijft ongewijzigd, zodat bestaande integraties blijven werken.

Integratiecode genereren

De Foundry Toolkit voor VS Code genereert voorbeeldintegratiecode om uw toepassing te verbinden met een gepubliceerde agent:

1. Selecteer uw geïmplementeerde agent in de weergave Mijn bronnen
2. Selecteer Code weergeven
3. Uw map kiezen
4. De extensie genereert code voor verificatie, verbinding maken, berichten verzenden en antwoorden verwerken

Integratiepatronen

Veelvoorkomende patronen voor het integreren van gepubliceerde agents zijn:

• Webtoepassingen : gebruikersberichten verzenden naar het eindpunt van de antwoorden-API en antwoorden weergeven in uw gebruikersinterface. Sla de gespreksgeschiedenis bij de client op voor interacties met meerdere wendingen.
• API-gestuurde werkstromen : roep het agenteindpunt aan vanuit back-endservices die worden geactiveerd door gebeurtenissen of planningen. Reacties programmatisch verwerken om downstreamacties te stimuleren.
• Chatbotinterfaces : gebruikerssessies toewijzen aan gesprekken. Afhandelen van realtime berichtuitwisseling via het eindpunt.
• Automatisering op de achtergrond : plan agentoproepen voor terugkerende taken. Voer systeemgegevens in agents en procesuitvoer om bedrijfssystemen bij te werken.

Overwegingen voor productie

Het uitvoeren van agents in de productieomgeving vereist aandacht voor verschillende operationele gebieden.

• Bewaking: reactietijden bijhouden, slagingspercentages voor hulpprogramma's, foutpatronen en tokenverbruik bijhouden met behulp van Application Insights-integratie.
• Beveiliging : gebruik beheerde identiteiten voor verificatie, pas toegang met minimale bevoegdheden toe en definieer beleid voor gegevensretentie.
• Kostenbeheer : bewaak het tokengebruik, stel de limieten voor de reactielengte in en implementeer frequentielimieten om onverwachte pieken te voorkomen.
• Foutafhandeling: implementeer logica voor opnieuw proberen met exponentieel uitstel voor tijdelijke fouten. Snelheidslimieten verwerken met back-off-strategieën. Valideer invoer voordat u naar agents verzendt.
• Gespreksbeheer : agenteindpunten ondersteunen momenteel alleen de stateless Response-API. Sla de gespreksgeschiedenis op in uw client voor ervaringen met meerdere beurten.