Levenscyclus van agentontwikkeling

De levenscyclus van de ontwikkeling van agents in Microsoft Foundry bestrijkt van het begin tot aan toezicht op de productie. De kern van elke agent is een model uit de Foundry-modelcatalogus die redenering en reactiegeneratie aanstuurt. 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.

Voorwaarden

Levenscyclus in één oogopslag

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

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

Agenttypen in Microsoft Foundry

Er zijn drie typen agents:

  • Prompt-gebaseerd: Een prompt-gebaseerde agent is een declaratief gedefinieerde agent die een Foundry-model, instructies, tools en natuurlijke taalprompts 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 Build a workflow 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 Wat zijn gehoste agents? voor meer informatie.

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 kunt implementeren in Azure.

Op het tabblad Code in het chatvenster van de agentspeeltuin kunt u een codefragment dat verwijst naar uw agent meenemen naar de toegewezen Visual Studio Code voor de Web cloudomgeving. 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 op 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 agentbouwervaring biedt geïntegreerde ervaringen voor elke kernstap van de levenscyclus van agentontwikkeling. 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 in de agent-testomgeving testen. 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.

  • Ontwerpstatusbeheer: U kunt agents testen in een niet-opgeslagen toestand voor testdoeleinden. 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 Beschrijving
    Agent instellen Vergelijk configuratie-instellingen tussen versies met behulp van de versielijst.
    Chatuitvoer Antwoordverschillen tussen agentversies analyseren met identieke invoer
    YAML-definitie Verschillen in definities van (software/netwerk)agenten 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.

Debuggen en valideren met behulp van tracering (preview)

Wanneer u tools toevoegt en iteraties uitvoert op prompts, gebruikt u tracering om het end-to-end-gedrag 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 evalueren voor een code-first-werkstroom die u 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.

Raadpleeg Tracing-agents voor begeleiding.

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 Agent identity concepts 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:

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. Na het publiceren 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.

Verwante inhoud

Meer informatie over agenttypen:

Agents configureren en uitbreiden:

Publiceer en bewaak agenten:

Fouten opsporen en evalueren:

  • Last updated on