Sdílet prostřednictvím

Práce s agenty Foundry a nástroji serveru MCP 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.

V tomto článku přidáte a použijete nástroje serveru MCP (Model Context Protocol) s agenty ve službě Foundry Agent Service. Rozšíření Microsoft Foundry pro Visual Studio Code slouží ke konfiguraci a testování agentů pro volání nástrojů MCP.

Poznámka:

Tento článek se týká klasické verze rozhraní API agentů.

Po sestavení agenta ve službě agenta pomocí rozšíření Visual Studio Code (VS Code) můžete do svého agenta přidat nástroje MCP. Přidání serveru MCP umožňuje vašemu agentu:

  • Přistupujte k aktuálním informacím z vašich API a služeb.
  • Načtěte relevantní kontext, abyste zlepšili kvalitu odpovědí z modelů AI.

Předpoklady

Vytvořte agenta v návrháři

Pokud chcete vytvořit agenta, postupujte podle kroků v tématu Vytvoření agenta v návrháři.

Přidání nástroje serveru MCP do agenta

Po vytvoření agenta do něj můžete přidat nástroje, včetně nástrojů MCP. Další informace o dostupných nástrojích najdete v tématu Nástroje pro agenty.

Několik vzdálených serverů MCP můžete přinést tak, že je přidáte jako nástroje. Pro každý nástroj musíte zadat jedinečnou hodnotu popisku serveru ve stejném agentu a hodnotu adresy URL serveru , která odkazuje na vzdálený server MCP.

Výstraha

Vzdálené servery MCP, které používáte s nástrojem MCP v tomto článku, nejsou od Microsoftu. Microsoft tyto servery neotestuje ani neověřuje. Podrobnosti najdete v tématu Důležité informace o používání služeb a serverů jiných společností než Microsoft.

Pokud chcete do agenta přidat nástroj serveru MCP, postupujte takto:

  1. V návrhovém prostředí vyberte v pravém horním rohu oddílu TOOL tlačítko Přidat nástroj. V rozevíracím seznamu vyberte nástroj MCP Server .

  2. Vyhledejte vzdálený server MCP, ke kterému se chcete připojit, například k serveru MCP GitHubu. Pomocí následujících informací vytvořte nebo aktualizujte agenta Foundry pomocí nástroje MCP:

    1. Adresa URL serveru: Adresa URL serveru MCP; například https://gitmcp.io/Azure/azure-rest-api-specs.

    2. Popisek serveru: Jedinečný identifikátor tohoto serveru MCP pro agenta; například fetch_rest_api_docs.

  3. V rozevíracím seznamu Povolené nástroje zvolte nástroje, které může server MCP používat.

  4. Po zadání požadovaných informací vyberte tlačítko Vytvořit nástroj . Nástroj MCP se zobrazí v sekci TOOL návrháře agenta.

Nasazení agenta do Foundry

Po přidání nástroje MCP nasaďte agenta do Foundry, aby byl k dispozici pro testování a použití.

  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ů

Po nasazení agenta můžete zkontrolovat jeho konfiguraci a pracovat s ním. Výběrem nasazeného agenta v zobrazení Prostředky otevřete podokno PŘEDVOLBY AGENTa v režimu jen pro zobrazení. Můžete:

  • Výběrem tlačítka Upravit agenta zobrazíte návrháře agenta a definici .yaml agenta pro úpravy.
  • Výběrem tlačítka Zobrazit kód vytvořte ukázkový soubor kódu, který používá agenta.
  • Výběrem tlačítka Otevřít dětské hřiště otevřete dětské hřiště agenta.

Úprava nasazeného agenta

Pokud chcete po nasazení upravit konfiguraci agenta, postupujte takto:

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

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

  3. Po dokončení úprav uložte změny výběrem tlačítka Update Agent na webu Microsoft Foundry . Aktualizovaná konfigurace se nasadí do Foundry.

Testování agenta pomocí nástrojů MCP na dětském hřišti

