Praca z usługą Foundry Agent w programie Visual Studio Code (wersja zapoznawcza)

Po rozpoczęciu pracy z rozszerzeniem Microsoft Foundry dla programu Visual Studio Code użyj usługi Agent foundry do kompilowania agentów. Agenci to mikrousługi, które:

• Odpowiedz na pytania, korzystając z danych treningowych lub wyszukując inne źródła przy generacji wspomaganej wyszukiwaniem (RAG).
• Wykonywanie określonych akcji.
• Automatyzowanie pełnych przepływów pracy.

Agenci łączą modele sztucznej inteligencji z narzędziami umożliwiającymi uzyskiwanie dostępu do danych i interakcję z nimi.

Deweloperzy programu Foundry mogą zachować produktywność, opracowując, testując i wdrażając agentów w znanym środowisku programu Visual Studio Code (VS Code).

Tworzenie i edytowanie agenta usługi Azure AI w widoku projektanta

Wykonaj następujące kroki, aby utworzyć agenta sztucznej inteligencji platformy Azure:

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

2. Ustaw projekt domyślny.

3. Wdróż model do użycia z agentem.

4. W widoku Rozszerzenia usługi Foundry znajdź sekcję Zasoby .

5. Wybierz ikonę znaku plus (+) obok podsekcji Agenci , aby utworzyć nowego agenta sztucznej inteligencji.

   

Interakcja z agentem w projektancie

Po wybraniu lokalizacji zapisywania otwórz zarówno plik yaml agenta, jak i widok projektanta, aby można było edytować agenta sztucznej inteligencji. Wykonaj następujące zadania w projektancie agentów:

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.

Zapoznaj się z definicją yaml agenta sztucznej inteligencji platformy Azure

Plik yaml agenta sztucznej inteligencji został otwarty w tym samym czasie, w jakim był projektant. Ten plik zawiera szczegóły i informacje o konfiguracji agenta. Jest on podobny do następującego przykładu pliku yaml:

# 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ługi Azure AI

Usługa agenta ma następujący zestaw narzędzi, których można użyć do interakcji ze źródłami danych. Te narzędzia są dostępne w rozszerzeniu Foundry for Visual Studio Code.

• 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 sztucznej inteligencji

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. Przycisk różni się w zależności od okienka.

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 zasób dla magazynu wektorów do hostowania przekazanych plików.

Tworzenie agenta usługi Azure AI w witrynie Foundry

Utwórz agenta bezpośrednio w narzędziu Foundry, wykonując następujące czynności:

1. W projektancie wybierz przycisk Utwórz agenta w narzędziu Foundry .

   

2. W programie VS Code odśwież widok Zasoby platformy Azure . Wdrożony agent zostanie wyświetlony w podsekcji Agenci .

   

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

Wybranie wdrożonego agenta powoduje otwarcie okienka 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 Otwórz plik kodu , aby utworzyć przykładowy plik kodu, który używa agenta.
• Wybierz przycisk Otwórz plac zabaw , aby otworzyć plac zabaw agenta.

Edytowanie i aktualizowanie wdrożonego agenta sztucznej inteligencji

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 Aktualizuj agenta w usłudze Foundry , aby zapisać zmiany.

Tworzenie przykładowego pliku kodu

1. Kliknij prawym przyciskiem myszy wdrożonego agenta, a następnie wybierz opcję Otwórz plik kodu . Lub w okienku PREFERENCJE AGENTA wybierz przycisk Otwórz plik kodu .

   

2. Z listy rozwijanej Wybierz preferowany zestaw SDK wybierz preferowany zestaw SDK dla pliku kodu agenta, a następnie wybierz Enter .

   

3. Z listy rozwijanej Wybierz język wybierz preferowany język dla pliku kodu agenta, a następnie wybierz Enter .

   

4. Na liście rozwijanej Wybierz metodę uwierzytelniania wybierz preferowaną metodę uwierzytelniania dla pliku kodu agenta, a następnie wybierz klucz Enter .

   

Eksplorowanie przykładowego pliku kodu

Poniższy przykładowy plik kodu w języku Python demonstruje podstawowe wywołanie interakcji z agentem za pośrednictwem interfejsu API projektów Foundry.

Interakcja z agentami przy użyciu placu zabaw agenta

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

   Alternatywnie wybierz link Plac zabaw agenta w podsekcji Narzędzia , a następnie wybierz agenta z listy rozwijanej.

   Ten krok otwiera okienko Plac zabaw agenta i uruchamia wątek z agentem, aby można było wysyłać komunikaty.

   

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.

   

Eksplorowanie wątków

Podsekcja Wątki wyświetla wątki utworzone podczas działania z Twoim agentem. W widoku Zasoby platformy Azure rozwiń podsekcję Wątki , aby wyświetlić listę.

Pamiętaj o tych terminach podczas eksplorowania wątków:

• 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 pojedyncza interakcja między agentem a użytkownikiem. Wiadomości mogą zawierać tekst, obrazy i inne pliki. Komunikaty są przechowywane jako lista w wątku.

• Uruchomienie to pojedyncze wykonanie agenta. Każde uruchomienie może mieć wiele wątków, a każdy wątek może zawierać wiele komunikatów. Agent używa konfiguracji i komunikatów wątku do wykonywania zadań przez wywoływanie modeli i narzędzi. W ramach przebiegu agent dołącza komunikaty do wątku.

Wyświetlanie szczegółów wątku

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

Wyświetlanie szczegółów przebiegu

Aby wyświetlić szczegóły uruchomienia w pliku JSON, wybierz przycisk Wyświetl informacje o uruchomieniu w okienku SZCZEGÓŁY WĄTKU. Poniższy zrzut ekranu przedstawia przykładowy plik JSON.

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

1. W programie VS Code odśwież widok Zasoby platformy Azure . Rozwiń podsekcję Agenci , 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

1. W programie VS Code odśwież widok Zasoby platformy Azure . 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

1. Otwórz witrynę Azure Portal.

2. Wybierz grupę zasobów platformy Azure zawierającą narzędzie.

3. Wybierz przycisk Usuń.

Treści powiązane

• Dowiedz się więcej o narzędziach, których można używać z agentami usługi Azure AI, takimi jak wyszukiwanie plików lub interpreter kodu.