Vytváření a správa agentů Foundry v editoru Visual Studio Code (classic)

Platí jenom pro:Portál Foundry (Classic). Tento článek není k dispozici pro nový portál Foundry. Přečtěte si další informace o novém portálu.

Poznámka:

Některé odkazy v tomto článku můžou otevřít obsah v nové dokumentaci Microsoft Foundry místo dokumentace Foundry (klasické), kterou si právě prohlížíte.

Poznámka:

Tento dokument se týká klasické verze rozhraní API agentů.

Foundry Agent Service umožňuje vytvářet, konfigurovat a nasazovat agenty bez opuštění Visual Studio Code (VS Code). V tomto článku vytvoříte agenta pomocí návrháře, přidáte nástroje, otestujete agenta v dětském prostředí, vygenerujete vzorový kód a po dokončení vyčistíte prostředky.

Předpoklady

• Předplatné Azure. Kreate si ho zdarma.
• Přístup k Foundry Agent Service.
• Visual Studio Code nainstalovaný.
• Pro rozšíření Microsoft Foundry pro VS Code je instalace a přihlášení dokončeno.
• Nasazený model ve vašem projektu.

Vytvořte agenta v návrháři

Návrhář poskytuje vizuální rozhraní pro konfiguraci názvu, modelu, pokynů a nástrojů vašeho agenta.

1. Přihlaste se ke svým prostředkům Azure.

2. Nastavte výchozí project.

3. V zobrazení rozšíření Foundry najděte sekci Zdroje a v ní pododdíl Classic.

4. Výběrem ikony plus (+) vedle pododdílu Classic Agents vytvořte nového agenta.

Konfigurace agenta v návrháři

Po výběru umístění pro uložení se otevře soubor .yaml agenta a zobrazení návrháře. Nakonfigurujte následující nastavení:

1. Do příkazového řádku zadejte název vašeho agenta.

2. V rozevíracím seznamu vyberte název nasazení modelu. Název nasazení je to, co jste zvolili při nasazení existujícího modelu.

3. Rozšíření vygeneruje hodnotu ID . Nakonfigurujte následující pole:

   • Přidejte popis svého agenta.
   • Nastavte systémové pokyny.
   • Nakonfigurujte nástroje pro použití agenta.

4. Soubor .yaml uložíte tak, že v menu VS Code vyberete Soubor>Uložit.

Kontrola definice YAML agenta

Soubor .yaml se otevře společně s návrhářem a obsahuje podrobnosti o konfiguraci vašeho agenta. Formát je podobný následujícímu příkladu:

# 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: []

Přidejte nástroje do agenta

Služba agenta poskytuje následující nástroje pro rozšíření možností vašeho agenta a připojení ke zdrojům dat:

• Uzemnění pomocí vyhledávání Bingem
• Hledání souborů
• Interpret kódu
• Zadané nástroje OpenAPI
• Protokol modelového kontextu (MCP)

Další informace o používání nástrojů MCP najdete v tématu Work with Agent Service and MCP server tools in Visual Studio Code (Preview).

Přidejte nástroj do agenta

1. V návrháři vyberte v pravém horním rohu sekce TOOL možnost Přidat nástroj. V rozevíracím seznamu vyberte nástroj, který chcete přidat.

   

2. Návrhář zobrazí příslušné podokno pro konfiguraci nástroje, jak je znázorněno na následujících obrázcích:

   • Založení pomocí vyhledávání Bing

     

   • Hledání souborů:

     

   • Interpret kódu:

     

   • Zadané nástroje OpenAPI 3.0:

     

3. Po zadání požadovaných informací vyberte Vytvořit a připojit, Nahrát a uložit nebo Vytvořit nástroj. Popisek tlačítka se liší podle typu nástroje.

   Po vytvoření se nástroj zobrazí v části TOOL návrháře.

Když přidáte nástroj, můžete také přidat jakékoli nové prostředky, které potřebuje. Pokud například přidáte nástroj pro vyhledávání souborů, můžete použít existující asset úložiště vektorů nebo vytvořit nový k hostování nahraných souborů.

Nasazení agenta do Foundry

Jakmile dokončíte konfiguraci agenta, nasaďte ho do Foundry, aby běžel v cloudu.

1. V návrháři vyberte tlačítko Vytvořit agenta v Microsoft Foundry .

2. Ve VS Code aktualizujte zobrazení Prostředky . Nasazený agent se zobrazí v pododdílu Agenti Classic .

Zobrazení podrobností nasazených agentů

Výběrem nasazeného agenta otevřete podokno PŘEDVOLBY AGENTa v režimu jen pro zobrazení. Z tohoto podokna můžete:

• Výběrem Upravit agenta otevřete návrháře agenta a definici .yaml pro editaci.
• Výběrem možnosti Zobrazit kód vygenerujete ukázkový soubor kódu, který používá agenta.
• Výběrem Otevřít testovací prostředí otevřete vzdálené testovací prostředí agenta.

Aktualizace nasazeného agenta

Můžete upravit konfiguraci nasazeného agenta a synchronizovat změny zpět do Foundry.

