Samouczek: tworzenie podrzędnego agenta w usłudze Azure SRE Agent

W tym samouczku utworzysz wyspecjalizowanego podagenta w konstruktorze podagentów z własnymi instrukcjami, narzędziami i umiejętnościami. Podagenty obsługują ukierunkowane zadania, takie jak raportowanie kondycji, klasyfikacja alertów lub dostarczanie powiadomień. Aby uzyskać więcej informacji o działaniu podagentów, zobacz Subagents.

Szacowany czas: 5 minut

W tym poradniku nauczysz się, jak:

  • Stwórz podagent z adaptowanymi instrukcjami w kreatorze podagentów
  • Przypisywanie umiejętności, narzędzi i punktów zaczepienia do podagentu
  • Testuj subagenta w oknie dialogowym i środowisku testowym
  • Edytuj i zarządzaj konfiguracją subagenta przy użyciu formularza lub pliku YAML

Wymagania wstępne

  • Agent utworzony w portalu agenta usługi Azure SRE.
  • Co najmniej jeden łącznik jest skonfigurowany, jeśli chcesz, aby subagent używał narzędzi zewnętrznych.

Tworzenie podagentu

Wykonaj następujące kroki, aby utworzyć nowy subagent z poziomu portalu.

  1. Otwórz portal agenta SRE i wybierz agenta.

  2. Wybierz pozycję Konstruktor>Konstruktor agenta podrzędnego.

  3. Wybierz listę rozwijaną Utwórz na pasku narzędzi, a następnie wybierz pozycję Agent niestandardowy.

    Zostanie otwarte okno dialogowe tworzenia z dwiema kartami: Formularz i YAML.

  4. Wypełnij wymagane pola:

    Pole Przykładowa wartość
    Nazwa agenta spersonalizowanego (wymagana) health-check-reporter
    Instrukcje (wymagane) "Jesteś reporterem kontroli kondycji. Sprawdź kondycję zasobów platformy Azure dla aplikacji kontenerów w produkcyjnej grupie zasobów. Podsumuj zdrowe, ostrzeżenia i krytyczne liczby. Wyślij podsumowanie pocztą e-mail".

    Wskazówka

    Wybierz pozycję Uściślij za pomocą sztucznej inteligencji powyżej pola instrukcji, aby umożliwić agentowi automatyczne ulepszanie instrukcji. Wybierz pozycję Wyświetl sugestie dotyczące sztucznej inteligencji , aby wyświetlić zalecenia dotyczące ulepszania instrukcji, narzędzi i umiejętności.

  5. (Opcjonalnie) Skonfiguruj pozostałe sekcje w oknie dialogowym. Jeśli pominiesz te sekcje, subagent dziedziczy domyślnie wszystkie globalne umiejętności i narzędzia.

    • Umiejętności: wybierz pozycję Wybierz umiejętności , aby przypisać określone umiejętności do subagentu. Wybranie określonych umiejętności zastępuje wartości domyślne globalne. Pozostaw zaznaczenie puste, aby zezwolić na wszystkie umiejętności globalne. Aby uzyskać więcej informacji, zobacz Umiejętności.

    • Narzędzia: wybierz pozycję Wybierz narzędzia , aby otworzyć panel selektora narzędzi. Przeglądaj lub wyszukuj narzędzia uporządkowane według kategorii (na przykład narzędzia Kusto lub narzędzia powiadomień). Wybierz narzędzia, które mają być używane przez subagent. Aby najpierw utworzyć niestandardowe narzędzia, zobacz Tworzenie narzędzia Kusto lub Tworzenie narzędzia języka Python. Aby uzyskać więcej informacji, zobacz Narzędzia.

    • Haki: wybierz Zarządzaj hakami, aby dodać mechanizmy kontroli bezpieczeństwa i ładu. Hooki są uruchamiane przed akcjami (zaczepy wyzwalające) lub po użyciu narzędzia (zaczepy poleceń). Aby uzyskać instrukcje konfiguracji, zobacz Tworzenie punktów zaczepienia i zarządzanie nimi w portalu. Aby uzyskać więcej informacji, zobacz Hooki agenta.

  6. Wybierz Utwórz.

Twój podagent jest wyświetlany jako węzeł na płótnie konstruktora podagentów, z wyświetlonymi wszystkimi połączonymi narzędziami.

Wskazówka

Przed przypisaniem narzędzi przetestuj je indywidualnie w przestrzeni testowej, aby upewnić się, że zwracają oczekiwane dane.

Testowanie podagentu

Po utworzeniu subagentu przetestuj go, aby sprawdzić, czy działa zgodnie z oczekiwaniami.

Testowanie w oknie dialogowym

W oknie dialogowym „Utwórz lub edytuj” wybierz ikonę testu w prawym górnym rogu, aby otworzyć panel Test live agent. Wpisz monit i zobacz, jak subagent odpowiada za pomocą bieżących instrukcji i narzędzi.

Testowanie na placu zabaw

Skorzystaj z placu zabaw, aby uzyskać interaktywne środowisko testowania z układem ekranu podzielonego.

  1. Na pasku narzędzi konstruktora podrzędnego wybierz przełącznik Widok testowego placu zabaw .
  2. Układ dzielonego ekranu pokazuje konfigurację subagenta po jednej stronie i czat na żywo po drugiej.
  3. Wybierz podagent, wpisz monit testowy i sprawdź, czy działa zgodnie z oczekiwaniami.
  4. Iteruj, edytując instrukcje lub zamieniając narzędzia, a następnie przetestuj ponownie, aż dane wyjściowe będą zgodne z oczekiwaniami.

Aby uzyskać więcej informacji, zobacz Plac zabaw dla agentów lub Testowanie narzędzia na placu zabaw.

Edytowanie podagentu

Aby zmodyfikować istniejący subagent, otwórz jego konfigurację na kanwie konstruktora podrzędnego.

Wybierz węzeł podrzędny, a następnie wybierz pozycję Edytuj (lub kliknij dwukrotnie węzeł). Zostanie otwarte okno dialogowe edycji z wstępnie wypełnionymi wszystkimi bieżącymi wartościami.

Co zmienić Pole do zaktualizowania
Do czego służy Instrukcje
Jakich umiejętności używa Umiejętności> Wybieranie umiejętności
Jakich narzędzi używa Narzędzia> Wybieranie narzędzi
Mechanizmy kontroli bezpieczeństwa Haki> Zarządzanie punktami zaczepienia

Po zakończeniu wybierz pozycję Zapisz.

Edytowanie za pomocą języka YAML

Konfigurację subagenta można wyświetlić lub edytować jako kod YAML na potrzeby kopiowania konfiguracji lub zarządzania konfiguracją jako kodem.

Wybierz kartę YAML w górnej części okna dialogowego tworzenia lub edytowania, aby przełączyć się do trybu YAML. Zmiany w trybie YAML są synchronizowane z powrotem do widoku formularza.

Następne kroki