Rejestrowanie agentów i zarządzanie nimi w Centrum interfejsu API platformy Azure

W tym artykule pokazano, jak zarejestrować agentów sztucznej inteligencji, w tym agentów A2A, w Centrum interfejsu API, umożliwić ich odnajdywanie oraz aktualizowanie i zarządzanie nimi.

Wymagania wstępne

• Wystąpienie Azure API Center
• Agent opisany przez kartę agenta w formacie JSON lub definicji agenta w formacie Markdown
• Odpowiednie uprawnienia do edytowania interfejsów API w Centrum API

Rejestrowanie agenta

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

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

3. Wybierz + Zarejestruj zasób>Agent.

   

4. W formularzu Rejestrowanie agenta wprowadź informacje opisane w poniższej tabeli:

   (No changes needed)	Description
   Tytuł	Wprowadź opisową nazwę agenta, na przykład Agent pomocy technicznej.
   Identyfikator	Centrum interfejsów API automatycznie generuje identyfikator na podstawie tytułu, takiego jak help-desk-agent. W razie potrzeby możesz edytować ten identyfikator.
   Krótkie podsumowanie	Wprowadź krótki opis w jednym wierszu tego, co robi agent i który pojawia się w portalu API Center oraz w innych miejscach.
   Opis	Opcjonalnie wprowadź bardziej szczegółowy opis możliwości, przypadków użycia i zachowania umiejętności.
   Wersja
   Tytuł wersji	Wprowadź wybrany tytuł wersji, taki jak wersja 1.
   Identyfikacja wersji	Centrum interfejsu API automatycznie generuje identyfikator na podstawie tytułu wersji. W razie potrzeby możesz edytować ten identyfikator.
   Cykl życia wersji	Wybierz bieżący etap cyklu życia wersji agenta z menu rozwijanego. Dowiedz się więcej o wersjach w Centrum API.
   Szczegóły agenta
   Definicja agenta	Wprowadź adres URL lub wybierz plik , aby przekazać definicję agenta. Definicja agenta powinna być w formacie Markdown i zawierać szczegółowe informacje o możliwościach, umiejętnościach i innych odpowiednich informacjach agenta.
   Protocol	Jeśli ma to zastosowanie, wybierz protokół A2A , jeśli agent jest z nim zgodny.
   Karta agenta	Opcjonalnie wprowadź adres URL lub Wybierz plik, aby przekazać kartę agenta A2A w formacie JSON.

   

5. Wybierz pozycję Utwórz , aby dodać agenta.

Po zarejestrowaniu agent pojawi się w inwentarzu na stronie Inwentarz>Zasoby.

Aktualizowanie zarejestrowanego agenta

Informacje o agencie można aktualizować w dowolnym momencie.

1. W portalu Azure przejdź do centrum API.
2. W menu paska bocznego w obszarze Spis wybierz pozycję Zasoby.
3. W tabeli wybierz nazwę agenta w kolumnie Tytuł .
4. Wybierz przycisk Edytuj , aby otworzyć stronę Edytuj w okienku roboczym.
5. Wprowadź zmiany i wybierz pozycję Zapisz.

Synchronizowanie agentów ze źródeł interfejsu API

Aby zautomatyzować rejestrację agenta i zapewnić aktualność spisu, możesz zintegrować następujące źródła nadrzędne z centrum interfejsu API:

• Azure API Management: Jeśli zarządzasz agentami A2A w Azure API Management, możesz włączyć automatyczną synchronizację, aby zapewnić aktualność centrum interfejsu API. Aby dowiedzieć się więcej, zobacz Synchronizowanie interfejsów API z instancji usługi Azure API Management.

• Repozytorium Git: w przypadku agentów A2A i innych zasobów sztucznej inteligencji przechowywanych w repozytorium Git możesz włączyć automatyczną synchronizację, aby zapewnić aktualność centrum interfejsu API. Aby uzyskać więcej informacji, zobacz Synchronizowanie zasobów interfejsu API z repozytorium Git.

Odkrywanie agentów w portalu API Center

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

• Przeglądaj i filtruj agentów w spisie.
• Wyświetl szczegółowe informacje o każdym agencie.

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 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 w twoim katalogu API
• Konfigurowanie portalu centrum interfejsów API
• Kluczowe pojęcia w Centrum interfejsu API platformy Azure