Praca z agentami usługi Foundry i narzędziami serwera MCP w Visual Studio Code (wersja klasyczna)

Dotyczy tylko:Portal Foundry (klasyczny). Ten artykuł nie jest dostępny w nowym portalu Foundry. Dowiedz się więcej o nowym portalu.

Uwaga

Linki w tym artykule mogą otwierać zawartość w nowej dokumentacji Microsoft Foundry, w przeciwieństwie do dokumentacji Foundry (klasycznej), którą przeglądasz obecnie.

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

Uwaga

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

Po zbudowaniu agenta w Agent Service za pomocą rozszerzenia Visual Studio Code (VS Code), możesz dodać narzędzia MCP do swojego agenta. Dodanie serwera MCP umożliwia agentowi:

  • Uzyskaj aktualne informacje z interfejsów API i usług.
  • Pobierz odpowiedni kontekst, aby zwiększyć jakość odpowiedzi z modeli sztucznej inteligencji.

Wymagania wstępne

  • Subskrypcja Azure. Jeśli go nie masz, utwórz go bezpłatnie.
  • Projekt Foundry z wdrożonym modelem.
  • Visual Studio Code z zainstalowanym rozszerzeniem Microsoft Foundry dla rozszerzenia Visual Studio Code.
  • Istniejący agent utworzony za pomocą rozszerzenia programu VS Code. Aby je utworzyć, wykonaj kroki opisane w Work with Agent Service in Visual Studio Code (Praca z usługą agenta w Visual Studio Code.
  • Zdalny adres URL serwera MCP do nawiązania połączenia z agentem.

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ą z Microsoft. Microsoft nie testuje ani nie weryfikuje tych serwerów. Aby uzyskać szczegółowe informacje, zobacz Rozważania 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 serwer GitHub MCP. Utwórz lub zaktualizuj agenta usługi Foundry za pomocą narzędzia MCP, korzystając z następujących informacji:

    1. Server URL: 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.

Wdróż agenta w 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 na 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. Można:

  • Wybierz przycisk Edytuj agenta, aby wyświetlić projektanta agenta i definicję agenta w formacie .yaml 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 edycji wybierz przycisk Update Agent on 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 można było wysyłać komunikaty.

  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 będzie mógł kontynuować.

  6. Agent używa modelu i narzędzi serwera MCP skonfigurowanych do pobierania informacji. Po zakończeniu przetwarzania przez agenta, odpowiedź pojawi się w interfejsie testowym. Ź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.

Kwestia Rozdzielczość
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.

Czyszczenie zasobów

Za zasoby Azure utworzone w tym artykule są naliczane opłaty za subskrypcję 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órych już nie potrzebujesz, usuń je indywidualnie w portalu Azure:

  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.

Powiązana zawartość

  • Last updated on