Tworzenie klasycznych agentów usługi Foundry i zarządzanie nimi w programie Visual Studio Code (wersja zapoznawcza) (wersja klasyczna)

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.

Uwaga / Notatka

Ten dokument odnosi się do klasycznej wersji interfejsu API agentów.

Usługa agenta foundry umożliwia tworzenie, konfigurowanie i wdrażanie agentów bez opuszczania programu Visual Studio Code (VS Code). W tym artykule utworzysz agenta przy użyciu projektanta, dodaj narzędzia, przetestujesz agenta na placu zabaw, wygenerujesz przykładowy kod i wyczyścisz zasoby po zakończeniu.

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

• Subskrypcja platformy Azure. Utwórz je bezpłatnie.
• Dostęp do usługi agenta programu Foundry.
• Zainstalowany program Visual Studio Code .
• Rozszerzenie Microsoft Foundry dla programu VS Code zostało zainstalowane i zalogowane.
• Wdrożony model w projekcie.

Utwórz agenta w projektancie

Projektant udostępnia interfejs wizualny do konfigurowania nazwy, modelu, instrukcji i narzędzi agenta.

1. Zaloguj się do zasobów platformy Azure.

2. Ustaw projekt domyślny.

3. W widoku Rozszerzenie Foundry znajdź podsekcję Klasyczna w sekcji Zasoby.

4. Wybierz ikonę znaku plus (+) obok podsekcji Agenci klasyczni , aby utworzyć nowego agenta.

Konfigurowanie agenta w projektancie

Po wybraniu lokalizacji zapisywania zostanie otwarty plik agenta .yaml i widok projektanta. Skonfiguruj następujące ustawienia:

1. W polu wprowadź nazwę dla swojego agenta.

2. Z listy rozwijanej wybierz nazwę wdrożenia modelu. Nazwa wdrożenia jest wybrana podczas wdrażania istniejącego modelu.

3. Rozszerzenie generuje wartość Identyfikator . Skonfiguruj następujące pola:

   • Dodaj opis agenta.
   • Ustaw instrukcje systemowe.
   • Skonfiguruj narzędzia dla agenta.

4. Aby zapisać plik yaml, wybierz pozycję Plik>Zapisz na pasku menu programu VS Code.

Przejrzyj definicję YAML agenta

Plik .yaml otwiera się obok Projektanta i zawiera szczegóły konfiguracji Twojego agenta. Format jest podobny do następującego przykładu:

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

Dodawanie narzędzi do agenta

Usługa agenta udostępnia następujące narzędzia umożliwiające rozszerzenie możliwości agenta i nawiązanie połączenia ze źródłami danych:

• Poznawanie świata za pomocą wyszukiwania Bing
• Wyszukiwanie plików
• Interpreter kodu
• Określone narzędzia interfejsu OpenAPI
• Protokół MCP (Model Context Protocol)

Aby uzyskać więcej informacji na temat korzystania z narzędzi MCP, zobacz Praca z usługą agenta i narzędziami serwera MCP w programie Visual Studio Code (wersja zapoznawcza).

Dodaj narzędzie do agenta

1. W projektancie w prawym górnym rogu sekcji TOOL wybierz pozycję Dodaj narzędzie. Z listy rozwijanej wybierz narzędzie, które chcesz dodać.

   

2. Projektant wyświetla odpowiednie okienko do skonfigurowania narzędzia, jak pokazano na poniższych obrazach:

   • Podstawy za pomocą wyszukiwania Bing:

     

   • Wyszukiwanie plików:

     

   • Interpreter kodu:

     

   • Określone narzędzia openAPI 3.0:

     

3. Po wprowadzeniu wymaganych informacji wybierz pozycję Utwórz i połącz, Przekaż i zapisz lub Utwórz narzędzie. Etykieta przycisku różni się w zależności od typu narzędzia.

   Po utworzeniu narzędzia zostanie ono wyświetlone w sekcji TOOL projektanta.

Po dodaniu narzędzia możesz również dodać wszelkie nowe zasoby, których potrzebuje. Jeśli na przykład dodasz narzędzie do wyszukiwania plików, możesz użyć istniejącego zasobu magazynu wektorów lub utworzyć nowy do hostowania przekazanych plików.

Wdrażenie agenta do Foundry

Po zakończeniu konfigurowania agenta wdróż go w rozwiązaniu Foundry, aby działał w chmurze.

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

Wybierz wdrożonego agenta, aby otworzyć okienko PREFERENCJE AGENTa w trybie tylko do wyświetlania. W tym okienku możesz:

• Wybierz Edytuj Agenta, aby otworzyć projektanta agenta i definicję YAML do edycji.
• Wybierz pozycję Wyświetl kod , aby wygenerować przykładowy plik kodu, który używa agenta.
• Wybierz pozycję Otwórz plac zabaw , aby otworzyć plac zabaw dla agenta zdalnego.

Aktualizowanie wdrożonego agenta