1. V podokně PŘEDVOLBY AGENTa vyberte Upravit agenta. Otevře se návrhář agenta se souborem .yaml agenta.

2. Upravte konfiguraci agenta, například model, nástroje a pokyny.

3. Výběrem tlačítka Aktualizovat agenta na webu Microsoft Foundry uložte provedené změny. Aktualizovaná konfigurace se projeví okamžitě.

Vygenerování ukázkového souboru kódu

Rozšíření generuje šablonový kód pro programatickou interakci s nasazeným agentem.

1. Klikněte pravým tlačítkem na nasazeného agenta a vyberte Zobrazit kód. Nebo v podokně PŘEDVOLBY AGENTa vyberte tlačítko Zobrazit kód .

2. V rozevíracím seznamu Zvolit upřednostňovanou sadu SDK vyberte svou sadu SDK.

3. V rozevíracím seznamu Zvolit jazyk vyberte jazyk.

4. V rozevíracím seznamu Zvolit metodu ověřování vyberte metodu ověřování.

Přípona vygeneruje soubor kódu ve vybraném jazyce a otevře ho v editoru.

Kontrola ukázkového souboru kódu

Vygenerovaný soubor kódu ukazuje základní volání pro interakci s agentem prostřednictvím rozhraní API Foundry Projects. Následující snímek obrazovky ukazuje příklad Pythonu:

Otestujte agenta v testovacím prostředí

Pomocí dětského hřiště můžete odesílat zprávy nasazeným agentům a ověřovat jeho chování.

1. Klikněte pravým tlačítkem na nasazeného agenta a pak vyberte Open Playground.

   Případně vyberte odkaz Remote Agent Playground v pododdílu Nástroje , vyberte typ agenta a pak v rozevíracích seznamech vyberte svého agenta.

   Otevře se podokno Remote Agent Playground a spustí vlákno s vaším agentem.

2. Zadejte výzvu a zobrazte výstupy.

   Tento příklad používá Bing Grounding k ilustraci vyhledávání informací na webu. Agent používá model a nástroje, které jste nakonfigurovali v návrháři agentů. Zdroj informací se zobrazí v části pro poznámky agenta.

   Screenshot zobrazující podokno Agent Playground s odpovědí Bing Uzemnění a poznámkami agenta, které zvýrazňují zdroj.

Zobrazení vláken agenta

Pododdíl Vlákna zobrazí vlákna konverzace vytvořená během spuštění vašeho agenta. V Klasické části v zobrazení Prostředky rozbalte pododdíl Vlákna pro zobrazení seznamu.

Poznámka:

Vlákno představuje relaci konverzace mezi agentem a uživatelem. Vlákna ukládají zprávy a automaticky upravují zkrácení, aby se vešla do kontextu modelu. Zpráva je jedna interakce, která může obsahovat text, obrázky a další soubory. Spuštění je jediné spuštění agenta, který může zahrnovat více vláken a zpráv.

Zobrazení podrobností o vlákně

Pokud chcete zobrazit podokno PODROBNOSTI VLÁKNA , vyberte ze seznamu vlákno.

Zobrazit podrobnosti běhu

Pokud chcete zobrazit informace o spuštění, vyberte tlačítko Zobrazit informace o spuštění v podokně PODROBNOSTI VLÁKNA . Otevře se soubor .json s podrobnostmi o spuštění, včetně konfigurace agenta, zpráv a volání nástrojů.

Vyčistěte zdroje

Pokud prostředky, které jste vytvořili, nepotřebujete, odstraňte je, abyste se vyhnuli průběžným poplatkům za vaše předplatné Azure.

Odstranění agentů

Návod

Vzhledem k tomu, že levé podokno můžete přizpůsobit na portálu Microsoft Foundry, může se zobrazit jiné položky, než je znázorněno v tomto postupu. Pokud nevidíte, co hledáte, vyberte v dolní části levého podokna možnost ... Další.

1. Ve VS Code aktualizujte zobrazení Azure Resources.
2. Rozbalte pododdíl Agenti a zobrazte seznam nasazených agentů.
3. Klikněte pravým tlačítkem myši na agenta, kterého chcete odstranit, a pak vyberte Odstranit.

Odstraňte své modely

1. Ve VS Code aktualizujte zobrazení Prostředky . Rozbalte pododdíl Modely a zobrazte seznam nasazených modelů.

2. Klikněte pravým tlačítkem myši na model, který chcete odstranit, a pak vyberte Odstranit.

Odstranění připojených nástrojů

1. Otevřete Azure portal.

2. Přejděte do skupiny prostředků, která obsahuje nástrojový prostředek.

3. Vyberte prostředek a pak vyberte Odstranit.

Související obsah

• Pracujte se službou Agent a nástroji MCP serveru ve Visual Studio Code (verze preview) a přidejte MCP nástroje ke svým agentům.
• Přehled nástrojů agenta pro vyhledávání souborů, interpret kódu a další dostupné nástroje
• Přehled služby Foundry Agent Service pro hlubší přehled konceptů a možností agentů