Pomocí testovacího prostředí agenta ověřte, že nástroje serveru MCP správně fungují s nasazeným agentem.

  1. Klikněte pravým tlačítkem na nasazeného agenta s nástrojem MCP Server a vyberte možnost Open Playground . Tato akce spustí vlákno s vaším agentem, abyste mohli odesílat zprávy.

  2. V podokně Vzdálený agent Playground zadejte výzvu, například Dejte mi příklad vytvoření kontejnerové aplikace, a poté ji odešlete.

  3. Vyberte metodu ověřování pro nástroj serveru MCP a pokračujte. Metody ověřování se liší v závislosti na serveru MCP. Mezi běžné možnosti patří klíč rozhraní API, OAuth nebo žádné ověřování pro veřejné servery.

  4. Vyberte předvolbu schválení pro nástroj serveru MCP a pokračujte. Můžete zvolit možnost Zeptat se pokaždé , když chcete zkontrolovat každé volání nástroje, nebo vždy povolit , aby agent automaticky volal nástroje MCP.

  5. Pokud jste pro předvolbu schválení zvolili možnost Zeptat se pokaždé , musíte před tím, než bude agent pokračovat, schválit nebo odmítnout každé volání nástroje.

  6. Agent používá model a serverové nástroje MCP, které jste nakonfigurovali k načtení informací. Po dokončení zpracování agenta se odpověď zobrazí v dětském hřišti. Zdroj informací se zobrazí v části pro poznámky agenta.

Řešení potíží s připojeními k serveru MCP

Pokud při používání nástrojů serveru MCP s vaším agentem narazíte na problémy, vyzkoušejte následující řešení.

Problém Řešení
Adresa URL serveru MCP je nedostupná Ověřte, že je adresa URL správná a jestli je server spuštěný. Zkontrolujte síťové připojení a všechna pravidla brány firewall, která mohou blokovat odchozí požadavky z VS Code.
Chyby ověřování Ověřte, že jste pro server MCP vybrali správnou metodu ověřování. Pokud server vyžaduje klíč rozhraní API nebo token OAuth, ověřte, zda jsou přihlašovací údaje platné a zda jim nevypršela platnost.
Nástroje se nezobrazují v seznamu povolených nástrojů Seznam nástrojů aktualizujte zavřením a opětovným otevřením dialogového okna nástroje MCP. Ověřte, že server MCP správně zveřejňuje své nástroje prostřednictvím standardního protokolu MCP.
Agent vrací chyby při vyvolání nástroje MCP. Podrobnosti o chybách najdete v poznámkách agenta na dětském hřišti. Server MCP může vracet chybovou odpověď. Ověřte, že je server v pořádku a zda jsou parametry volání nástroje správné.

Vyčistěte zdroje

Prostředky Azure, které jste vytvořili v tomto článku, se účtují vašemu předplatnému Azure. Pokud v budoucnu tyto prostředky nepotřebujete, odstraňte je, abyste se vyhnuli účtování dalších poplatků.

Odstranění agentů

Odebrání agentů, které už nepotřebujete:

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

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

Odstraňte své modely

Odebrání nasazených modelů, které už nepotřebujete:

  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 nasazený model, který chcete odstranit, a pak vyberte Odstranit.

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

Pokud chcete odebrat připojené prostředky nástrojů, které už nepotřebujete, odstraňte je jednotlivě na webu Azure Portal:

  1. Otevřete Azure Portal.

  2. Přejděte do skupiny prostředků, která obsahuje váš projekt Foundry.

  3. Najděte konkrétní zdroj nástroje, který chcete odstranit, a vyberte jej.

  4. Vyberte tlačítko Odstranit a potvrďte odstranění.

Výstraha

Neodstraňujte celou skupinu prostředků, pokud nechcete odebrat všechny prostředky v ní. Odstraněním skupiny prostředků odeberete všechny prostředky, které obsahuje, včetně projektu Foundry a nasazených modelů.

Související obsah

  • Last updated on