Levenscyclus van agentontwikkeling

De levenscyclus van agentontwikkeling in Microsoft Foundry loopt van de eerste creatie tot en met productiebewaking. Door deze levenscyclus te volgen, kunt u betrouwbare agents bouwen, problemen vroegtijdig vangen en met vertrouwen verzenden. Gebruik de Foundry-portal of code om het gedrag van uw agent te bouwen, aan te passen en te testen. Herhaal vervolgens met tracering, evaluatie en bewaking om de kwaliteit en betrouwbaarheid te verbeteren. Wanneer u klaar bent, publiceert u uw agent als agenttoepassing om deze te delen en te integreren in uw apps.

Dit artikel is bedoeld voor ontwikkelaars die agents willen bouwen, testen en verzenden die gereed zijn voor productie.

Vereiste voorwaarden

Een Microsoft Foundry-project
Bekendheid met de Agents-speeltuin
Voor codeontwikkeling: Bekendheid met de installatie van de ontwikkelomgeving

Levenscyclus in één oogopslag

Gebruik deze levenscyclus als praktische controlelijst terwijl u een agent bouwt en verzendt.

Kies een agenttype: Begin met een agent op basis van prompts, een werkstroom of een gehoste agent.
Maak uw agent en begin te testen: Herhalen in de speeltuin of in code.
Hulpprogramma's en gegevens toevoegen: Koppel hulpprogramma's voor het ophalen en acties en valideer de configuratie voordat u opslaat.
Sla wijzigingen op als versies: leg zinvolle mijlpalen vast en vergelijk versies.
Fouten opsporen met tracering: gebruik tracering om aanroepen, latentie en end-to-endgedrag van hulpprogramma's te bevestigen. Zie Overzicht van agenttracering voor details.
Kwaliteit en veiligheid evalueren: herhaalbare evaluaties uitvoeren om regressies te vangen voordat ze worden gepubliceerd. Zie Agent-evaluators voor conceptuele richtlijnen.
Publiceren en integreren: Publiceer een stabiel eindpunt en integreer dit in uw toepassing. Zie Publiceren en delen van agents in Microsoft Foundry voor stappen.
Bewaken en herhalen: bewaak de prestaties en kwaliteit in productie en werk deze vervolgens indien nodig bij en publiceer deze opnieuw. Zie voor richtlijnen Kwaliteit en veiligheid bewaken.

Agenttypen in Microsoft Foundry

Er zijn drie typen agents:

Prompt-gebaseerd: Een prompt-gebaseerde agent is een declaratief gedefinieerde enkele agent die modelconfiguratie, instructies, tools en prompts in natuurlijke taal combineert om gedrag aan te sturen. Breid het uit door hulpprogramma's voor kennis en geheugen te koppelen. Bewerk, versie, test, evalueer, bewaak en publiceer agents op basis van prompts vanuit de agents-speeltuin in de Foundry-portal.
Werkstroom: Werkstromen gebruiken om een geavanceerdere werkstroom te bouwen waarmee een reeks acties wordt ingedeeld of meerdere agents worden gecoördineerd. Werkstromen hebben hun eigen interface in de portal, maar dezelfde levenscyclus is van toepassing. Zie Een werkstroom bouwen in Microsoft Foundry voor meer informatie.
Gehoste (preview): gehoste agents zijn in containers geplaatste agents die u in code bouwt met behulp van ondersteunde frameworks of aangepaste code. Foundry Agent Service implementeert en beheert deze agents. U bewerkt gehoste agents niet in de gebruikersinterface voor het bouwen van agents, maar u kunt deze nog steeds aanroepen, evalueren, bewaken en publiceren. Zie voor meer informatie Wat zijn gehoste agents?

Maak agents en werkstromen op basis van prompts in de Foundry-portal of uw eigen ontwikkelomgeving met behulp van de CLI, SDK of REST API. Zie de quickstart voor meer informatie.

Een agent op basis van prompts maken

Als u al weet welk type agent u wilt maken, noemt u deze en begint u vervolgens met het configureren van de modelinstructies en hulpprogramma's.

Opmerking

Nadat u uw agent een naam hebt opgegeven, kunt u de naam niet wijzigen. In code verwijst u naar uw agent door <agent_name>:<version>.

