Tworzenie agenta monitu za pomocą zestawu narzędzi Microsoft Foundry Toolkit for Visual Studio Code

Użyj narzędzia Agent Builder w Microsoft Foundry Toolkit for Visual Studio Code, aby skonfigurować model, instrukcje i narzędzia agenta monitu. Przetestuj agenta na placu zabaw, zapisz zmiany jako wersje i wygeneruj kod klienta w celu wywołania go z aplikacji.

Ten artykuł rozpoczyna się od monitów agentów zapisanych w narzędziu Foundry. Narzędzie Agent Builder obsługuje również prompty przechowywane lokalnie, które mają różne opcje przechowywania, narzędzi i oceny. Aby zapoznać się z alternatywami opartymi na kodzie, zobacz Tworzenie agenta.

Wymagania wstępne

• Zainstaluj zestaw narzędzi Microsoft Foundry Toolkit for Visual Studio Code.
• Wybierz projekt Foundry. Potrzebujesz uprawnień do tworzenia agentów i używania modeli i narzędzi projektu. Zobacz Kontrola dostępu oparta na rolach programu Foundry.
• Wdrożenie modelu w tym projekcie. Zobacz Konfigurowanie zasobów usługi Foundry.

Programowanie monitów lokalnych nie wymaga projektu Foundry, chyba że używasz zasobów usługi Foundry.

Utwórz agenta prompt

Zacznij od modelu i instrukcji, a następnie zapisz i przetestuj agenta przed dodaniem narzędzi.

1. W widoku Foundry Toolkit wybierz Developer Tools>>Utwórz agenta.

2. Wybierz pozycję Utwórz agenta , aby otworzyć narzędzie Agent Builder.

3. W obszarze Podstawowe informacje wprowadź nazwę agenta. Rozpocznij i zakończ nazwę literą lub cyfrą. Możesz użyć łączników między nimi.

4. Wybierz model hostowany przez usługę Foundry z sekcji Model. Jeśli chcesz dodać model, użyj opcji Przeglądaj modele .

5. W obszarze Instrukcje opisz zadanie, wymagane zachowanie i oczekiwaną odpowiedź. Na przykład poproś agenta o podsumowanie problemu z oprogramowaniem, identyfikując zgłoszony problem, kroki odtwarzania i oczekiwane zachowanie. Powiedz mu, żeby pytał o brakujące informacje, zamiast wymyślać szczegóły.

6. Wybierz Zapisz do Foundry.

7. Na karcie Plac zabaw wprowadź żądanie i wybierz pozycję Wyślij wiadomość. Zadaj pytanie, aby przetestować konwersację.

8. Sprawdź, czy odpowiedź jest zgodna z instrukcjami. Uściślij instrukcje, zapisz i powtórz zgodnie z potrzebami.

   

Jeśli Narzędzia deweloperskie używają opcji Grupuj według zasobu, Utwórz agenta znajduje się w sekcji Narzędzia deweloperskie agenta zamiast w sekcji Kompilacja. Innym miejscem dostępu jest My Resources>Agents>Prompt Agent>. Wybierz istniejącego agenta na tej liście, aby go edytować.

Wybierz miejsce zapisania

Dostępne akcje zapisywania zależą od wybranego modelu i narzędzi.

Znaczki Microsoft Foundry i Local pokazują, gdzie jest przechowywany agent. Lokalnie przechowywany monit może nadal wywoływać model w chmurze. Pamięć lokalna nie oznacza, że wnioskowanie odbywa się na Twoim urządzeniu.

Zapisywanie wersji roboczych i wersji

Agent Builder oddziela lokalne kopie robocze odzyskiwania od zapisanych wersji agenta.

Jeśli narzędzie Agent Builder znajdzie szkic odzyskiwania, wybierz Przywróć wersję roboczą lub Odrzuć. Zapisz ważne zmiany jawnie przed przełączeniem agentów lub wersji.

Możesz przetestować niezapisane zmiany istniejącego agenta Foundry. To uruchomienie korzysta z edytowanej konfiguracji zamiast z zapisanej referencji do wersji agenta. Zapisz, zanim zaczniesz polegać na rozmowach powiązanych z wersją, śledzeniu lub wygenerowanym kodzie klienta.

Wybierz wersję agenta

