Udostępnij przez

Praca z agentami Foundry Classic i narzędziami serwera MCP w programie Visual Studio Code (wersja klasyczna) (wersja zapoznawcza)

Uwaga / Notatka

Ten dokument odnosi się do portalu Microsoft Foundry (klasycznego).

🔍 Zapoznaj się z dokumentacją rozwiązania Microsoft Foundry (nową), aby dowiedzieć się więcej o nowym portalu.

W tym artykule dodasz i użyjesz narzędzi serwera protokołu Model Context Protocol (MCP) z agentami w usłudze Agent Foundry. Do konfigurowania i testowania agentów wywołujących narzędzia MCP używasz rozszerzenia Microsoft Foundry for Visual Studio Code .

Uwaga / Notatka

Ten artykuł dotyczy klasycznej wersji interfejsu API agentów.

Po utworzeniu agenta w usłudze agenta przy użyciu rozszerzenia programu Visual Studio Code (VS Code) możesz dodać narzędzia MCP do agenta. Dodanie serwera MCP umożliwia agentowi:

  • Uzyskaj dostęp do najnowszych informacji z interfejsów API i usług.
  • Pobierz odpowiedni kontekst, aby zwiększyć jakość odpowiedzi z modeli sztucznej inteligencji.

Ważna

Elementy oznaczone jako (wersja zapoznawcza) w tym artykule są aktualnie dostępne w publicznej wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie zalecamy korzystania z niej w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.

Wymagania wstępne

Utwórz agenta w projektancie

Aby utworzyć agenta, wykonaj kroki opisane w temacie Tworzenie agenta w projektancie.

Dodawanie narzędzia serwera MCP do agenta

Po utworzeniu agenta możesz dodać do niego narzędzia, w tym narzędzia MCP. Aby uzyskać więcej informacji na temat dostępnych narzędzi, zobacz Narzędzia dla agentów.

Możesz przenieść wiele zdalnych serwerów MCP, dodając je jako narzędzia. Dla każdego narzędzia należy podać unikatową wartość Etykieta serwera w ramach tego samego agenta i wartość adresu URL serwera , która wskazuje zdalny serwer MCP.

Ostrzeżenie

Zdalne serwery MCP używane z narzędziem MCP w tym artykule nie pochodzą od firmy Microsoft. Firma Microsoft nie testuje ani nie weryfikuje tych serwerów. Aby uzyskać szczegółowe informacje, zobacz Zagadnienia dotyczące korzystania z usług i serwerów innych niż Microsoft.

Aby dodać narzędzie serwera MCP do agenta, wykonaj następujące kroki:

  1. W projektancie w prawym górnym rogu sekcji TOOL wybierz przycisk Dodaj narzędzie . Z listy rozwijanej wybierz narzędzie MCP Server .

  2. Znajdź zdalny serwer MCP, z którym chcesz nawiązać połączenie, na przykład z serwerem MCP usługi GitHub. Utwórz lub zaktualizuj agenta usługi Foundry za pomocą narzędzia MCP, korzystając z następujących informacji:

    1. Adres URL serwera: adres URL serwera MCP; na przykład https://gitmcp.io/Azure/azure-rest-api-specs.

    2. Etykieta serwera: unikatowy identyfikator tego serwera MCP dla agenta; na przykład fetch_rest_api_docs.

  3. Na liście rozwijanej Dozwolone narzędzia wybierz narzędzia, których może używać serwer MCP.

  4. Po wprowadzeniu wymaganych informacji wybierz przycisk Utwórz narzędzie . Narzędzie MCP zostanie wyświetlone w sekcji TOOL projektanta agenta.

Wdrażenie agenta do Foundry

Po dodaniu narzędzia MCP wdróż agenta w narzędziu Foundry, aby był dostępny do testowania i używania.

  1. W projektancie wybierz przycisk Utwórz agenta w witrynie Microsoft Foundry .

  2. W programie VS Code odśwież widok Zasoby . Wdrożony agent zostanie wyświetlony w podsekcji Agentów klasycznych .

Wyświetlanie szczegółów wdrożonego agenta

Po wdrożeniu agenta można sprawdzić jego konfigurację i wchodzić z nią w interakcje. Wybierz wdrożonego agenta w widoku Zasoby , aby otworzyć okienko PREFERENCJE AGENTa w trybie tylko do wyświetlania. Masz następujące możliwości:

  • Wybierz przycisk Edytuj agenta, aby wyświetlić projektanta agenta oraz definicję .yaml agenta do edycji.
  • Wybierz przycisk Wyświetl kod , aby utworzyć przykładowy plik kodu, który używa agenta.
  • Wybierz przycisk Otwórz plac zabaw , aby otworzyć plac zabaw agenta.

Edytowanie wdrożonego agenta

Aby zmodyfikować konfigurację agenta po wdrożeniu, wykonaj następujące kroki:

  1. W okienku PREFERENCJE AGENTA wybierz przycisk Edytuj agenta . Projektant agenta otwiera się wraz z plikiem .yaml agenta.

  2. Edytuj konfigurację agenta, taką jak model, narzędzia i instrukcje.

  3. Po zakończeniu edytowania wybierz przycisk Update Agent w witrynie Microsoft Foundry , aby zapisać zmiany. Zaktualizowana konfiguracja zostanie wdrożona w usłudze Foundry.

