Zarejestruj i odkryj umiejętności w inwentarzu interfejsów API

W tym artykule opisano sposób używania centrum interfejsu API platformy Azure do rejestrowania umiejętności agenta w ramach spisu interfejsu API. Umiejętności to możliwości wielokrotnego użytku, które agenci sztucznej inteligencji mogą odnajdywać i wykorzystywać w celu rozszerzenia ich funkcjonalności.

Rejestrując umiejętności w centrum interfejsu API, tworzysz scentralizowany rejestr, który pomaga organizacji:

• Odkrywanie dostępnych umiejętności i ich możliwości
• Uzyskiwanie dostępu do kodu źródłowego i dokumentacji umiejętności

Wymagania wstępne

• Centrum API. Jeśli nie masz jeszcze centrum interfejsu API, zobacz przewodnik Szybki start dotyczący tworzenia centrum interfejsu API.
• Jedne lub więcej umiejętności, które chcesz zarejestrować, zazwyczaj są hostowane w repozytorium kodu źródłowego, takim jak GitHub.

Zarejestruj umiejętność

Aby zarejestrować umiejętność w centrum API:

1. Zaloguj się do witryny Azure Portal i przejdź do centrum interfejsu API.

2. W menu paska bocznego w obszarze Spis wybierz pozycję Zasoby.

3. Wybierz + Zarejestruj zasób>Umiejętność.

   

