Udostępnij za pośrednictwem

Rozszerzanie kodu Genie przy użyciu umiejętności agenta

Twórz umiejętności, aby rozszerzyć kod Genie w trybie agenta z wyspecjalizowanymi możliwościami dla zadań specyficznych dla domeny. Na tej stronie wyjaśniono, jak tworzyć i optymalizować umiejętności.

Co to są umiejętności?

Tworzenie umiejętności w celu rozszerzenia kodu Genie za pomocą wyspecjalizowanych możliwości. Umiejętności są zgodne z otwartym standardem umiejętności agenta. Zestaw umiejętności obejmuje wiedzę i procesy biznesowe specyficzne dla domeny, które Genie Code może ładować w razie potrzeby wykonywania określonych zadań. Umiejętności mogą obejmować wskazówki, najlepsze rozwiązania, kod wielokrotnego użytku i skrypty wykonywalne.

Umiejętności powinny być dostosowane do zadań specyficznych dla domeny. Dzięki umiejętnościom możesz zapewnić większy kontekst (na przykład skrypty, przykłady i inne zasoby) dla zadania, niż w przypadku instrukcji. W przeciwieństwie do niestandardowych instrukcji, które są stosowane globalnie, umiejętności są ładowane automatycznie i tylko w odpowiednim kontekście. W trybie Agenta, Genie Code automatycznie ładuje umiejętności, jeśli jest to uzasadnione, na podstawie Twojego żądania i opisu umiejętności. Możesz również ręcznie wywoływać umiejętności, @ wymieniając je. Zapewnia to efektywne okno kontekstowe i zmniejsza potrzebę zapewnienia tego samego kontekstu w wielu czatach.

Uwaga / Notatka

Umiejętności są obsługiwane tylko w trybie agenta kodu Genie.

Tworzenie umiejętności

Umiejętności znajdują się w katalogu /Users/{username}/.assistant/skills/. Każda umiejętność musi mieć własny folder, a w tym folderze plik SKILL.md.

Aby utworzyć nową umiejętność:

  1. W folderze obszaru roboczego użytkownika utwórz nowy folder umiejętności. Ścieżka folderu powinna być następująca: /Users/{username}/.assistant/skills/.

    Po utworzeniu możesz szybko uzyskać dostęp do tego folderu w panelu Genie Code. Kliknij ikonę koła zębatego. Ustawienia, a następnie kliknij przycisk Strzałka w ikonie. Otwórz folder umiejętności.

  2. Utwórz dedykowany folder dla umiejętności w folderze umiejętności. Każda umiejętność musi mieć własny folder. Jeśli na przykład tworzysz umiejętności dotyczące osobistych przepływów pracy, struktura folderów może być:

    /Users/{username}/.assistant/skills/
└── personal-workflows/
    └── SKILL.md

  3. W folderze umiejętności utwórz plik SKILL.md. Ten plik jest wymagany i definiuje umiejętności. Umiejętności są zgodne ze specyfikacjami umiejętności agenta.

  4. Dodaj wymagany frontmatter dla swojej umiejętności.

    ---
name: skill-name
description: A description of what this skill does and when to use it.
---

  5. Dodaj instrukcje umiejętności w formacie Markdown po metadanych. Zalecane jest uwzględnienie następujących sekcji:

    • Instrukcje krok po kroku: Jasne wskazówki proceduralne
    • Przykłady: przykładowe dane wejściowe i oczekiwane dane wyjściowe
    • Przypadki brzegowe: typowe odmiany i wyjątki

  6. (Opcjonalnie) Aby uzyskać bardziej złożone umiejętności, możesz podać dodatkowe zasoby i je odwoływać:

    • Skrypty zawierające kod wykonywalny, który agent może uruchomić.
    • Pliki zawierające dodatkową dokumentację do celów referencyjnych, takie jak najlepsze praktyki i szablony.

    Podczas odwoływania się do innych plików użyj ścieżek względnych z poziomu umiejętności głównej.

    Na przykład, możesz mieć osobistą kompetencję w zakresie przepływu pracy, która odwołuje się do najlepszych praktyk ETL, szablonów panelek kontrolnych oraz skryptów do konfiguracji i wdrażania rurociągu danych. Folder umiejętności może zawierać następujące pliki:

    /Users/{username}/.assistant/skills/
├── personal-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── etl-patterns.md         # Personal ETL best practices
   ├── dashboard-templates.md   # Reusable dashboard patterns
   └── scripts/
         ├── pipeline-setup.sh   # Environment setup scripts
         └── model-deploy.py     # Model deployment automation

Genie Code automatycznie odczytuje twoje umiejętności przy następnym użyciu w trybie agenta. Możesz również @ wspomnieć o umiejętnościach, aby upewnić się, że kod Genie używa ich.

Najlepsze rozwiązania

Postępuj zgodnie z poniższymi wytycznymi, aby napisać o skutecznych umiejętnościach:

  • Zachowaj skupienie się na umiejętnościach. Umiejętności działają najlepiej, gdy koncentrują się na jednym zadaniu lub przepływie pracy. Wąski zakres sprawia, że Genie Code łatwiej rozpoznaje zastosowanie umiejętności.
  • Użyj jasnych nazw i opisów. Zwięzła, opisowa nazwa i podsumowanie pomagają Genie Code dopasować odpowiednią umiejętność do odpowiedniego żądania.
  • Być jednoznacznym i opierać się na przykładach. Opisz przepływy pracy krok po kroku i dołącz konkretne przykłady lub wzorce, które Kod Genie może ponownie wykorzystać.
  • Unikaj niepotrzebnego kontekstu. Uwzględnij tylko informacje wymagane dla zadania. Dodatkowe szczegóły mogą utrudnić niezawodne stosowanie umiejętności.
  • Iterowanie w czasie. Traktuj umiejętności jako żywe przepływy pracy. Małe aktualizacje oparte na rzeczywistym użyciu mogą znacznie poprawić wyniki.
  • Oddziel wskazówki od automatyzacji. Użyj języka Markdown, aby wyjaśnić intencję i najlepsze rozwiązania oraz skrypty dla powtarzalnych akcji. Utrzymanie tych problemów odrębnych sprawia, że umiejętności są łatwiejsze do utrzymania i ponownego użycia.

Zobacz także

  • Last updated on