Użyj selektora wersji obok nazwy agenta, aby załadować zapisaną wersję. Wersje agenta programu Foundry są niezmienne. Aby zachować zmiany wprowadzone we wcześniejszej wersji, wybierz pozycję Zapisz w usłudze Foundry , aby utworzyć nową wersję.

Wybrana wersja określa historię konwersacji pokazaną w narzędziu Agent Builder i wersję, do których odwołuje się wygenerowany kod klienta. Aby uzyskać szczegółowe informacje na temat przechowywania wersji usługi, zobacz Zapisywanie zmian jako wersji.

Dodaj narzędzia do agenta Foundry

Narzędzia łączą agenta z informacjami i akcjami spoza modelu. Dostępne narzędzia zależą od modelu, uprawnień i zasobów w projekcie. Użyj katalogu narzędzi , aby skonfigurować połączenia udostępnione i uwierzytelnianie, a następnie dołączyć je w narzędziu Agent Builder.

1. Otwórz zapisanego agenta Foundry na karcie Playground.
2. W obszarze Narzędzie wybierz pozycję +>Dodaj narzędzia.
3. W obszarze Wybierz narzędzie wybierz połączenie z sekcji Skonfigurowane lub użyj Katalogu, aby znaleźć narzędzie.
4. Ukończ wymaganą konfigurację, a następnie wybierz pozycję Dodaj narzędzie.
5. Wybierz Zapisz do Foundry.
6. Wyślij żądanie, które wymaga narzędzia, i przejrzyj jego dane wejściowe i wyniki. Jeśli agent żąda zatwierdzenia, wybierz pozycję Zatwierdź lub Odmów dla tego wywołania.

Aby przejrzeć ustawienia zatwierdzania wywołań narzędzi dla narzędzia MCP, otwórz jego opcje i wybierz pozycję Konfiguruj. Możesz wymagać zatwierdzenia, automatycznie zatwierdzić wszystkie narzędzia lub automatycznie zatwierdzić określone narzędzia. Przed zapisaniem przejrzyj wybór.

Ustawienia zatwierdzania nie udzielają dostępu do usługi bazowej. Aby uzyskać informacje o uprawnieniach usługi, zobacz Pojęcia dotyczące tożsamości agenta.

Użyj zestawu narzędzi (wersja zapoznawcza)

Zestaw narzędzi grupuje narzędzia wielokrotnego użytku za pośrednictwem zarządzanego punktu końcowego MCP. Umiejętności i wyszukiwanie narzędzi to funkcje w wersji zapoznawczej.

Agent używa przybornika lub poszczególnych narzędzi Foundry. Dołączenie zestawu narzędzi zastępuje jego poszczególne narzędzia. Gdy skrzynka narzędziowa jest dołączona, opcja Dodaj narzędzia dodaje narzędzia do tej skrzynki narzędziowej.

Zmiany w zestawie narzędzi są przechowywane do czasu zapisania agenta, kiedy to tworzą nową wersję zestawu narzędzi. Zestawy narzędzi są współdzielonymi zasobami; przed zapisaniem przejrzyj zarówno zestaw narzędzi, jak i zmiany w agencie.

1. Otwórz zapisanego agenta usługi Foundry.

2. W obszarze Narzędzie wybierz pozycję +>Przeglądaj przyborniki.

3. Wybierz zestaw narzędzi i sprawdź jego wersję, narzędzia oraz kompetencje.

4. Wybierz opcję Dodaj.

5. Rozwiń kartę zestawu narzędzi, aby sprawdzić jej zawartość i przejrzeć ustawienia zatwierdzania.

6. Wybierz Zapisz w Foundry, a następnie przetestuj żądanie korzystające z narzędzi Foundry.

   

Możesz również wybrać Dodaj do Prompt Agent na liście zasobów w Przyborniku. Informacje na temat tworzenia zestawu narzędzi i udostępnianych połączeń znajdziesz w sekcji Katalog narzędzi.

Zarządzaj dołączonym zestawem narzędzi

Użyj menu Więcej opcji na karcie narzędzia, a następnie po wprowadzeniu zmian zapisz agenta.

Łączenie innego agenta z usługą A2A (wersja zapoznawcza)

Połączenia agent-agent (A2A) pozwalają agentowi promptującemu wywołać agenta kompatybilnego z A2A jako narzędzie. Możesz podłączyć go bezpośrednio lub za pomocą zestawu narzędzi. Załącznik bezpośredni nie wymaga ustawienia zgody na korzystanie z przybornika.