4. W formularzu Rejestrowanie umiejętności podaj informacje w poniższej tabeli:

   Pole	Opis
   Nazwa	Wprowadź opisową nazwę umiejętności (na przykład Umiejętności przeglądu kodu).
   Identyfikator	Centrum interfejsów API automatycznie generuje identyfikator na podstawie tytułu (na przykład code-review-skill). W razie potrzeby możesz je edytować.
   Podsumowanie	Podaj krótki jednowierszowy opis tego, co robi umiejętność (na przykład Wykonuje zautomatyzowane przeglądy kodu przy użyciu analizy statycznej).
   Opis	Wprowadź bardziej szczegółowy opis możliwości, przypadków użycia i zachowania umiejętności.
   Etap cyklu życia	Wybierz bieżący etap cyklu życia umiejętności z menu rozwijanego.
   Źródło
   Źródłowy adres URL	Wprowadź adres URL repozytorium Git dla kodu źródłowego umiejętności (na przykład https://github.com/<org>/<repo>/tree/main/skills/<skill-name>).
   Zgodność	Opisz wymagania, zależności i wymagania wstępne dotyczące korzystania z umiejętności (na przykład wymagane oprogramowanie lub narzędzia, takie jak git, docker, języki programowania; wymagania systemowe; wymagania dotyczące dostępu do sieci; Klucze interfejsu API lub wymagania dotyczące uwierzytelniania).
   Dozwolone narzędzia	Wybierz pozycję + Dodaj narzędzie , aby określić interfejsy API lub serwery MCP ze spisu interfejsów API, do których ta umiejętność ma dostęp. Takie podejście pomaga zapewnić odpowiedni nadzór i zabezpieczenia, jawnie definiując zasoby, z których mogą korzystać umiejętności.
   Licencja	Wybierz pozycję + Dodaj , aby podać informacje o licencjonowaniu. Wprowadź nazwę licencji (na przykład MIT, Apache 2.0 lub Proprietarna), opcjonalnie podaj adres URL licencji i dodaj opis, jeśli jest to konieczne, aby wyjaśnić postanowienia licencyjne lub ograniczenia.
   Informacje o kontakcie	Wybierz pozycję + Dodaj , aby dodać punkty kontaktowe na potrzeby pomocy technicznej lub zapytań. Wprowadź nazwę kontaktu lub rolę (na przykład zespół interfejsu API lub John Smith), podaj dane kontaktowe, takie jak adres e-mail, i opcjonalnie dodaj opis, aby wyjaśnić, kiedy i dlaczego skontaktować się z tą osobą lub zespołem.

5. Wybierz Utwórz, aby zarejestrować umiejętność w swoim centrum API.

Po rejestracji umiejętność pojawi się w Twoim spisie na stronie Spis>Zasoby.

Aktualizowanie zarejestrowanej umiejętności

Informacje o umiejętnościach można aktualizować w dowolnym momencie:

1. W centrum interfejsu API przejdź do Inwentarz>Zasoby.
2. Znajdź i wybierz umiejętności, które chcesz zaktualizować.
3. Wybierz pozycję Edytuj , aby zmodyfikować właściwości umiejętności.
4. Wprowadź zmiany i wybierz pozycję Zapisz.

Synchronizowanie umiejętności z repozytorium Git

Aby zautomatyzować rejestrację umiejętności i zapewnić aktualność spisu, możesz zintegrować repozytorium Git z centrum interfejsu API. Aby uzyskać więcej informacji, zobacz Synchronizowanie zasobów interfejsu API z repozytorium Git.

Odkrywanie funkcjonalności w portalu Centrum API

Skonfiguruj portal Centrum interfejsów API , aby deweloperzy i inni uczestnicy projektu w organizacji mogli odkrywać umiejętności w spisie interfejsów API. W portalu Centrum interfejsów API użytkownicy mogą wykonywać następujące czynności:

• Przeglądaj i filtruj umiejętności w spisie.
• Wyświetl szczegółowe informacje o każdej umiejętności.

Ocena zasobów sztucznej inteligencji

Centrum interfejsów API może ocenić jakość zasobów sztucznej inteligencji, takich jak umiejętności i agenci zarejestrowani w centrum interfejsu API. Centrum interfejsu API zawiera gotowe do użycia domyślne kryteria oceny, oceniając zasoby we wstępnie zdefiniowanych wymiarach. Administratorzy platformy przedsiębiorstwa mogą dodatkowo rozszerzyć te ustawienia domyślne, definiując niestandardowe kryteria oceny dostosowane do określonych standardów organizacji, wymagań dotyczących zgodności i zasad ładu.

Aby włączyć zautomatyzowane oceny zasobów AI w swoim spisie:

1. W portalu Azure przejdź do centrum API.

2. W menu paska bocznego. przejdź do Ład>Ocena AI.

3. Wybierz kartę Umiejętności , aby skonfigurować oceny umiejętności, lub wybierz kartę Agenci , aby skonfigurować oceny dla agentów.

4. W obszarze Stan oceny wybierz pozycję Włączone.

5. Wprowadź opis do oceny.

6. W obszarze Kryteria oceny wykonaj jedną z następujących czynności:

   • Zaakceptuj kryteria domyślne podane przez centrum interfejsów API. Opcjonalnie usuń kryteria domyślne, które nie są istotne dla twojej organizacji.

   Poniższy zrzut ekranu przedstawia domyślne kryteria umiejętności:

   

   • Dodaj jedno lub więcej kryteriów niestandardowych.
     1. Wybierz + Dodaj kryteria.
     2. Wprowadź nazwę i opcjonalną instrukcję oceny dla kryterium.
     3. Wprowadź wartości Ocena minimalna i Ocena maksymalna dla oceny (na przykład 1 i 5).
     4. Wprowadź wartość progu zaliczenia (na przykład 3), która wskazuje minimalny akceptowalny wynik dla kryterium.
     5. Wprowadź wartość Wagi, która wskazuje na wkład kryterium w ogólną ocenę (na przykład, waga 0,3 mnoży wynik przez 0,3, co stanowi 30% ogólnej oceny).
     6. Powtórz powyższe kroki, aby w razie potrzeby dodać więcej kryteriów.

7. Wybierz opcję Zapisz.

Następnie możesz wyświetlić wyniki oceny w portalu Centrum interfejsu API. Na przykład wyświetl wyniki oceny dla każdej umiejętności na stronie szczegółów umiejętności.

Treści powiązane

• Synchronizowanie zasobów interfejsu API z repozytorium Git
• Zarejestruj i odkrywaj serwery MCP oraz wtyczki w spisie interfejsów API.
• Konfigurowanie portalu centrum interfejsów API
• Kluczowe pojęcia w Centrum interfejsu API platformy Azure