Udostępnij przez

Cykl projektowania agenta

Cykl życia rozwoju agentów w Microsoft Foundry obejmuje od początkowego tworzenia do monitorowania produkcji. Po wykonaniu tego cyklu życia można tworzyć niezawodnych agentów, wcześnie wychwytywać problemy i wprowadzać je na rynek z pewnością siebie. Użyj portalu Foundry lub kodu, aby skompilować, dostosować i przetestować zachowanie agenta. Przeprowadzać iteracje poprzez śledzenie, ocenę i monitorowanie w celu poprawy jakości i niezawodności. Gdy będziesz gotowy, opublikuj swojego agenta jako aplikację agenta, aby móc ją udostępnić i zintegrować z aplikacjami.

Ten artykuł dotyczy deweloperów, którzy chcą tworzyć, testować i dostarczać agentów gotowych do produkcji.

Wymagania wstępne

Cykl życia w skrócie

Użyj tego cyklu życia jako praktycznej listy kontrolnej podczas projektowania i wdrażania agenta.

  1. Wybierz typ agenta: rozpocznij od agenta opartego na monitach, przepływu pracy lub hostowanego agenta.
  2. Utwórz agenta i rozpocznij testowanie: iteruj na placu zabaw lub w kodzie.
  3. Dodaj narzędzia i dane: Dołącz narzędzia do pobierania i akcji oraz zweryfikuj konfigurację przed zapisaniem.
  4. Zapisz zmiany jako wersje: uchwyć istotne kamienie milowe i porównaj wersje.
  5. Debugowanie za pomocą śledzenia: Użyj śledzenia, aby potwierdzić wywołania narzędzi, opóźnienia i zachowanie końcowe. Aby uzyskać szczegółowe informacje, zobacz Omówienie śledzenia agentów.
  6. Ocena jakości i bezpieczeństwa: uruchom powtarzalne oceny, aby przechwycić regresje przed opublikowaniem. Aby uzyskać wskazówki dotyczące koncepcji, zobacz Oceny agentów.
  7. Publikowanie i integrowanie: publikowanie stabilnego punktu końcowego i integrowanie go z aplikacją. Aby uzyskać instrukcje, zobacz Publikowanie i udostępnianie agentów w rozwiązaniu Microsoft Foundry.
  8. Monitorowanie i iterowanie: monitorowanie wydajności i jakości w środowisku produkcyjnym, a następnie aktualizowanie i ponowne publikowanie w razie potrzeby. Aby uzyskać wskazówki, zobacz Monitorowanie jakości i bezpieczeństwa.

Typy agentów w rozwiązaniu Microsoft Foundry

Istnieją trzy typy agentów:

  • Na bazie podpowiedzi: Agent na bazie podpowiedzi to deklaratywnie zdefiniowany pojedynczy agent, który łączy konfigurację modelu, instrukcje, narzędzia i podpowiedzi języka naturalnego w celu prowadzenia zachowania. Rozszerz go, dołączając narzędzia do wiedzy i pamięci. Edytuj, wersjonuj, testuj, oceniaj, monitoruj i publikuj agentów bazujących na monitach z placu zabaw dla agentów w portalu Foundry.

  • Przepływ pracy: użyj przepływów pracy, aby utworzyć bardziej zaawansowany przepływ pracy, który organizuje sekwencję akcji lub koordynuje wielu agentów. Przepływy pracy mają własny interfejs w portalu, ale ma zastosowanie ten sam cykl życia. Aby uzyskać szczegółowe informacje, zobacz Tworzenie przepływu pracy w rozwiązaniu Microsoft Foundry.

  • Hostowane (wersja zapoznawcza): Hostowane agenty to kontenerowi agenci tworzeni w kodzie przy użyciu obsługiwanych frameworków lub kodu niestandardowego. Usługa Foundry Agent wdraża tych agentów i zarządza nimi. Nie edytujesz hostowanych agentów w interfejsie użytkownika tworzenia agentów, ale nadal możesz wywoływać, oceniać, monitorować i publikować. Aby uzyskać szczegółowe informacje, zobacz Co to są hostowani agenci?

