Dela via

Livscykel för agentutveckling

Agentutvecklingslivscykeln i Microsoft Foundry sträcker sig från första skapandet till produktionsövervakning. Genom att följa den här livscykeln kan du skapa tillförlitliga agenter, fånga problem tidigt och skicka dem säkert. Använd Foundry-portalen eller koden för att skapa, anpassa och testa agentens beteende. Iterera sedan med spårning, utvärdering och övervakning för att förbättra kvalitet och tillförlitlighet. När du är redo publicerar du din agent som ett agentprogram för att dela den och integrera den i dina appar.

Den här artikeln är avsedd för utvecklare som vill skapa, testa och skicka produktionsklara agenter.

Förutsättningar

Livscykel i korthet

Använd den här livscykeln som en praktisk checklista när du skapar och skickar en agent.

  1. Välj en agenttyp: Börja med en promptbaserad agent, ett arbetsflöde eller en värdbaserad agent.
  2. Skapa din agent och börja testa: Iterera på lekplatsen eller i kod.
  3. Lägg till verktyg och data: Bifoga verktyg för hämtning och åtgärder och verifiera konfigurationen innan du sparar.
  4. Spara ändringar som versioner: Samla in meningsfulla milstolpar och jämför versioner.
  5. Felsökning med spårning: Använd spårning för att bekräfta verktygsanrop, svarstider och beteende från slutpunkt till slutpunkt. Mer information finns i Översikt över agentspårning.
  6. Utvärdera kvalitet och säkerhet: Kör repeterbara utvärderingar för att fånga upp regressioner innan du publicerar. Konceptuell vägledning finns i Agentutvärderingar.
  7. Publicera och integrera: Publicera en stabil slutpunkt och integrera den i ditt program. Anvisningar finns i Publicera och dela agenter i Microsoft Foundry.
  8. Övervaka och iterera: Övervaka prestanda och kvalitet i produktion och uppdatera och publicera om efter behov. Vägledning finns i Övervaka kvalitet och säkerhet.

Agenttyper i Microsoft Foundry

Det finns tre typer av agenter:

  • Prompt-baserad: En promptbaserad agent är en deklarativt definierad enskild agent som kombinerar modellkonfiguration, instruktioner, verktyg och frågor om naturligt språk för att driva beteende. Utöka det genom att koppla verktyg för kunskap och minne. Redigera, versionera, testa, utvärdera, övervaka och publicera promptbaserade agenter från Agents Playground i Foundry-portalen.

  • Arbetsflöde: Använd arbetsflöden för att skapa ett mer avancerat arbetsflöde som samordnar en sekvens med åtgärder eller samordnar flera agenter. Arbetsflöden har ett eget gränssnitt i portalen, men samma livscykel gäller. Mer information finns i Skapa ett arbetsflöde i Microsoft Foundry.

  • Värdbaserad (förhandsversion): Värdbaserade agenter är containerbaserade agenter som du skapar i kod med hjälp av ramverk som stöds eller anpassad kod. Foundry Agent Service distribuerar och hanterar dessa agenter. Du redigerar inte värdbaserade agenter i agentskapande användargränssnittet, men du kan fortfarande anropa, utvärdera, övervaka och publicera dem. Mer information finns i Vad är värdbaserade agenter?

Skapa promptbaserade agenter och arbetsflöden i Foundry-portalen eller din egen utvecklingsmiljö med hjälp av CLI, SDK eller REST API. Mer information finns i snabbstarten.

Skapa en promptbaserad agent

Om du redan vet vilken typ av agent du vill skapa, namnge den och börja sedan konfigurera dess modellinstruktioner och verktyg.

Anmärkning

Efter att du har döpt din agent kan du inte ändra namnet. I kod refererar du till din agent med <agent_name>:<version>.

Utveckla programvaruagenter i kod

Om du föredrar att arbeta med kod kan du använda metoder som stöds för att föra in din agentkod i en utvecklingsmiljö som du kan testa lokalt och sedan distribuera till Azure.

Från fliken Kod i chattfönstret för agenten playground kan du ta ett kodfragment som refererar till din agent till en dedikerad Visual Studio Code för webbmolnmiljön. Kodfragmentet är förkonfigurerat med de paket och tillägg som du behöver, tillsammans med instruktioner för att effektivt utveckla och distribuera Foundry-agenten till Azure. Du kan också kopiera kodfragmentet direkt till önskad utvecklingsmiljö. Mer information finns i dokumentationen om lekplatsen.

Kärnfunktioner för agentutvecklingslivscykeln

Agentens byggupplevelse erbjuder integrerade upplevelser för varje kärnsteg i agentutvecklingslivscykeln. Använd dessa kärnfunktioner när du utvecklar ditt produktionsklara agentprogram. Varje funktion har djupgående dokumentation där du kan lära dig mer.

Spara ändringar som versioner

När du har skapat den första versionen av en promptbaserad agent eller ett arbetsflöde sparar du efterföljande ändringar som nya versioner. Du kan testa ändringar som inte har sparats i agentens lekplats. Men om du vill visa konversationshistorik, övervaka agentens prestanda eller köra fullständiga utvärderingar måste du spara ändringarna.

