Udostępnij przez

Importowanie interfejsu API agenta A2A (wersja zapoznawcza)

DOTYCZY: Podstawowa wersja 2 | Standardowa, wersja 2 | Premium, wersja 2

Usługa API Management obsługuje zarządzanie interfejsami API agenta sztucznej inteligencji zgodnymi ze specyfikacją protokołu Agent2Agent (A2A). Protokół A2A to otwarty standard client-server, który umożliwia różnym systemom agentów sztucznej inteligencji komunikowanie się i współpracę, korzystając ze wspólnego modelu interakcji. Dzięki obsłudze interfejsu API agenta A2A w usłudze API Management można zarządzać interfejsami API agentów i zarządzać nimi wraz z innymi typami interfejsów API, w tym interfejsami API modelu sztucznej inteligencji, narzędziami protokołu MCP i tradycyjnymi interfejsami API, takimi jak REST, SOAP i GraphQL.

Uwaga / Notatka

Ta funkcja jest dostępna w wersji zapoznawczej i ma pewne ograniczenia.

Dowiedz się więcej o zarządzaniu interfejsami API sztucznej inteligencji w usłudze API Management:

Kluczowe możliwości

Podczas importowania interfejsu API agenta A2A usługa API Management zapewnia następujące możliwości:

  • Pośredniczy w operacjach środowiska wykonawczego JSON-RPC do zaplecza A2A.
    • Umożliwia ład i kontrolę ruchu przy użyciu zasad.
    • W przypadku włączenia możliwości obserwowania za pomocą usługi Application Insights dodaje następujące atrybuty specyficzne dla usługi A2A w celu zachowania zgodności z konwencją semantyczną OpenTelemetry GenAI:
      • genai.agent.id - Ustaw na identyfikator agenta skonfigurowany w ustawieniach interfejsu API
      • genai.agent.name- Ustaw na nazwę interfejsu API w ustawieniach interfejsu API
  • Uwidacznia kartę agenta przy użyciu następujących przekształceń:
    • Zastępuje nazwę hosta nazwą hosta wystąpienia usługi API Management.
    • Ustawia preferowany protokół transportu na JSON-RPC.
    • Usuwa wszystkie inne interfejsy w pliku additionalInterfaces.
    • Ponownie zapisuje wymagania dotyczące zabezpieczeń, aby uwzględnić wymaganie dotyczące klucza subskrypcji usługi API Management.

Wymagania wstępne

Importowanie interfejsu API agenta A2A przy użyciu portalu

Wykonaj poniższe kroki, aby zaimportować interfejs API agenta A2A do usługi API Management.

  1. W portalu Azure przejdź do wystąpienia usługi API Management.

  2. W menu po lewej stronie, w obszarze APIs, wybierz APIs>+ Dodaj API.

  3. Wybierz płytkę Agent A2A.

    Zrzut ekranu przedstawiający wybieranie kafelka interfejsu API agenta A2A w portalu.

  4. W obszarze Karta agenta wprowadź adres URL wskazujący dokument JSON karty agenta. Wybierz Dalej.

  5. Na stronie Tworzenie interfejsu API agenta A2A skonfiguruj ustawienia interfejsu API.

    1. Jeśli adres URL środowiska uruchomieniowego i identyfikator agenta nie są automatycznie konfigurowane na podstawie karty agenta, musisz podać adres URL środowiska uruchomieniowego dla operacji JSON-RPC dla twojego agenta oraz identyfikator agenta używany w śladach OpenTelemetry emitowanych przez agenta (gen_ai.agent.id atrybut).
    2. W obszarze Ogólne ustawienia interfejsu API wprowadź wybraną nazwę wyświetlaną w instancji zarządzania API, opcjonalnie wprowadź opis.
    3. W obszarze Adres URL, wprowadź ścieżkę bazową używaną przez wystąpienie usługi API Management do uzyskiwania dostępu do interfejsu API agenta A2A. Usługa API Management wyświetla podstawowy adres URL , którego klienci mogą używać do uzyskiwania dostępu do interfejsu API JSON-RPC, oraz adresu URL karty agenta w celu uzyskania dostępu do karty agenta za pośrednictwem usługi API Management.

  6. Wybierz pozycję Utwórz , aby utworzyć interfejs API.

Zrzut ekranu przedstawiający tworzenie interfejsu API zgodnego z agentem A2A w portalu.

Konfigurowanie zasad dla interfejsu API agenta A2A

Skonfiguruj co najmniej jedną politykę API Management, aby ułatwić zarządzanie interfejsem API agenta A2A.

Aby skonfigurować zasady dla interfejsu API agenta A2A:

  1. W portalu Azure przejdź do wystąpienia usługi API Management.
  2. W menu po lewej stronie w obszarze Interfejsy API wybierz interfejs API agenta A2A.
  3. W menu po lewej stronie w obszarze A2A wybierz pozycję Zasady.
  4. W edytorze zasad dodaj lub edytuj zasady, które chcesz zastosować do interfejsu API agenta A2A. Zasady są definiowane w formacie XML.

Uwaga / Notatka

Usługa API Management ocenia zasady skonfigurowane w zakresie globalnym (dotyczącym wszystkich interfejsów API) przed zasadami dotyczącymi interfejsu API agenta A2A.

Konfigurowanie uwierzytelniania klucza subskrypcji

W ustawieniach interfejsu API A2A można opcjonalnie skonfigurować uwierzytelnianie klucza subskrypcji za pomocą usługi API Management. Dowiedz się więcej o uwierzytelnianiu klucza subskrypcji.

  1. Wybierz interfejs API utworzony w poprzednim kroku.
  2. Na stronie Ustawienia w obszarze Subskrypcja wybierz pozycję (włącz) Wymagana subskrypcja.

W przypadku włączenia uwierzytelniania kluczem subskrypcji klienci muszą dołączyć prawidłowy klucz subskrypcji w nagłówku Ocp-Apim-Subscription-Key lub w parametrze zapytania subscription-key, gdy wywołują API agenta A2A lub uzyskują dostęp do karty agenta.

Testowanie interfejsu API agenta A2A

Aby upewnić się, że interfejs API agenta A2A działa zgodnie z oczekiwaniami, wywołaj zaplecze za pośrednictwem usługi API Management:

  1. Wybierz interfejs API utworzony w poprzednim kroku.
  2. Na stronie Przegląd skopiuj podstawowy adres URL środowiska uruchomieniowego. Użyj tego adresu URL, aby wywołać interfejs API agenta A2A za pomocą usługi API Management.
  3. Skonfiguruj klienta testowego lub użyj narzędzia, takiego jak curl , aby wysłać POST żądanie do agenta. Jeśli uwierzytelnianie klucza subskrypcji jest włączone, dołącz prawidłowy nagłówek klucza subskrypcji lub parametr zapytania w żądaniu.

Wskazówka

Podobnie uzyskaj dostęp do karty agenta za pośrednictwem usługi API Management, wysyłając GET żądanie do adresu URL karty agenta wyświetlanego na stronie Przegląd interfejsu API agenta usługi A2A.

Ograniczenia

  • Ta funkcja jest obecnie dostępna tylko w wystąpieniach usługi API Management w warstwach v2.
  • Obsługiwane są tylko interfejsy API agenta A2A oparte na formacie JSON-RPC.
  • Deserializacja wychodzących treści odpowiedzi nie jest obsługiwana.

Treści powiązane

  • Last updated on