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.
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ń.
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>.
Przejdź do agenta usługi Azure SRE w witrynie Azure Portal.
Wybierz zakładkę Kanwa agenta.
Wybierz Utwórz.
Wybierz Agenta niestandardowego.
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
- 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 do agenta niestandardowego, konfigurując, którzy agenci niestandardowi mogą uzyskiwać dostęp do określonych źródeł wiedzy.
- 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.
Aby uzyskać szczegółowe informacje, zobacz Plac zabaw dla agentów.
Treści powiązane
| 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 |