Agenci niestandardowi w agencie usługi Azure SRE

Agenci niestandardowi to wyspecjalizowani agenci wywoływani na żądanie. Wpisz /agent w czacie, wybierz swojego specjalistę i zadaj pytanie. Ten proces zapewnia dostęp do eksperta bazy danych w zakresie problemów z programem SQL i audytora zabezpieczeń na potrzeby badania zagrożeń.

W przeciwieństwie do umiejętności (które są zawsze dostępne), agenci niestandardowi wymagają jawnego wywołania. To wymaganie obejmuje ich wiedzę na temat określonych zadań.

Zrzut ekranu przedstawiający Agent Canvas z niestandardowymi agentami połączonymi z wyzwalaczami i narzędziami.

Jak działają agenci niestandardowi

Wywołaj w czacie agenta niestandardowego przy użyciu polecenia ukośnika /agent. Agent niestandardowy otrzymuje pełny kontekst konwersacji i współpracuje ze skoncentrowaną ekspertyzą.

W poniższym przykładzie przedstawiono podstawową definicję agenta niestandardowego:

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

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: Gdy używasz tej właściwości, agent niestandardowy może dynamicznie uzyskiwać dostęp do umiejętności.

Wskazówka

Umiejętności są automatyczne. Agent używa ich zawsze wtedy, gdy jest to istotne. Agenci specjalistyczni są jasno określeni — wywołujesz ich, użyciu /agent, kiedy potrzebujesz specjalistycznej wiedzy.

Dlaczego warto używać agentów niestandardowych

Agenci dostosowani umożliwiają pakowanie wiedzy domenowej, narzędzi i doświadczenia na potrzeby ponownego użycia. Zamiast tego, by główny agent próbował obsługiwać wszystko, deleguje zadania do specjalistów.

Rozważ problem z bazą danych: bez agentów niestandardowych główny agent próbuje rozwiązać ogólne problemy. Dzięki niestandardowemu agentowi "Database Expert" można uzyskać odpowiednią wiedzę SQL, runbooki specyficzne dla baz danych i narzędzia opracowane pod kątem analizy zapytań.

Agenci niestandardowi mogą również umożliwiać łańcuchy przekazywania. Twój agent niestandardowy klasyfikacji incydentu klasyfikuje problem, przekazuje go do odpowiedniego eksperta w dziedzinie, który bada i przekazuje do routera powiadomień. Każdy krok jest wyspecjalizowany.

Tworzenie agenta niestandardowego

Utwórz agentów niestandardowych w Builder Agent Canvas>.

  1. Przejdź do agenta usługi Azure SRE w witrynie Azure Portal.

  2. Wybierz zakładkę Kanwa agenta.

  3. Wybierz Utwórz.

  4. Wybierz Agenta niestandardowego.

  5. Podaj wartości następujących ustawień:

    Majątek Wartość
    Nazwa Wprowadź opisową nazwę agenta niestandardowego.
    Instrukcje Podaj jasne, niestandardowe instrukcje definiujące sposób działania agenta niestandardowego.
    Opis przekazywania Wyjaśnij scenariusze, w których inni agenci niestandardowi powinni przenieść przetwarzanie do tego agenta niestandardowego i dlaczego.
    Narzędzia niestandardowe (opcjonalnie) Wybierz jedno lub więcej narzędzi niestandardowych dla agenta niestandardowego, które mają być używane w trakcie jego działań.
    Wbudowane narzędzia (opcjonalnie) Wybierz wszystkie wbudowane narzędzia systemowe, do których ma mieć dostęp agent niestandardowy.
    Agenci przekazywania (opcjonalnie) Określ, który agent niestandardowy powinien przejąć przetwarzanie po zakończeniu zadań tego agenta niestandardowego.

    Opcjonalnie możesz włączyć funkcję bazy wiedzy . Ta opcja umożliwia przekazywanie plików, których agent niestandardowy może używać jako materiałów referencyjnych podczas odpowiadania na zapytania.

Zarządzanie bazą wiedzy

Zwiększ wiedzę agentów niestandardowych, przesyłając dokumentację, runbooki i instrukcje 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

  1. Uzyskaj dostęp do bazy wiedzy, przechodząc do karty Ustawienia > Pliki bazy > wiedzy .
  2. Przekaż pliki, przeciągając i upuszczając pliki lub przeglądając, aby wybrać pliki (maksymalnie 50 MB na plik).
  3. Organizowanie zawartości przez dodanie tagów i opisów w celu uzyskania lepszej możliwości wyszukiwania.
  4. Włącz dostęp do agenta niestandardowego, konfigurując, którzy agenci niestandardowi mogą uzyskiwać dostęp do określonych źródeł wiedzy.
  5. Monitoruj wykorzystanie, śledząc, jak agenci niestandardowi używają przesłanej wiedzy w swoich odpowiedziach.

