Skapa och hantera klassiska Foundry-agenter i Visual Studio Code (förhandsversion) (klassisk)

Anmärkning

Det här dokumentet refererar till Microsoft Foundry-portalen (klassisk).

🔍 Visa dokumentationen för Microsoft Foundry (ny) för att lära dig mer om den nya portalen.

Anmärkning

Det här dokumentet refererar till den klassiska versionen av agent-API:et.

Med Foundry Agent Service kan du skapa, konfigurera och distribuera agenter utan att lämna Visual Studio Code (VS Code). I den här artikeln skapar du en agent med hjälp av designern, lägger till verktyg, testar agenten på lekplatsen, genererar exempelkod och rensar resurser när du är klar.

Viktigt!

Objekt markerade (förhandsversion) i den här artikeln är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

Förutsättningar

• Ett Azure-abonnemang. Skapa en kostnadsfritt.
• Åtkomst till Foundry Agent Service.
• Visual Studio Code installerat.
• Microsoft Foundry for VS Code-tillägget har installerats och loggats in.
• En distribuerad modell i projektet.

Skapa en agent i designern

Designern tillhandahåller ett visuellt gränssnitt för att konfigurera agentens namn, modell, instruktioner och verktyg.

1. Logga in på dina Azure-resurser.

2. Ange ditt standardprojekt.

3. I vyn för Foundry Extension hittar du Classic-underavsnittet i sektionen Resurser.

4. Välj plusikonen (+) bredvid underavsnittet Klassiska agenter för att skapa en ny agent.

Konfigurera agenten i designern

När du har valt en plats för att spara öppnas agentens .yaml-fil och designervyn. Konfigurera följande inställningar:

1. I prompten anger du ett namn på din agent.

2. I rullgardinsmenyn väljer du namnet på din modellimplementering. Distributionsnamnet är det du valde när du distribuerade en befintlig modell.

3. Tillägget genererar ID-värdet . Konfigurera följande fält:

   • Lägg till en beskrivning för din agent.
   • Ange systeminstruktioner.
   • Konfigurera verktyg för agentanvändning.

4. Om du vill spara .yaml-filen väljer du Spara fil> på menyraden VS Code.

Granska agentens YAML-definition

.yaml-filen öppnas tillsammans med designern och innehåller konfigurationsinformation för din agent. Formatet liknar följande exempel:

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: my-agent
description: Description of the agent
id: ''
metadata:
  authors:
    - author1
    - author2
  tags:
    - tag1
    - tag2
model:
  id: 'gpt-4o-1'
  options:
    temperature: 1
    top_p: 1
instructions: Instructions for the agent
tools: []

Lägga till verktyg i agenten

Agenttjänsten tillhandahåller följande verktyg för att utöka agentens funktioner och ansluta till dina datakällor:

• Grundstötning med Bing-sökning
• Filsökning
• Kodtolkare
• OpenAPI-angivna verktyg
• McP (Model Context Protocol)

Mer information om hur du använder MCP-verktyg finns i Arbeta med agenttjänsten och MCP-serververktyg i Visual Studio Code (förhandsversion).

Lägga till ett verktyg i agenten

1. I designern går du till det övre högra hörnet i avsnittet VERKTYG och väljer Lägg till verktyg. I listrutan väljer du det verktyg som du vill lägga till.

   

2. Designern visar rätt fönster för att konfigurera verktyget, enligt följande bilder:

   • Grunder i Bing-sökning:

     

   • Filsökning:

     

   • Kodtolkare:

     

   • OpenAPI 3.0-angivna verktyg:

     

3. När du har angett nödvändig information väljer du Skapa och anslut, Ladda upp och spara eller Skapa verktyg. Knappetiketten varierar beroende på verktygstyp.

   När verktyget har skapats visas det i avsnittet VERKTYG i designern.

När du lägger till ett verktyg kan du också lägga till alla nya tillgångar som behövs. Om du till exempel lägger till ett filsökningsverktyg kan du använda en befintlig vektorlagringstillgång eller skapa en ny som värd för dina uppladdade filer.

Distribuera agenten till Foundry

När du har konfigurerat agenten distribuerar du den till Foundry så att den körs i molnet.

1. I designern väljer du knappen Skapa agent på Microsoft Foundry .

2. Uppdatera vyn Resurser i VS Code. Den distribuerade agenten visas i underavsnittet Klassiska agenter.

Visa information om distribuerad agent

Välj en distribuerad agent för att öppna fönstret AGENTINSTÄLLNINGAR i visningsläge. I det här fönstret kan du:

