Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Subagenty to wyspecjalizowani agenci wywoływani na żądanie. Wpisz /agent w czacie, wybierz swojego specjalistę i zadaj pytanie. Na przykład możesz wywołać eksperta w zakresie bazy danych pod kątem problemów z bazą danych SQL lub audytora zabezpieczeń na potrzeby badania zagrożeń.
W przeciwieństwie do umiejętności (które są zawsze dostępne), subagenty wymagają jawnego wywołania. To wymaganie obejmuje ich wiedzę na temat określonych zadań.
Jak działają subagenty
Wywołaj subagent przy użyciu /agent polecenia ukośnikowego na czacie. Subagent otrzymuje pełny kontekst konwersacji i współpracuje ze specjalistyczną wiedzą.
W poniższym przykładzie przedstawiono podstawową definicję subagenta:
name: database_expert
system_prompt: |
You are a database specialist. Analyze query performance,
diagnose connection issues, and recommend optimizations.
handoff_description: Handles SQL and database troubleshooting
tools:
- execute_kusto_query
- azure_cli
connectors:
- azure_sql
enable_skills: true # Can use skills for additional expertise
agent_type: Review # ReadOnly | Review | Autonomous
Właściwości klucza obejmują:
-
system_prompt: rola eksperta i jego instrukcje. -
handoff_description: Co widzi orkiestrator podczas podejmowania decyzji o delegowaniu. -
tools: Dostępne możliwości. -
enable_skills: umożliwia podagentowi dynamiczny dostęp do umiejętności. -
agent_type: Akcje kontrolek (ReadOnly, Review, Autonomous).
Wskazówka
Umiejętności są automatyczne: agent używa ich zawsze wtedy, gdy jest to istotne.
Subagenty są jawne: wywołujesz je przy użyciu /agent , gdy potrzebujesz specjalistycznej wiedzy.
Dlaczego warto używać podagentów
Subagenty umożliwiają pakowanie specjalistycznej wiedzy, narzędzi i doświadczenia do ponownego wykorzystania. Zamiast tego, by główny agent próbował obsługiwać wszystko, deleguje zadania do specjalistów.
Rozważ problem z bazą danych: bez podagentów główny agent próbuje rozwiązać ogólne problemy. Dzięki podagentowi "Database Expert" uzyskasz skoncentrowaną wiedzę SQL, elementy runbook specyficzne dla bazy danych i narzędzia dostosowane do analizy zapytań.
Subagenty umożliwiają również łańcuchy przekazywania. Twój podagent ds. selekcji incydentów klasyfikuje problem i przekazuje go odpowiedniemu ekspertowi w danej dziedzinie. Ekspert ds. domeny bada i przekazuje do routera powiadomień. Każdy krok jest wyspecjalizowany.
Tworzenie podagentu
Tworzenie podagentów w Konstruktorze Podagentów.
Przejdź do agenta usługi Azure SRE w witrynie Azure Portal.
Wybierz kartę Konstruktor subagentów.
Wybierz Utwórz.
Wybierz pozycję Subagent.
Podaj wartości następujących ustawień:
Majątek Wartość Nazwa Wprowadź opisowe miano podagentu. Instrukcje Podaj jasne, niestandardowe instrukcje, które definiują sposób działania subagentu. Opis przekazywania Wyjaśnij scenariusze, w których inne podagenty powinny przenosić przetwarzanie do tego podagentu i dlaczego. Narzędzia niestandardowe (opcjonalnie) Wybierz co najmniej jedno niestandardowe narzędzia dla subagentu do użycia podczas jego operacji. Wbudowane narzędzia (opcjonalnie) Wybierz wszystkie wbudowane narzędzia systemowe, do których ma mieć dostęp subagent. Agenci przekazywania (opcjonalnie) Określ, który podagent powinien przejąć przetwarzanie po zakończeniu zadań tego podagentu. Opcjonalnie możesz włączyć funkcję bazy wiedzy . Ta opcja umożliwia przekazywanie plików, których subagent może używać jako materiału referencyjnego podczas odpowiadania na zapytania.
Zarządzanie bazą wiedzy
Zwiększ wiedzę swoich subagentów, przesyłając dokumentację, runbooki i przewodniki proceduralne.
Przykłady plików, które można dodać do agenta:
- Architektura lub projekt systemu: diagramy i dokumentacja, które wyjaśniają składniki systemu i przepływy danych.
- Przewodniki rozwiązywania problemów: instrukcje krok po kroku dotyczące diagnozowania i rozwiązywania typowych lub powtarzających się problemów.
- Runbooki i SOPy: szczegółowe przepływy pracy dla rutynowych operacji, konserwacji i odpowiedzi na incydenty.
- Raporty o zdarzeniach i analizy post-mortem: dokumentacja przeszłych awarii, w tym główna analiza przyczyn i wyciągnięte wnioski.
- Informacje o wersji i dzienniki zmian: podsumowania aktualizacji produktu lub usługi, w tym nowych funkcji, poprawek błędów i zmian.
Typy obsługiwanych plików
Procedury operacyjne w formacie Markdown (.md) lub tekst (.txt).
Przepływ pracy zarządzania plikami
- Uzyskaj dostęp do bazy wiedzy, przechodząc do karty Ustawienia > Pliki bazy > wiedzy .
- Przekaż pliki, przeciągając i upuszczając pliki lub przeglądając, aby wybrać pliki (maksymalnie 50 MB na plik).
- Organizowanie zawartości przez dodanie tagów i opisów w celu uzyskania lepszej możliwości wyszukiwania.
- Włącz dostęp podrzędny, konfigurując, które podagenty mogą uzyskiwać dostęp do określonych źródeł wiedzy.
- Monitoruj użycie, śledząc, jak subagenty używają przekazanej wiedzy w odpowiedziach.
Uwaga / Notatka
Przekazane pliki są automatycznie indeksowane i możliwe do przeszukiwania przez podagentów. System obsługuje maksymalnie 1000 plików na wystąpienie podrzędne.
Widoki konstruktora podrzędnego
Kompiluj podagenty w > konstruktorze podagentów. Dostępne są następujące widoki:
| Widok | Purpose |
|---|---|
| Widok płótna | Diagram wizualny przedstawiający podagenty, narzędzia i połączenia wyzwalacza |
| Widok tabeli | Lista wszystkich podagentów z szybkim dostępem |
| Testowy plac zabaw | Interakcyjne środowisko testowe |
Kiedy należy używać podagentów
Poniższa tabela ułatwia określenie, kiedy subagenty są właściwym wyborem:
| Scenario | Czy używać subagentu? | Dlaczego |
|---|---|---|
| Wymagana jest głęboka wiedza fachowa w zakresie domeny | Yes | Wiedza na temat pakietów SQL, wiedza na temat sieci, najlepsze rozwiązania w zakresie zabezpieczeń |
| Przepływy pracy wieloetapowe | Yes | Klasyfikacja zdarzeń, walidacja wdrożenia, weryfikacja kopii zapasowej |
| Wyspecjalizowane zestawy narzędzi | Yes | Narzędzia specyficzne dla bazy danych, narzędzia do optymalizacji kosztów |
| Proste pojedyncze operacje | Nie. | Zamiast tego używaj umiejętności dla prostych, powtarzalnych akcji |
| Zapytania tylko do odczytu | Nie. | Główny agent może obsługiwać bez delegowania |
Aby uzyskać pełną konfigurację podagenta, zobacz Reagowanie na zdarzenia do automatyzacji odpowiedzi.
Przekazywanie subagenta
Gdy główny agent przekazuje zadanie podagentowi, dzielą pojedynczy kontekst konwersacji. Odbierający subagent widzi:
- Pełna historia konwersacji: wszystkie poprzednie wiadomości, wywołania narzędzi i wyniki
- Rozumowanie podzadania: co ten podrzędny ma wykonać
- Oryginalne pytanie użytkownika: zachowane w całym łańcuchu przekazywania
Uwaga / Notatka
Subagenci nie zaczynają z "czystą kartą". Kontynuują ten sam wątek konwersacji. Takie podejście umożliwia tworzenie ciągów przekazywania, w których każdy specjalista bazuje na pracy poprzedniego agenta.
Po zakończeniu pracy subagent przekazuje kontrolę do następnego agenta lub zwraca ją do orkiestratora. Kontekst konwersacji nadal gromadzi się w całym łańcuchu.
Wzorce podrzędne
W poniższej tabeli opisano typowe wzorce subagentów:
| Wzór | Przykładowi subagenci | Przypadek użycia |
|---|---|---|
| Ekspert w zakresie dziedziny | Ekspert maszyn wirtualnych, ekspert usługi AKS, ekspert ds. sieci | Głęboka wiedza na temat jednej technologii (wszystkie problemy z maszynami wirtualnymi, rozwiązywanie problemów z platformą Kubernetes, sieć wirtualna/sieciowa grupa zabezpieczeń/moduł równoważenia obciążenia) |
| Specjalista ds. zadań | Analizator dzienników, optymalizator kosztów, skaner zabezpieczeń | Skoncentrowane na określonych zadaniach (analizowanie dzienników, znajdowanie oszczędności, identyfikowanie luk w zabezpieczeniach) |
| Funkcja wykonawcza przepływu pracy | Klasyfikacja zdarzeń, moduł sprawdzania poprawności wdrożenia, weryfikator kopii zapasowych | Procedury wieloetapowe (klasyfikacja zdarzeń, sprawdzenia po wdrożeniu, testowanie integralności kopii zapasowej) |
Porównanie umiejętności, podagentów i plików wiedzy
W poniższej tabeli porównaliśmy każdą koncepcję rozszerzalności:
| Funkcja | Umiejętności | Subagenci | Pliki wiedzy |
|---|---|---|---|
| Uzyskaj dostęp | Automatycznie |
/agent polecenie |
Za pomocą narzędzia zapytań KB |
| Narzędzia | Może dołączyć | Ma narzędzia | Brak narzędzi |
| kontekst | Używa kontekstu wątku | Udostępnianie kontekstu wątku | Tylko do wglądu |
| Najlepsze dla | Procedures | Specjaliści ds. domen | Runbooki, dokumentacja |
Skorzystaj z poniższych wskazówek, aby wybrać odpowiednie podejście:
- Umiejętność: procedura dla całego zespołu z opcjonalnym wykonywaniem (przewodnik rozwiązywania problemów z usługą AKS i interfejs wiersza polecenia platformy Azure)
- pl-PL: Subagent: specjalista wywoływany na żądanie w ramach wyznaczonego zakresu (ekspert PostgreSQL)
- Plik wiedzy: dokumentacja referencyjna kontekstu (dokumentacja architektury)
Łączenie podagentów z wyzwalaczami
Zdarzenia lub zaplanowane zadania mogą automatycznie wyzwalać podagenty. Widok kanwy przedstawia te połączenia wizualnie: wyzwalacze są wyświetlane jako węzły połączone z podagentami, narzędzia są grupowane z ich nadrzędnym podagentem, a znaczki stanu pokazują stan aktywny lub nieaktywny.
Aby uzyskać szczegółowe informacje na temat konfiguracji, zobacz Reagowanie na zdarzenia dotyczące łączenia podagentów z incydentami lub Zaplanowane zadania na potrzeby automatyzacji cyklicznej.
Podstawowe tryby agenta
Każdy subagent może działać w innym trybie w zależności od poziomu autonomii, który chcesz przyznać.
| Tryb | Opis |
|---|---|
| Tylko do odczytu | Może wykonywać zapytania i analizować tylko bez akcji |
| Wykonaj przegląd | Proponuje akcje, czeka na zatwierdzenie |
| Autonomiczne | Działa bez ludzkiej zgody |
Ustaw tryb na podstawie poziomu ryzyka subagenta:
- Analiza dzienników? ReadOnly (najbezpieczniejsze)
- Rekomendacje dotyczące optymalizacji kosztów? Przegląd (wymagane jest zatwierdzenie przez człowieka)
- Dobrze przetestowana automatyzacja? Autonomiczne (w przypadku zaufanych operacji)
Testowanie i opracowywanie podagentów
Przetestuj subagentów na placu testowym przed wdrożeniem. Przejdź do konstruktora subagentów i wybierz Testowe środowisko z przełącznika widoku. Układ ekranu podzielonego umożliwia edytowanie instrukcji po lewej stronie i testowanie w rozmowie na żywo po prawej stronie przy użyciu oceny opartej na sztucznej inteligencji w celu oceny konfiguracji.
W przypadku użytkowników programu VS Code, rozszerzenie serwera MCP dla agenta SRE pozwala na edytowanie YAML podrzędnego agenta w edytorze, a zmiany są synchronizowane z Twoim agentem.
Aby uzyskać szczegółowe informacje, zobacz Plac zabaw dla agentów.