Uwaga / Notatka

Agenty niestandardowe automatycznie indeksują i umożliwiają wyszukiwanie przesyłanych plików. System obsługuje do 1000 plików na instancję agenta niestandardowego.

Widoki kanwy agenta

Twórz niestandardowych agentów w Builder>Agent Canvas. Dostępne są następujące widoki:

Widok Purpose
Widok płótna Diagram wizualny przedstawiający niestandardowe agenty, narzędzia i połączenia wyzwalacza
Widok tabeli Lista wszystkich agentów niestandardowych z łatwym dostępem
Testowy plac zabaw Interakcyjne środowisko testowe

Kiedy używać agentów niestandardowych

Poniższa tabela ułatwia określenie, kiedy agenci niestandardowi są właściwym wyborem:

Scenario Czy używać agenta niestandardowego? 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ę agenta niestandardowego, zobacz Reagowanie na zdarzenia na potrzeby automatyzacji odpowiedzi.

Przekazywanie spersonalizowanego agenta

Gdy główny agent przekazuje rozmowę agentowi niestandardowemu, dzielą jeden kontekst konwersacji. Odbierający agent celny widzi:

  • Pełna historia konwersacji: wszystkie poprzednie wiadomości, wywołania narzędzi i wyniki.
  • Uzasadnienie podzadania: czego ten agent niestandardowy ma dokonać na żądanie.
  • Oryginalne pytanie użytkownika: zachowane w całym łańcuchu przekazywania.

Uwaga / Notatka

Agenci niestandardowi nie otrzymują "nowego początku". 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 agent niestandardowy przekazuje kontrolę do następnego agenta lub zwraca kontrolę orkiestratorowi. Kontekst konwersacji nadal gromadzi się w całym łańcuchu.

Niestandardowe wzorce agentów

W poniższej tabeli opisano typowe niestandardowe wzorce agentów:

Wzór Examples 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, agentów niestandardowych i plików wiedzy

W poniższej tabeli porównaliśmy każdą koncepcję rozszerzalności:

Funkcja Umiejętności Agenci dostosowani 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)
  • Dedykowany agent: specjalista do zadań określonych, wywoływany na żądanie (Ekspert PostgreSQL)
  • Plik wiedzy: dokumentacja referencyjna kontekstu (dokumentacja architektury)

Łączenie agentów niestandardowych z wyzwalaczami

Zdarzenia lub zaplanowane zadania mogą automatycznie wyzwalać agentów niestandardowych. Widok kanwy przedstawia te połączenia wizualnie: wyzwalacze są wyświetlane jako węzły połączone z agentami niestandardowymi, narzędzia są grupowane z nadrzędnym agentem niestandardowym, a znaczki stanu pokazują stan aktywny lub nieaktywny.

Aby uzyskać szczegółowe informacje na temat konfiguracji, zobacz Reagowanie na incydenty dotyczące łączenia agentów niestandardowych z incydentami lub Zaplanowane zadania na potrzeby cyklicznej automatyzacji.

Tryby niestandardowe agenta

Każdy agent niestandardowy działa w trybie, który kontroluje, ile ma autonomii. Ustaw tryb dla każdego planu odpowiedzi lub zaplanowanego zadania.

Tryb Opis
Wykonaj przegląd Proponuje akcje, czeka na zatwierdzenie
Autonomiczne Działa bez ludzkiej zgody

Wybierz tryb oparty na ryzyku:

  • Rekomendacje dotyczące optymalizacji kosztów? Użyj Przeglądu (wymagane jest zatwierdzenie przez człowieka).
  • Dobrze przetestowana automatyzacja? Użyj Autonomous do zaufanych operacji.

Skonfiguruj tryby dla każdego planu odpowiedzi lub zaplanowanego zadania. Nie ustawiaj trybów w definicji YAML agenta niestandardowego. Aby uzyskać więcej informacji, zobacz Tryby uruchamiania.

Testowanie i opracowywanie agentów niestandardowych

Przetestuj agentów niestandardowych na placu zabaw testowym przed wdrożeniem. Przejdź doobszaru Kanwa agenta konstruktora> i wybierz pozycję Test playground (Test playground) 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 agenta SRE umożliwia edytowanie niestandardowego agenta YAML w edytorze ze zmianami synchronizowanymi z agentem.

Zrzut ekranu przedstawiający plac zabaw agenta z edytorem podzielonym ekranem i panelem testowym czatu.

Aby uzyskać szczegółowe informacje, zobacz Plac zabaw dla agentów.

Resource Opis
Umiejętności Procedury i narzędzia wielokrotnego użytku dla agenta
Wysyłanie powiadomień Wysyłanie wyników badania do aplikacji Teams, Outlook i nie tylko
Czat z narzędzi Interakcja z agentem w aplikacji Teams, przez webhooks i nie tylko