• Välj Redigera agent för att öppna agentdesignern och .yaml-definitionen för redigering.
• Välj Visa kod för att generera en exempelkodfil som använder agenten.
• Välj Öppna Lekplats för att öppna fjärragentens lekplats.

Uppdatera en distribuerad agent

Du kan ändra konfigurationen för en distribuerad agent och synkronisera ändringarna tillbaka till Foundry.

1. I fönstret AGENTINSTÄLLNINGAR väljer du Redigera agent. Agentdesignern öppnas med agentens .yaml-fil.

2. Redigera agentens konfiguration, till exempel modell, verktyg och instruktioner.

3. Välj knappen Uppdatera agent på Microsoft Foundry för att spara ändringarna. Den uppdaterade konfigurationen börjar gälla omedelbart.

Generera en exempelkodfil

Tillägget genererar exempelkod för interaktion med din distribuerade agent programmatiskt.

1. Högerklicka på din distribuerade agent och välj sedan Visa kod. Eller i fönstret AGENTINSTÄLLNINGAR väljer du knappen Visa kod .

2. I listrutan Välj önskad SDK väljer du ditt SDK.

3. I listrutan Välj ett språk väljer du ditt språk.

4. I listrutan Välj en autentiseringsmetod väljer du din autentiseringsmetod.

Tillägget genererar en kodfil på det valda språket och öppnar den i redigeraren.

Granska exempelkodfilen

Den genererade kodfilen visar ett grundläggande anrop för att interagera med agenten via Foundry Projects API. Följande skärmbild visar ett Python-exempel:

Testa agenten på lekplatsen

Använd lekplatsen för att skicka meddelanden till din distribuerade agent och verifiera dess beteende.

1. Högerklicka på din distribuerade agent och välj sedan Öppna lekplats.

   Du kan också välja länken Remote Agent Playground i underavsnittet Verktyg , välja din agenttyp och sedan välja din agent i listrutorna.

   Fönstret Remote Agent Playground öppnas och startar en tråd med din agent.

2. Ange din fråga och visa utdata.

   I det här exemplet används Bing Grounding för att illustrera en webbsökning efter information. Agenten använder den modell och de verktyg som du konfigurerade i agentdesignern. Källan till informationen visas i avsnittet för agentanteckningar.

   

Visa agenttrådar

Underavsnittet Trådar visar konversationstrådarna som skapats under körningar med din agent. I det klassiska avsnittet under vyn Resurser expanderar du underavsnittet Trådar för att visa listan.

Anmärkning

En tråd är en konversationssession mellan en agent och en användare. Trådar lagrar meddelanden och hanterar automatiskt trunkering för att passa in innehåll i en modells kontext. Ett meddelande är en enda interaktion som kan innehålla text, bilder och andra filer. En körning är en enda exekvering av en agent som kan sträcka sig över flera trådar och meddelanden.

Visa trådinformation

Om du vill visa fönstret TRÅDINFORMATION väljer du en tråd i listan.

Visa körningsinformation

Om du vill visa körningsinformation väljer du knappen Visa körningsinformation i fönstret TRÅDINFORMATION . En .json fil öppnas med information om körningen, inklusive agentkonfiguration, meddelanden och verktygsanrop.

Rensa resurser

Om du inte behöver de resurser som du har skapat tar du bort dem för att undvika löpande avgifter för din Azure-prenumeration.

Ta bort dina agenter

Tips/Råd

Eftersom du kan anpassa det vänstra fönstret i Microsoft Foundry-portalen kan du se andra objekt än vad som visas i de här stegen. Om du inte ser det du letar efter väljer du ... Mer längst ned i det vänstra fönstret.

1. Uppdatera vyn Azure-resurser i VS Code.
2. Expandera underavsnittet Agenter för att visa listan över distribuerade agenter.
3. Högerklicka på agenten som du vill ta bort och välj sedan Ta bort.

Ta bort dina modeller

1. Uppdatera vyn Resurser i VS Code. Expandera underavsnittet Modeller för att visa listan över distribuerade modeller.

2. Högerklicka på den modell som du vill ta bort och välj sedan Ta bort.

Ta bort dina anslutna verktyg

1. Öppna Azure-portalen.

2. Gå till den resursgrupp som innehåller verktygsresursen.

3. Välj resursen och välj sedan Ta bort.

Relaterat innehåll

• Arbeta med Agent Service- och MCP-serververktyg i Visual Studio Code (förhandsversion) för att lägga till MCP-verktyg i dina agenter.
• Översikt över agentverktyg för information om filsökning, kodtolkare och andra tillgängliga verktyg.
• Översikt över Foundry Agent Service för en djupare titt på agentbegrepp och -funktioner.