Agents ontwikkelen in code

Als u liever in code werkt, gebruikt u ondersteunde manieren om uw agentcode naar een ontwikkelomgeving te brengen waaruit u lokaal kunt testen en vervolgens in Azure kunt implementeren.

Op het tabblad Code in het chatvenster van de agentspeeltuin kunt u een codefragment dat naar uw agent verwijst overbrengen naar een speciale Visual Studio Code cloudomgeving voor het web. Het fragment wordt vooraf geconfigureerd met de pakketten en extensies die u nodig hebt, samen met instructies voor het efficiënt ontwikkelen en implementeren van uw Foundry-agent in Azure. U kunt het codefragment ook rechtstreeks naar uw favoriete ontwikkelomgeving kopiëren. Zie de documentatie voor speeltuinen voor meer informatie.

Kernmogelijkheden voor de levenscyclus van agentontwikkeling

De ervaring voor het bouwen van agents biedt geïntegreerde ervaringen voor elke kernstap van de ontwikkelingslevenscyclus van de agent. Gebruik deze kernmogelijkheden bij het ontwikkelen van uw productieklare agenttoepassing. Elke mogelijkheid bevat uitgebreide documentatie waar u meer informatie kunt vinden.

Wijzigingen opslaan als versies

Nadat u de eerste versie van een op prompts gebaseerde agent of een werkstroom hebt gemaakt, slaat u de volgende wijzigingen op als nieuwe versies. U kunt niet-opgeslagen wijzigingen testen in de agentomgeving. Maar als u de gespreksgeschiedenis wilt bekijken, de prestaties van uw agent wilt controleren of volledige evaluaties wilt uitvoeren, moet u uw wijzigingen opslaan.

Versiebeheer van agents biedt de volgende mogelijkheden voor het beheren van agentconfiguraties en iteraties. Dit systeem zorgt ervoor dat alle wijzigingen worden bijgehouden, getest en vergelijkbaar zijn in verschillende versies.

Onveranderbaarheid van de versie: elke versie van een agent kan onveranderbaar zijn nadat u deze hebt opgeslagen. Wijzigingen in een bestaande versie vereisen het opslaan en maken van een nieuwe versie. Deze vereiste zorgt voor versie-integriteit en voorkomt onbedoelde overschrijven.
Conceptstatusbeheer: U kunt agents testen in een niet-opgeslagen status voor experimenten. U verliest niet-opgeslagen wijzigingen als u de Foundry-portal verlaat, dus sla regelmatig op om belangrijke wijzigingen te behouden.
Bewerkingen voor versiebeheer: u kunt aanvragen doorsturen naar specifieke agentversies om gecontroleerde implementatie- en terugdraaimogelijkheden in te schakelen.

Versiegeschiedenisnavigatie: open de versiegeschiedenis voor elke agent, ga naar een specifieke versie en voer de volgende vergelijkingen uit:

Vergelijkingstype	Description
Agent instellen	Vergelijk configuratie-instellingen van verschillende versies met behulp van de vervolgkeuzelijst met versies.
Chat-uitvoer	Antwoordverschillen tussen agentversies analyseren met identieke invoer
YAML-definitie	Verschillen in agentdefinities controleren

Hulpprogramma's toevoegen