Możesz zmodyfikować konfigurację wdrożonego agenta i zsynchronizować zmiany z powrotem z usługą Foundry.

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

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

3. Wybierz przycisk Update Agent on Microsoft Foundry (Agent aktualizacji w programie Microsoft Foundry ), aby zapisać zmiany. Zaktualizowana konfiguracja wchodzi w życie natychmiast.

Generowanie przykładowego pliku kodu

Rozszerzenie generuje standardowy kod do interakcji z wdrożonym agentem programowo.

1. Kliknij prawym przyciskiem myszy wdrożonego agenta, a następnie wybierz polecenie Wyświetl kod. Lub w okienku PREFERENCJE AGENTA wybierz przycisk Wyświetl kod .

2. Z listy rozwijanej Wybierz preferowany zestaw SDK wybierz zestaw SDK.

3. Z listy rozwijanej Wybierz język wybierz swój język.

4. Z listy rozwijanej Wybierz metodę uwierzytelniania wybierz metodę uwierzytelniania.

Rozszerzenie generuje plik kodu w wybranym języku i otwiera go w edytorze.

Przejrzyj przykładowy plik kodu

Wygenerowany plik kodu demonstruje podstawowe wywołanie interakcji z agentem za pośrednictwem interfejsu API projektów Foundry. Poniższy zrzut ekranu przedstawia przykład języka Python:

Testowanie agenta na placu zabaw

Użyj placu zabaw, aby wysyłać komunikaty do wdrożonego agenta i weryfikować jego zachowanie.

1. Kliknij prawym przyciskiem myszy wdrożonego agenta, a następnie wybierz polecenie Otwórz plac zabaw.

   Alternatywnie wybierz link Plac zabaw agenta zdalnego w podsekcji Narzędzia , wybierz typ agenta, a następnie wybierz agenta z list rozwijanych.

   Okienko Panel Agenta Zdalnego otworzy się i uruchomi wątek z Twoim agentem.

2. Wprowadź monit i wyświetl dane wyjściowe.

   W tym przykładzie użyto rozwiązania Bing Grounding , aby zilustrować wyszukiwanie informacji w Internecie. Agent używa modelu i narzędzi skonfigurowanych w projektancie agentów. Źródło informacji jest wyświetlane w sekcji adnotacji agenta.

   

Wyświetlanie wątków agenta

W podsekcji Wątki są wyświetlane wątki konwersacji utworzone podczas uruchamiania z Twoim agentem. W sekcji Klasycznej w widoku Zasoby rozwiń podsekcję Wątki , aby wyświetlić listę.

Uwaga / Notatka

Wątek to sesja konwersacji między agentem a użytkownikiem. Wątki przechowują komunikaty i automatycznie obsługują skracanie w celu dopasowania treści do kontekstu modelu. Komunikat to jedna interakcja, która może zawierać tekst, obrazy i inne pliki. Uruchomienie to pojedyncze wykonanie agenta, które może obejmować wiele wątków i komunikatów.

Wyświetlanie szczegółów wątku

Aby wyświetlić okienko SZCZEGÓŁY WĄTKU , wybierz wątek z listy.

Wyświetlanie szczegółów przebiegu

Aby wyświetlić informacje o przebiegu, wybierz przycisk Wyświetl informacje o przebiegu w okienku SZCZEGÓŁY WĄTKU . Zostanie otwarty plik .json ze szczegółami przebiegu, w tym konfiguracją agenta, komunikatami i wywołaniami narzędzi.

Uprzątnij zasoby

Jeśli nie potrzebujesz utworzonych zasobów, usuń je, aby uniknąć bieżących opłat za subskrypcję platformy Azure.

Usuwanie agentów

Wskazówka

Ponieważ możesz dostosować okienko po lewej stronie w portalu Microsoft Foundry, możesz zobaczyć inne elementy, niż pokazano w tych krokach. Jeśli nie widzisz szukanych danych, wybierz pozycję ... Więcej w dolnej części okienka po lewej stronie.

1. W programie VS Code odśwież widok Zasoby platformy Azure .
2. Rozwiń podsekcję Agenci , aby wyświetlić listę wdrożonych agentów.
3. Kliknij prawym przyciskiem myszy agenta, który chcesz usunąć, a następnie wybierz polecenie Usuń.

Usuń swoje modele

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

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

Usuwanie połączonych narzędzi

1. Otwórz portal Azure.

2. Przejdź do grupy zasobów zawierającej zasób narzędzia.

3. Wybierz zasób, a następnie wybierz pozycję Usuń.

Treści powiązane

• Współpracuj z narzędziami usługi agenta i serwera MCP w programie Visual Studio Code (wersja zapoznawcza), aby dodać narzędzia MCP do agentów.
• Omówienie narzędzi agenta , aby uzyskać szczegółowe informacje na temat wyszukiwania plików, interpretera kodu i innych dostępnych narzędzi.
• Omówienie usługi Agenta Foundry aby lepiej zrozumieć pojęcia i możliwości agenta.