översikt över Microsoft Foundry-agenttillägg

Azure Developer CLI (azd) Microsoft Foundry-agenttillägget skapar stommen för, etablerar och distribuerar agenter till Microsoft Foundry från terminalen eller redigeraren. Den kombinerar Foundry-agentfunktioner med azd livscykelkommandon för ett konsekvent lokalt till moln-arbetsflöde. Du kan gå från en exempelagent till en distribuerad, anropsbar slutpunkt med några få kommandon.

I den här artikeln beskrivs tillägget. Fullständig stegvis vägledning finns i dokumentationen om Microsoft Foundry-värdbaserade agenter.

Viktiga funktioner

Feature Beskrivning
Projektstruktur Konfigurerar kompletta agentprojekt, inklusive infrastruktur som kodmallar, agentdefinitioner och konfiguration, så att du kan börja iterera direkt.
Deklarativ konfiguration Definierar tjänster, resurser och modelldistributioner i en azure.yaml fil för konsekventa miljöer.
Enhetlig etablering och distribution Kör azd up för att bygga containrar, skicka containeravbildningar, skapa resurser, distribuera modeller och publicera agenten i ett steg.
Hantering av agentdefinitioner Importerar agentdefinitioner från kataloger, GitHub eller lokala sökvägar och mappar obligatoriska parametrar till miljövariabler.
Säker som standard Konfigurerar hanterade identiteter och baslinjesäkerhet automatiskt utan att hantera autentiseringsuppgifter manuellt.
Skalbar provisionering av modeller Anger modellnamn, versioner och kapacitet och distribuerar dem konsekvent i olika miljöer.

Utforska arbetsflödet

Tillägget följer en bekant azd livscykel från projektstruktur till en aktiv agent:

  1. Scaffold: Initiera ett exempelagentprojekt, inklusive infrastruktur som kod, en agentdefinition och konfiguration.
  2. Etablera och distribuera: Skapa Foundry-kontot och projektet, distribuera modeller, skapa och push-överföra agentcontainern och publicera agenten.
  3. Kör lokalt: Iterera på agenten på den lokala datorn när du är ansluten till fjärranslutna Azure resurser.
  4. Anropa och övervaka: Skicka frågor till den distribuerade agenten och strömma liveloggar.
  5. Ta bort: Ta bort alla etablerade resurser när du är klar.

Prova det

Prova att distribuera en exempelagent med det lägsta arbetsflödet. I det här exemplet används det grundläggande Agent Framework-exemplet från dokumentationen Microsoft Foundry.

  1. Skapa ett exempelagentprojekt i en tom mapp:

    azd ai agent init -m https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/agent-framework/responses/01-basic/azure.yaml

  2. Etablera resurser och distribuera agenten i ett steg:

    azd up

    Tip

    Du kan också dela upp det här steget i azd provision och azd deploy för mer kontroll över varje steg.

  3. Ta bort alla skapade resurser när du är klar:

    azd down

    Varning

    azd down tar bort alla resurser i resursgruppen permanent. Använd den med försiktighet i delade miljöer eller produktionsmiljöer.

Krav, modellval, lokal testning och felsökning finns i Snabbstart: Distribuera din första värdbaserade agent.

När agenttillägget ska användas

Microsoft Foundry stöder flera sätt att skapa och distribuera värdbaserade agenter, inklusive Python SDK, Visual Studio Code och portalen. Agenttillägget azd passar bäst när du vill:

  • Arbeta främst från terminalen eller redigeraren med ett skriptbart, repeterbart arbetsflöde.
  • Hantera infrastruktur och agenter tillsammans med hjälp av deklarativa azure.yaml och Bicep filer under källkontroll.
  • Flytta konsekvent från lokalt till molnet med samma azd livscykelkommandon (azd init, azd up, azd down) som du redan använder för andra Azure appar.
  • Standardisera distributioner mellan miljöer (utveckling, testning och produktion) och automatisera dem i CI/CD.

För en guidad portalupplevelse eller för att skapa agenter med Python SDK börjar du med dokumentationen om Microsoft Foundry-värdbaserade agenter i stället.

Ytterligare resurser

  • Last updated on