Samouczek: tworzenie umiejętności w agencie SRE platformy Azure

W tym samouczku utworzysz niestandardową umiejętność, która dodaje do agenta domenową wiedzę i playbooki zadań. Umiejętności to modułowe możliwości, które agent ładuje automatycznie, gdy jest to istotne, takie jak rozwiązywanie problemów z określoną usługą lub uruchamianie procedury diagnostycznej.

W tym poradniku nauczysz się, jak:

  • Tworzenie umiejętności w narzędziu do budowy subagentów
  • Pisanie instrukcji dotyczących umiejętności w SKILL.md
  • Dodawanie plików pomocniczych i narzędzi
  • Przetestuj umiejętności na czacie lub na placu zabaw
  • Edytowanie istniejącej umiejętności

Szacowany czas: 10 minut

Wskazówka

Umiejętności i dokumenty merytoryczne współpracują ze sobą. Umiejętność uczy agenta, jak coś zrobić (procedury, podręczniki, instrukcje krok po kroku). Dokument merytoryczny uczy agenta, co musi wiedzieć (dane referencyjne, dokumenty dotyczące architektury, elementy Runbook). Możesz również dołączyć dokumenty referencyjne bezpośrednio do umiejętności jako pliki pomocnicze. Dla procesu przesyłania wiedzy, zobacz Przesyłanie dokumentów wiedzy.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że masz następujące wymagania wstępne:

Otwórz konstruktora podrzędnego, w którym tworzysz umiejętności i zarządzasz nimi.

  1. Otwórz portal agenta SRE.
  2. Wybierz swój agent.
  3. Wybierz Builder w lewym menu nawigacyjnym.
  4. Wybierz pozycję Konstruktor podrzędny.

Rozpocznij tworzenie umiejętności

Rozpocznij proces tworzenia umiejętności na pasku narzędzi.

  1. Wybierz menu rozwijane Utwórz na pasku narzędzi.
  2. Wybierz Umiejętność.

Zostanie otwarte okno dialogowe tworzenia umiejętności z układem dwukolumnowym. Pola formularza po jednej stronie i edytor kodu po drugiej stronie, pokazujący SKILL.md.

Wprowadź nazwę i opis

Podaj nazwę i opis, który pomoże agentowi zdecydować, kiedy należy używać tej umiejętności.

Pole Przykładowa wartość
Nazwa high-cpu-troubleshooting
Opis "Procedura rozwiązywania problemów z alertami wysokiego użycia procesora CPU w aplikacjach kontenera. Sprawdza zależności nadrzędne, pulę połączeń i ostatnie wdrożenia".

Nazwa musi być unikatowa w ramach wszystkich twoich umiejętności. Opis zostanie wyświetlony na liście umiejętności i pomoże agentowi zdecydować, kiedy należy używać tej umiejętności.

Wskazówka

Wybierz pozycję Edytuj obok tekstu opisu, aby przełączyć się do trybu edycji. Po zakończeniu wybierz pozycję Zapisz.

Pisanie instrukcji dotyczących umiejętności

Edytor środkowy pokazuje element SKILL.md, który zawiera instrukcje dotyczące umiejętności. Plik rozpoczyna się od szablonu domyślnego.

---
name:
description:
---

<!-- Add your skill instructions here -->

Front matter YAML (name, description, tools) pozostaje zsynchronizowany z polami formularza po lewej stronie. Napisz instrukcje w języku Markdown poniżej pierwszej sprawy:

---
name: high-cpu-troubleshooting
description: Troubleshooting procedure for high CPU alerts on container apps
tools:
  - kusto_query
---

## When to use this skill
Use this skill when you receive a high CPU alert on any container app.

## Steps
1. Check upstream dependencies for cascading failures
2. Query connection pool metrics for the last hour
3. Review deployments in the last 24 hours
4. If a recent deployment correlates with CPU spike, identify the commit
5. Recommend rollback or fix based on findings

## Expected output
Structured report with: affected resource, root cause, recommended action, and evidence.

Dodawanie plików pomocniczych

W sekcji Pliki po jednej stronie jest wyświetlana przeglądarka plików. Poza wartością domyślną SKILL.mdmożna dodawać dane referencyjne, szablony i przykładowe zapytania.

  • Wybierz nową ikonę pliku , aby dodać pliki.
  • Wybierz ikonę nowego folderu , aby zorganizować pliki w katalogach.
  • Przeciągnij i upuść folder do obszaru przeciągania i upuszczania lub wybierz łącze Przekaż folder aby przekazać całą strukturę folderów.