Agentversionshantering innehåller följande funktioner för att hantera agentkonfigurationer och iterationer. Det här systemet säkerställer att alla ändringar spåras, kan testas och jämföras mellan olika versioner.

  • Oföränderlighet för version: Varje version av en agent är oföränderlig när du har sparat den. Ändringar av en befintlig version kräver att du sparar och skapar en ny version. Det här kravet hjälper till att säkerställa versionsintegritet och förhindrar oavsiktliga överskrivningar.

  • Utkast till tillståndshantering: Du kan testa agenter i ett tillstånd som inte har sparats för experimentering. Du förlorar ändringar som inte har sparats om du lämnar Foundry-portalen, så spara ofta för att bevara viktiga ändringar.

  • Versionskontrollåtgärder: Du kan dirigera begäranden till specifika agentversioner för att aktivera kontrollerade distributions- och återställningsfunktioner.

  • Navigering i versionshistorik: Få åtkomst till versionshistoriken för alla agenter, gå till valfri specifik version och utför följande jämförelser:

    Jämförelsetyp Description
    Agentkonfiguration Jämför konfigurationsinställningar mellan versioner med hjälp av versionsrullgardinsmenyn
    Chattutdata Analysera svarsskillnader mellan agentversioner med identiska indata
    YAML-definition Granska skillnader i agentdefinitioner

Lägga till verktyg

Gör din agent mer kraftfull genom att ge den kunskap (specifika filer eller index) eller genom att låta den vidta åtgärder (anropa externa API:er). Verktyg är tillgängliga för de flesta av användningsfallen, från enkla filuppladdningar till MCP-serveranslutningar (Model Context Protocol). För mer komplicerade verktyg kan du behöva konfigurera autentisering eller lägga till anslutningar som en del av att koppla dem till en agent.

Om du vill spara en agent med ett bifogat verktyg måste du konfigurera verktyget. Återanvänd konfigurerade verktyg mellan agenter. Information om tillgängliga verktyg finns i verktygskatalogen.

Felsöka och verifiera med hjälp av spårning (förhandsversion)

När du lägger till verktyg och itererar vid frågor använder du spårning för att verifiera beteende från slutpunkt till slutpunkt:

  • Kontrollera om agenten anropade de verktyg som du förväntade dig.
  • Granska verktygsindata och utdata.
  • Identifiera latensproblem vid modell- och verktygsanrop.

Mer information finns i Översikt över agentspårning.

Utvärdera kvalitet och säkerhet (förhandsversion)

Innan du publicerar din agent (och efter någon meningsfull ändring) kör du utvärderingar för att fånga upp regressioner och mäta kvaliteten konsekvent mellan olika versioner.

Övervaka efter publicering

När du har publicerat ett agentprogram behandlar du det som produktionsprogramvara:

  • Övervaka kvalitets- och säkerhetssignaler.
  • Granska spårningar när beteendet ändras.
  • Uppdatera och publicera om när du åtgärdar problem eller gör förbättringar.

Vägledning finns i Övervaka kvalitet och säkerhet.

Planera för identitet och behörigheter

Verktyg och underordnade resurser kräver ofta autentisering. När du publicerar en agent kan dess identitets- och behörighetsmodell ändras. Kontrollera att den publicerade agenten bara har den åtkomst den behöver.

Mer information finns i Agentidentitetsbegrepp i Microsoft Foundry.

Säkerhet och åtkomst

Behandla agentkonfigurationen som programkod. Skydda hemligheter och behörigheter under hela livscykeln:

Publicera din agent eller ditt arbetsflöde

När du har skapat en agent- eller arbetsflödesversion som du är nöjd med publicerar du den som ett agentprogram. Du får en stabil slutpunkt som du kan öppna och testa i webbläsaren, dela med andra eller bädda in i dina befintliga program. Du och dina medarbetare kan verifiera prestanda och identifiera vad som behöver förfinas. Gör nödvändiga uppdateringar och publicera om en ny version när som helst.

Viktigt!

Behörigheter som tilldelats projektidentiteten överförs inte automatiskt till den publicerade agenten. Efter publicering, tilldela de nödvändiga behörigheterna till agentprogrammets identitet på nytt.

Vanliga fallgropar för agentutveckling

  • Ändringar som inte sparats är tillfälliga: Om du vill jämföra versioner, visa historik eller köra fullständiga utvärderingar sparar du ändringarna som en version.
  • Verktyg måste konfigureras innan du sparar: Om ett verktyg kräver autentisering eller en anslutning slutför du installationen innan du sparar.
  • Publicering kan kräva behörighetsuppdateringar: Efter publiceringen kan du kontrollera resursåtkomsten för den publicerade agentidentiteten igen och ta bort all åtkomst som agenten inte längre behöver.

Relaterat innehåll

Läs mer om agenttyper:

Konfigurera och utöka agenter:

Publicera och övervaka agenter:

Felsöka och utvärdera:

  • Last updated on