Testowanie agenta za pomocą narzędzi MCP na placu zabaw

Użyj środowiska testowego agenta, aby sprawdzić, czy narzędzia serwera MCP działają prawidłowo z wdrożonym agentem.

  1. Kliknij prawym przyciskiem myszy wdrożonego agenta z narzędziem MCP Server , a następnie wybierz opcję Otwórz plac zabaw . Ta akcja rozpoczyna wątek z agentem, abyś mógł wysyłać wiadomości.

  2. W okienku Plac zabaw agenta zdalnego wprowadź monit, taki jak Nadaj mi przykład tworzenia aplikacji kontenera i wyślij go.

  3. Wybierz metodę uwierzytelniania narzędzia serwera MCP i kontynuuj. Metody uwierzytelniania różnią się w zależności od serwera MCP. Typowe opcje obejmują klucz interfejsu API, protokół OAuth lub brak uwierzytelniania dla serwerów publicznych.

  4. Wybierz preferencję zatwierdzania dla narzędzia serwera MCP i kontynuuj. Możesz wybrać opcję Zapytaj za każdym razem , aby przejrzeć każde wywołanie narzędzia lub zawsze zezwalać na automatyczne wywoływanie narzędzi MCP przez agenta.

  5. Jeśli dla preferencji zatwierdzania wybrano opcję Zapytaj za każdym razem, musisz zatwierdzić lub odrzucić każde wywołanie narzędzia, zanim agent przystąpi do dalszych działań.

  6. Agent używa modelu i narzędzi serwera MCP skonfigurowanych do pobierania informacji. Po zakończeniu przetwarzania przez agenta, odpowiedź pojawi się na placu zabaw. Źródło informacji jest wyświetlane w sekcji adnotacji agenta.

Rozwiązywanie problemów z połączeniami serwera MCP

Jeśli wystąpią problemy podczas korzystania z narzędzi serwera MCP z agentem, spróbuj wykonać poniższe rozwiązania.

Problematyka Rezolucja
Adres URL serwera MCP jest niemożliwy do osiągnięcia Sprawdź, czy adres URL jest poprawny i czy serwer jest uruchomiony. Sprawdź połączenie sieciowe i wszelkie reguły zapory, które mogą blokować żądania wychodzące z programu VS Code.
Błędy uwierzytelniania Upewnij się, że wybrano poprawną metodę uwierzytelniania dla serwera MCP. Jeśli serwer wymaga klucza interfejsu API lub tokenu OAuth, sprawdź, czy poświadczenia są prawidłowe i nie wygasły.
Narzędzia nie są wyświetlane na liście dozwolonych narzędzi Odśwież listę narzędzi, zamykając i ponownie otwierając okno dialogowe narzędzia MCP. Sprawdź, czy serwer MCP prawidłowo uwidacznia swoje narzędzia za pośrednictwem standardowego protokołu MCP.
Agent zwraca błędy podczas wywoływania narzędzia MCP Sprawdź adnotacje agenta na placu zabaw, aby uzyskać szczegółowe informacje o błędzie. Serwer MCP może zwracać odpowiedź o błędzie. Sprawdź, czy serwer jest w dobrej kondycji i czy parametry wywołania narzędzia są poprawne.

Uprzątnij zasoby

Zasoby platformy Azure utworzone w tym artykule są rozliczane z subskrypcją platformy Azure. Jeśli nie spodziewasz się, że te zasoby będą potrzebne w przyszłości, usuń je, aby uniknąć naliczania dodatkowych opłat.

Usuwanie agentów

Aby usunąć agentów, których już nie potrzebujesz:

  1. W programie VS Code odśwież widok Zasoby . Rozwiń podsekcję Agentów klasycznych , aby wyświetlić listę wdrożonych agentów.

  2. Kliknij prawym przyciskiem myszy wdrożonego agenta, który chcesz usunąć, a następnie wybierz polecenie Usuń.

Usuń swoje modele

Aby usunąć wdrożone modele, których już nie potrzebujesz:

  1. W programie VS Code odśwież widok Zasoby . Rozwiń podsekcję Modele , aby wyświetlić listę wdrożonych modeli.

  2. Kliknij prawym przyciskiem myszy wdrożony model, który chcesz usunąć, a następnie wybierz polecenie Usuń.

Usuwanie połączonych narzędzi

Aby usunąć zasoby połączonego narzędzia, które nie są już potrzebne, usuń je indywidualnie w witrynie Azure Portal:

  1. Otwórz portal Azure.

  2. Przejdź do grupy zasobów zawierającej projekt Foundry.

  3. Znajdź konkretny zasób narzędzia, który chcesz usunąć, i wybierz go.

  4. Wybierz przycisk Usuń i potwierdź usunięcie.

Ostrzeżenie

Nie usuwaj całej grupy zasobów, chyba że chcesz usunąć wszystkie zasoby w niej. Usunięcie grupy zasobów powoduje usunięcie wszystkich zawartych w niej zasobów, w tym projektu Foundry i wdrożonych modeli.

Treści powiązane

  • Last updated on