Wybierz dowolny plik w przeglądarce, aby go edytować w edytorze kodu. Edytor obsługuje wyróżnianie składni dla Markdown, JSON, YAML, KQL, Python i skryptów powłoki.

Wybieranie narzędzi

Opcjonalnie, dołącz narzędzia, które umiejętność używa podczas wykonywania.

  1. Wybierz Narzędzia w sekcji Narzędzia.
  2. Przeglądaj lub wyszukaj narzędzia. Filtruj według typu (narzędzie niestandardowe, narzędzie MCP) lub wyszukaj według nazwy.
  3. Sprawdź narzędzia, których ta umiejętność wymaga (na przykład kusto_query lub azure_resource_health).
  4. Zamknij panel.

Wybrane narzędzia są wyświetlane jako wymienne pigułki. Te narzędzia są dynamicznie dostępne po aktywowaniu umiejętności.

Uwaga / Notatka

Narzędzia dodane do umiejętności są dynamicznie dostępne po aktywowaniu umiejętności. Aby uzyskać bardziej spójne zachowanie, skonfiguruj narzędzia bezpośrednio w podagentze.

Aby utworzyć narzędzia niestandardowe, zobacz Tworzenie narzędzia Kusto lub Tworzenie narzędzia języka Python. Aby uzyskać więcej informacji na temat narzędzi, zobacz Narzędzia.

Tworzenie umiejętności

Wybierz pozycję Utwórz , aby zapisać swoje umiejętności.

Twoje umiejętności są wyświetlane na karcie Umiejętności na konstruktorze podrzędnym. Agent może teraz używać umiejętności automatycznie, gdy napotka odpowiednią sytuację.

Testowanie umiejętności

Główny agent może domyślnie używać umiejętności, dzięki czemu można testować je bezpośrednio podczas czatu bez uprzedniego utworzenia subagentu.

Testowanie w nowym czacie

Użyj nowego wątku czatu, aby sprawdzić, czy agent aktywuje twoją umiejętność.

  1. Wybierz pozycję Nowy wątek czatu na pasku bocznym.
  2. Wpisz polecenie, które powinno wyzwolić umiejętność. "Widzimy wysokie użycie procesora w naszej aplikacji kontenerowej, czy możesz to sprawdzić?"
  3. Sprawdź, czy agent aktywuje umiejętności i postępuj zgodnie z zdefiniowanymi procedurami.

Testowanie na placu zabaw

Użyj placu zabaw, aby przetestować umiejętności za pośrednictwem subagentu.

  1. Utwórz podagent i przypisz do niego tę umiejętność.
  2. Na pasku narzędzi konstruktora podrzędnego wybierz przełącznik Widok testowego placu zabaw .
  3. Wybierz subagent, wpisz monit testowy i sprawdź, czy prawidłowo używa umiejętności.

Aby uzyskać więcej informacji, zobacz Plac zabaw agenta.

Edytuj umiejętność

Możesz zmodyfikować istniejącą umiejętność, aby zaktualizować jego instrukcje, narzędzia lub pliki pomocnicze.

  1. Na karcie Umiejętności wybierz nazwę umiejętności lub wybierz ją, a następnie wybierz pozycję Edytuj.

  2. Zostanie otwarte okno dialogowe edycji z wstępnie wypełnionymi wszystkimi bieżącymi wartościami. Zmień potrzebne pola:

    Co zmienić Gdzie zaktualizować
    Gdy agent go używa Opis i instrukcje SKILL.md
    Jakie procedury należy wykonać Zawartość SKILL.md w edytorze
    Dostępne narzędzia Narzędzia> Wybieranie narzędzi
    Dane referencyjne Pliki> dodawanie, edytowanie lub usuwanie plików

  3. Wybierz opcję Zapisz.

Porady dotyczące skutecznego opisywania umiejętności

Skorzystaj z poniższych wskazówek, aby tworzyć umiejętności, których agent może efektywnie używać.

  • Określ dokładnie, kiedy go używać. Agent odczytuje opis i instrukcje, aby zdecydować o istotności.
  • Uwzględnij procedury krok po kroku. Ponumerowane kroki dają agentowi jasny podręcznik.
  • Określ oczekiwane dane wyjściowe. Poinformuj agenta, w jakim formacie mają być wyniki.
  • Dodaj dane referencyjne. Przekaż szablony zapytań, bazowe konfiguracje lub znane prawidłowe wartości jako pliki pomocnicze.
  • Przypisz odpowiednie narzędzia. Jeśli umiejętności wymagają określonych narzędzi, takich jak zapytania Kusto lub akcje platformy Azure, dodaj je.

Następne kroki

Dowiedz się więcej o umiejętnościach

Treści powiązane

  • Last updated on