1. Otwórz zapisanego agenta usługi Foundry.

2. W obszarze Narzędzie wybierz pozycję +>Dodaj agenta (A2A).

3. W sekcji Połącz agenta A2A wybierz odpowiednią kartę.

   Tab	Co należy podać
   skonfigurowane	Wybierz istniejące połączenie A2A. Ta karta jest wyświetlana, gdy istnieją skonfigurowane połączenia.
   Katalog	Wybierz agenta z katalogu konta Foundry. Po wyświetleniu monitu wykonaj kroki uwierzytelniania i karty agenta.
   Niestandardowe	Wprowadź nazwę, prawidłowy punkt końcowy HTTPS i ścieżkę do karty agenta. W razie potrzeby wybierz pozycję Uwierzytelnij podczas pobierania karty agenta .

4. Ukończ okno dialogowe, aby nawiązać połączenie lub dodać agenta.

5. Wybierz pozycję Zapisz w usłudze Foundry, a następnie przetestuj żądanie wymagające połączenia.

   

Aby uzyskać informacje o konfiguracji punktu końcowego, kartach agentów, opcjach tożsamości i uprawnieniach, zobacz Włączanie punktu końcowego A2A.

Przeglądanie konwersacji i przełączanie agentów

Playground zawiera bieżącą rozmowę testową. Wybierz pozycję Wyczyść wszystkie wiadomości , aby rozpocząć nową konwersację.

Dla zapisanego agenta usługi Foundry wybierz pozycję Rozmowy, aby przejrzeć historię dla wybranej wersji. Wybierz konwersację, aby sprawdzić jego wiadomości i szczegóły odpowiedzi. Historia otwarcia nie wznowi tej rozmowy na placu zabaw.

Użyj selektora agenta w górnej części narzędzia Agent Builder, aby przełączać się między monitami lokalnymi i agentami monitów usługi Foundry. Sprawdź oznaczenie pamięci i wersję po przełączeniu. Karta Konwersacje jest dostępna dla zapisanych agentów usługi Foundry, a nie dla monitów lokalnych.

Generowanie i ulepszanie instrukcji

Użyj opcji Generuj , aby utworzyć wersję roboczą instrukcji z opisu zadania lub ulepszyć , aby poprawić istniejące instrukcje. Gdy pole jest puste, Zainspiruj mnie może podsunąć pomysł na początek.

1. Wybierz model obsługujący generowanie instrukcji.
2. W obszarze Instrukcje wybierz pozycję Generuj , jeśli pole jest puste, lub Popraw , jeśli zawiera instrukcje.
3. Opisz zadanie lub zmień. W przypadku istniejącego agenta usługi Foundry sugestie dotyczące ulepszeń są opcjonalne.
4. Wybierz pozycję Generuj lub Ulepsz w oknie dialogowym.
5. Przejrzyj poprawione instrukcje i żądania przedstawicieli testowych.
6. Wybierz Zapisz do Foundry, aby zachować konfigurację.

W przypadku zapisanych agentów usługi Foundry te akcje używają optymalizatora monitów platformy Foundry. Jeśli interfejs API optymalizacji nie obsługuje modelu, zestaw narzędzi wraca do standardowego generowania monitów, gdy jest obsługiwany. Wybranie modelu Foundry w nowym szkicu samo w sobie nie sprawia, że szkic staje się zapisanym agentem Foundry.

Oceń agenta monitu usługi Foundry

Zapisz konfigurację, którą chcesz ocenić, a następnie wybierz pozycję Ocena.

• Wybierz Kod ewaluacyjny szkieletu, aby wygenerować lokalny projekt ewaluacyjny w języku Python. Postępuj zgodnie z wygenerowanymi instrukcjami, aby je skonfigurować i uruchomić.
• Wybierz łącze Foundry, aby skonfigurować ocenę z przewodnikiem.

Przed uruchomieniem tej konfiguracji przejrzyj wygenerowaną konfigurację oceny. Szablon identyfikuje agenta po nazwie; nie zakładaj, że przypina wersję wybraną w narzędziu Agent Builder.

Ta karta różni się od lokalnego widoku zestawu danych monitów. Aby uzyskać wskazówki dotyczące oceny usług, zobacz Ocena agentów.