Tworzenie agentów i przepływów pracy opartych na monitach w portalu Foundry lub własnym środowisku programistycznym przy użyciu interfejsu wiersza polecenia, zestawu SDK lub interfejsu API REST. Aby uzyskać więcej informacji, zobacz przewodnik Szybki start.

Tworzenie agenta opartego na monitach

Jeśli już wiesz, jakiego rodzaju agent chcesz utworzyć, nadaj mu nazwę, a następnie rozpocznij konfigurowanie instrukcji i narzędzi modelu.

Uwaga / Notatka

Po nadaniu nazwy agentowi, nie można jej zmienić. W kodzie odwołujesz się do agenta za pomocą polecenia <agent_name>:<version>.

Tworzenie agentów w kodzie

Jeśli wolisz pracować w kodzie, użyj obsługiwanych sposobów, aby przenieść kod agenta do środowiska deweloperskiego, z którego można testować lokalnie, a następnie wdrożyć na platformie Azure.

Na karcie Kod w okienku czatu placu zabaw agenta można przenieść fragment kodu odwołujący się do agenta do dedykowanego środowiska Visual Studio Code for the Web w chmurze. Fragment kodu jest wstępnie skonfigurowany wraz z potrzebnymi pakietami i rozszerzeniami wraz z instrukcjami umożliwiającymi efektywne opracowywanie i wdrażanie agenta usługi Foundry na platformie Azure. Możesz również skopiować fragment kodu bezpośrednio do preferowanego środowiska deweloperskiego. Aby uzyskać szczegółowe informacje, zobacz dokumentację placu zabaw.

Podstawowe możliwości cyklu projektowania agenta

Doświadczenia związane z tworzeniem agentów oferują zintegrowane podejście dla każdego kluczowego etapu cyklu rozwoju agenta. Użyj tych podstawowych możliwości podczas tworzenia aplikacji agenta gotowego do produkcji. Każda możliwość zawiera szczegółową dokumentację, w której można dowiedzieć się więcej.

Zapisz zmiany jako wersje

Po utworzeniu pierwszej wersji agenta opartego na monitach lub przepływu pracy zapisz kolejne zmiany jako nowe wersje. Możesz przetestować niezapisane zmiany na placu zabaw agenta. Jeśli jednak chcesz wyświetlić historię konwersacji, monitorować wydajność agenta lub uruchamiać pełne oceny, musisz zapisać zmiany.

Przechowywanie wersji agenta zapewnia następujące możliwości zarządzania konfiguracjami agenta i iteracjami. Ten system zapewnia, że wszystkie zmiany są śledzone, testowalne i porównywalne w różnych wersjach.

  • Niezmienność wersji: każda wersja agenta jest niezmienna po jego zapisaniu. Wszelkie modyfikacje istniejącej wersji wymagają zapisania i utworzenia nowej wersji. To wymaganie pomaga zapewnić integralność wersji i zapobiega przypadkowemu zastępowaniu.

  • Zarządzanie stanem roboczym: Można testować agentów w stanie niezapisanym do celów eksperymentów. Jeśli opuścisz portal Foundry, utracisz niezapisane zmiany, dlatego zapiszesz je często, aby zachować ważne modyfikacje.

  • Operacje kontroli wersji: możesz kierować żądania do określonych wersji agentów, aby umożliwić kontrolowane wdrażanie i wycofywanie możliwości.

  • Nawigacja historii wersji: Uzyskaj dostęp do historii wersji dla dowolnego agenta, przejdź do dowolnej określonej wersji i wykonaj następujące porównania:

    Typ porównania Opis
    Konfiguracja agenta Porównanie ustawień konfiguracji między wersjami przy użyciu listy rozwijanej wersji
    Dane wyjściowe czatu Analizowanie różnic odpowiedzi między wersjami agentów przy użyciu identycznych danych wejściowych
    Definicja YAML Przegląd różnic w definicjach agentów

Dodawanie narzędzi