Maak uw agent krachtiger door deze kennis te geven (specifieke bestanden of indexen) of door toe te staan om acties uit te voeren (externe API's aanroepen). Hulpprogramma's zijn beschikbaar voor de meeste gebruiksvoorbeelden, van eenvoudige bestandsuploads naar aangepaste MCP-serververbindingen (Model Context Protocol). Voor complexere hulpprogramma's moet u mogelijk verificatie configureren of verbindingen toevoegen als onderdeel van het koppelen aan een agent.

Als u een agent wilt opslaan waaraan een hulpprogramma is gekoppeld, moet u het hulpprogramma configureren. Geconfigureerde hulpprogramma's opnieuw gebruiken tussen agents. Zie de catalogus met hulpprogramma's voor informatie over beschikbare hulpprogramma's.

Fouten opsporen en valideren met behulp van traceren (preview)

Wanneer u hulpprogramma's toevoegt en prompts herhalen, gebruikt u tracering om end-to-endgedrag te valideren:

Controleer of de agent de hulpprogramma's heeft aangeroepen die u had verwacht.
Controleer de invoer en uitvoer van het hulpprogramma.
Identificeer latentie hotspots in model- en hulpprogramma-aanroepen.

Zie overzicht van agenttracering voor meer informatie.

Kwaliteit en veiligheid evalueren (preview)

Voordat u uw agent publiceert (en na een zinvolle wijziging), voert u evaluaties uit om regressies te vangen en de kwaliteit consistent te meten in verschillende versies.

Zie Agent-evaluators voor de belangrijkste evaluatiedimensies voor agents.
Zie Uw AI-agents lokaal evalueren voor een werkstroom die u met code eerst kunt automatiseren.

Controleren na publicatie

Nadat u een agenttoepassing hebt gepubliceerd, behandelt u deze als productiesoftware:

Kwaliteits- en veiligheidssignalen bewaken.
Controleer traceringen wanneer gedrag verandert.
Werk bij en publiceer deze opnieuw wanneer u problemen oplost of verbeteringen aanbrengt.

Zie voor richtlijnen Kwaliteit en veiligheid bewaken.

Identiteit en machtigingen plannen

Voor hulpprogramma's en downstreambronnen is vaak verificatie vereist. Wanneer u een agent publiceert, kan het bijbehorende identiteits- en machtigingsmodel worden gewijzigd. Zorg ervoor dat uw gepubliceerde agent alleen toegang heeft die nodig is.

Zie Identiteitsconcepten van agents in Microsoft Foundry voor meer informatie.

Beveiliging en toegang

Behandel de configuratie van uw agent, zoals toepassingscode. Geheimen en machtigingen gedurende de hele levenscyclus beveiligen:

Gebruik minimale bevoegdheden en roltoewijzingen in plaats van sleutels in te sluiten. Zie op rollen gebaseerd toegangsbeheer in Foundry Portal voor meer informatie.
Sla geheimen op in een beheerd geheimarchief en verwijs ernaar via verbindingen in plaats van ze in code, configuratiebestanden of prompts te coderen. Zie Een Key Vault-verbinding instellen voor hulp.
Controleer voordat u publiceert of de identiteit en hulpprogrammaverbindingen van de agent in de gepubliceerde agenttoepassing alleen de toegang hebben die ze nodig hebben. Zie Identiteitsconcepten van agents in Microsoft Foundry voor meer informatie.

Uw agent of werkstroom publiceren

Nadat u een agent of werkstroomversie hebt gemaakt waarmee u tevreden bent, publiceert u deze als agenttoepassing. U krijgt een stabiel eindpunt dat u kunt openen en testen in de browser, met anderen kunt delen of insluiten in uw bestaande toepassingen. U en uw medewerkers kunnen de prestaties valideren en bepalen wat verfijning nodig heeft. Breng alle benodigde updates aan en publiceer een nieuwe versie op elk gewenst moment opnieuw.

Belangrijk

Machtigingen die zijn toegewezen aan de projectidentiteit, worden niet automatisch overgedragen naar de gepubliceerde agent. Nadat de toepassing is gepubliceerd, moet u de benodigde bevoegdheden opnieuw toewijzen aan de identiteit van de agenttoepassing.

Veelvoorkomende valkuilen voor het ontwikkelen van agents

Niet-opgeslagen wijzigingen zijn tijdelijk: als u versies wilt vergelijken, de geschiedenis wilt bekijken of volledige evaluaties wilt uitvoeren, slaat u uw wijzigingen op als een versie.
Hulpprogramma's moeten worden geconfigureerd voordat u opslaat: Als voor een hulpprogramma verificatie of een verbinding is vereist, moet u de installatie voltooien voordat u het bestand opslaat.
Publiceren kan machtigingsupdates vereisen: na publicatie controleert u de resourcetoegang voor de gepubliceerde agentidentiteit opnieuw en verwijdert u de toegang die de agent niet meer nodig heeft.

Meer informatie over agenttypen:

Agents configureren en uitbreiden:

Agents publiceren en bewaken:

Fouten opsporen en evalueren:

Feedback

Is deze pagina nuttig?

Last updated on 2026-02-28