Generowanie kodu klienta

Po zapisaniu agenta usługi Foundry użyj menu Wyświetl kod , aby wywołać go z aplikacji.

Oba dane wyjściowe odwołują się do wybranej zapisanej wersji. Zapisz zmiany przed wygenerowaniem kodu, jeśli aplikacja potrzebuje poprawionej konfiguracji.

Kod klienta nie przekształca agenta opartego na monicie w agenta hostowanego. Informacje o bezpośrednim użyciu pakietu SDK znajdziesz w przewodniku Szybki start dotyczącym prompt-agent.

Praca z monitami lokalnymi

Wybierz magazyn lokalny, aby użyć modelu od innego dostawcy lub przetestować narzędzia lokalne. Wybierz model, wprowadź instrukcje i wybierz pozycję Zapisz w lokalizacji lokalnej. W przypadku modelu Foundry użyj menu zapisywania, gdy magazyn lokalny jest dostępny.

Użyj polecenia Zapisz do lokalnego , aby zachować zmiany lokalne. Zapisy lokalne nie tworzą wersji programu Foundry ani rekordów historii konwersacji programu Foundry.

Łączenie narzędzi lokalnych

W przypadku monitu lokalnego wybierz Narzędzie>+>MCP Server, aby wybrać serwer i jego narzędzia. Aby uzyskać informacje o wymaganiach dotyczących konfiguracji i środowiska uruchomieniowego, zobacz Connect a local MCP server (Łączenie lokalnego serwera MCP).

Aby przetestować schemat funkcji bez implementowania usługi zewnętrznej:

1. Wybierz Narzędzie>+>Narzędzie niestandardowe.
2. Wybierz pozycję Według przykładu lub przekaż istniejący schemat.
3. Podaj schemat, nazwę i opis, a następnie dodaj narzędzie.
4. Wprowadź odpowiedź testową w karcie narzędzia.
5. Uruchom prompt i sprawdź, jak model wykorzystuje odpowiedź.

Symulowana odpowiedź nie wykonuje wywołania do zewnętrznego interfejsu API. Skonfigurowany serwer MCP może wykonywać swoje narzędzia.

Konfigurowanie ustrukturyzowanych danych wyjściowych

W przypadku monitu lokalnego z modelem obsługującym ustrukturyzowane dane wyjściowe:

1. Otwórz pozycję Ustawienia obok selektora modelu.
2. W sekcji Dane wyjściowe struktury wybierz json_schema.
3. W obszarze Wybierz schemat JSON wybierz pozycję Użyj przykładu lub przekaż plik.
4. Przejrzyj schemat i wybierz pozycję Wybierz.
5. Zapisz monit lokalny i uruchom żądanie, aby sprawdzić jego dane wyjściowe.

Dostępne formaty zależą od modelu. Te kroki dotyczą lokalnego uruchamiania promptu, a nie schematu odpowiedzi zapisanego agenta promptów Foundry.

Ocenianie monitów lokalnych za pomocą zmiennych zestawu danych

W przypadku zapisanego lokalnego monitu karta Ocena zawiera ocenę opartą na zestawie danych. Użyj zmiennych w instrukcjach, aby uruchomić ten sam monit z różnymi wartościami zestawu danych.

Na przykład Summarize the issue for {{audience}}. używa kolumny zestawu danych o nazwie audience. Podaj wartość dla każdego przypadku testowego. Lokalny moduł uruchamiający wsadowo zastępuje tę wartość podczas uruchamiania monitu.

Środowisko testowe Agent Buildera nie ma oddzielnego panelu „Zmienne”. Aby zapoznać się z importowaniem, ewaluatorami i porównaniem wyników zestawu danych, zobacz Ocena modeli, monitów i agentów.

Generowanie kodu dla monitu lokalnego

Wybierz pozycję Wyświetl kod , aby wygenerować kod integracji modelu. Dostępne opcje zestawu SDK, uwierzytelniania i języka zależą od dostawcy i modelu. Te opcje różnią się od projektu klienta agenta Foundry i akcji fragmentu kodu.

Treści powiązane

Skorzystaj z poniższych przewodników, aby tworzyć i opublikować swojego agenta:

• Tworzenie agenta za pomocą zestawu narzędzi Microsoft Foundry Toolkit
• Cykl projektowania agenta
• Publikowanie aplikacji agenta