Wzmocnij swojego agenta, przekazując mu wiedzę (określone pliki lub indeksy) lub umożliwiając wykonywanie działań (wywoływanie zewnętrznych interfejsów API). Narzędzia są dostępne w większości przypadków użycia – od prostego przesyłania plików do niestandardowych połączeń serwerów protokołu MCP (Model Context Protocol). W przypadku bardziej skomplikowanych narzędzi może być konieczne skonfigurowanie uwierzytelniania lub dodanie połączeń w ramach dołączania ich do agenta.

Aby zapisać agenta z dołączonym narzędziem, należy pomyślnie skonfigurować narzędzie. Ponowne używanie skonfigurowanych narzędzi przez agentów. Aby uzyskać informacje o dostępnych narzędziach, zobacz katalog narzędzi.

Debugowanie i weryfikowanie przy użyciu śledzenia (wersja zapoznawcza)

Podczas dodawania narzędzi i iterowania monitów użyj śledzenia, aby zweryfikować działanie całego systemu:

  • Sprawdź, czy agent użył oczekiwanych narzędzi.
  • Sprawdzanie danych wejściowych i wyjściowych narzędzi.
  • Identyfikowanie hotspotów opóźnienia między wywołaniami modelu i narzędzi.

Aby uzyskać więcej informacji, zobacz Omówienie śledzenia agentów.

Ocena jakości i bezpieczeństwa (wersja zapoznawcza)

Przed opublikowaniem agenta (i po każdej znaczącej zmianie) uruchom oceny w celu spójnego wykrywania regresji i mierzenia jakości we wszystkich wersjach.

Monitorowanie po opublikowaniu

Po opublikowaniu aplikacji agenta traktuj ją jak oprogramowanie produkcyjne:

  • Monitorowanie sygnałów jakości i bezpieczeństwa.
  • Przejrzyj ślady po zmianie zachowania.
  • Aktualizowanie i ponowne publikowanie podczas rozwiązywania problemów lub wprowadzania ulepszeń.

Aby uzyskać wskazówki, zobacz Monitorowanie jakości i bezpieczeństwa.

Plan tożsamości i uprawnień

Narzędzia i zasoby podrzędne często wymagają uwierzytelniania. Podczas publikowania agenta jego tożsamość i model uprawnień mogą ulec zmianie. Upewnij się, że opublikowany agent ma tylko wymagany dostęp.

Aby uzyskać szczegółowe informacje, zobacz Pojęcia dotyczące tożsamości agenta w rozwiązaniu Microsoft Foundry.

Zabezpieczenia i dostęp

Traktuj konfigurację agenta, np. kod aplikacji. Chroń tajemnice i uprawnienia w całym cyklu życia.

Opublikuj agenta lub przepływ pracy

Po utworzeniu agenta lub wersji przepływu pracy, z której korzystasz, opublikuj ją jako aplikację agenta. Uzyskasz stabilny punkt końcowy, który można otworzyć i przetestować w przeglądarce, udostępnić innym osobom lub osadzić w istniejących aplikacjach. Ty i twoi współpracownicy mogą weryfikować wydajność i identyfikować potrzeby uściślenia. Wprowadź wszelkie niezbędne aktualizacje i ponownie opublikuj nową wersję w dowolnym momencie.

Ważna

Uprawnienia przypisane do tożsamości projektu nie są automatycznie przenoszone do opublikowanego agenta. Po opublikowaniu przypisz ponownie niezbędne uprawnienia do tożsamości aplikacji agenta.

Typowe pułapki w rozwoju agentów

  • Niezapisane zmiany są tymczasowe: jeśli chcesz porównać wersje, wyświetlić historię lub uruchomić pełne oceny, zapisz zmiany jako wersję.
  • Przed zapisaniem należy skonfigurować narzędzia: jeśli narzędzie wymaga uwierzytelniania lub połączenia, przed zapisaniem należy wykonać instalację.
  • Publikowanie może wymagać aktualizacji uprawnień: po opublikowaniu sprawdź ponownie dostęp do zasobów dla tożsamości opublikowanego agenta i usuń dostęp, którego agent już nie potrzebuje.

Treści powiązane

Dowiedz się więcej o typach agentów:

Konfigurowanie i rozszerzanie agentów:

Publikowanie i monitorowanie agentów:

Debugowanie i ocena:

  • Last updated on