Bagikan melalui

Mengimpor API agen A2A (pratinjau)

BERLAKU UNTUK: Dasar v2 | Standar v2 | Premium v2

API Management mendukung pengelolaan API agen AI yang kompatibel dengan spesifikasi protokol Agent2Agent (A2A). Protokol A2A adalah standar server klien terbuka yang memungkinkan sistem agen AI yang berbeda untuk berkomunikasi dan bekerja sama menggunakan model interaksi bersama. Dengan dukungan API agen A2A di API Management, Anda dapat mengelola dan mengatur API agen bersama jenis API lainnya, termasuk API model AI, alat Protokol Konteks Model (MCP), dan API tradisional seperti REST, SOAP, dan GraphQL.

Nota

Fitur ini dalam pratinjau dan memiliki beberapa batasan.

Pelajari lebih lanjut tentang mengelola API AI di Manajemen API.

Kemampuan utama

Saat Anda mengimpor API agen A2A, API Management menyediakan kemampuan berikut:

  • Memediasi operasi runtime JSON-RPC ke backend A2A.
    • Memungkinkan tata kelola dan kontrol lalu lintas menggunakan kebijakan.
    • Saat pengamatan melalui Application Insights diaktifkan, tambahkan atribut khusus A2A berikut untuk mematuhi konvensi semantik OpenTelemetry GenAI:
      • genai.agent.id - Atur ke ID agen yang dikonfigurasi dalam pengaturan API
      • genai.agent.name- Atur ke nama API di pengaturan API
  • Mengekspos kartu agen dengan transformasi berikut:
    • Mengganti nama host dengan nama host dari instans API Management.
    • Mengatur protokol transportasi pilihan ke JSON-RPC.
    • Menghapus semua antarmuka lain di additionalInterfaces.
    • Menulis ulang persyaratan keamanan untuk menyertakan persyaratan kunci langganan API Management.

Prasyarat

Mengimpor API agen A2A menggunakan portal

Gunakan langkah-langkah berikut untuk mengimpor API agen A2A ke API Management.

  1. Di portal Microsoft Azure, buka instans API Management Anda.

  2. Pada menu sebelah kiri, di bawah API, pilih API>+ Tambah API.

  3. Pilih ubin A2A Agent.

    Cuplikan layar memilih petak peta API agen A2A di portal.

  4. Di bawah Kartu agen, masukkan URL yang menunjuk ke kartu agen dokumen JSON. Pilih Selanjutnya.

  5. Pada halaman Buat API agen A2A , konfigurasikan pengaturan API.

    1. Jika URL Runtime dan ID Agen tidak dikonfigurasi secara otomatis berdasarkan kartu agen, berikan URL runtime dari operasi JSON-RPC kepada agen Anda dan ID agen yang digunakan dalam jejak OpenTelemetry yang dipancarkan oleh agen pada atribut gen_ai.agent.id.
    2. Di bawah Pengaturan API Umum, masukkan Nama tampilan pilihan Anda di instans API Management, dan secara opsional masukkan Deskripsi.
    3. Di bawah URL, masukkan jalur Dasar yang digunakan instans API Management Anda untuk mengakses API agen A2A. API Management menampilkan URL Dasar yang dapat digunakan klien untuk mengakses API JSON-RPC, dan URL kartu Agen untuk mengakses kartu agen melalui API Management.

  6. Pilih Buat untuk membuat API.

Cuplikan layar pembuatan API yang kompatibel dengan agen A2A di portal.

Mengonfigurasi kebijakan untuk API agen A2A

Konfigurasikan satu atau beberapa kebijakan API Management untuk membantu mengelola API agen A2A.

Untuk mengonfigurasi kebijakan untuk API agen A2A Anda:

  1. Di portal Microsoft Azure, buka instans API Management Anda.
  2. Di menu sebelah kiri, di bawah API, pilih API agen A2A Anda.
  3. Di menu sebelah kiri, di bawah A2A, pilih Kebijakan.
  4. Di editor kebijakan, tambahkan atau edit kebijakan yang ingin Anda terapkan ke API agen A2A. Kebijakan ditentukan dalam format XML.

Nota

API Management mengevaluasi kebijakan yang dikonfigurasi pada cakupan global (semua API) sebelum kebijakan di cakupan API agen A2A.

Mengonfigurasi autentikasi kunci langganan

Dalam pengaturan API A2A, Anda dapat secara opsional mengonfigurasi autentikasi kunci langganan melalui API Management. Pelajari selengkapnya tentang autentikasi kunci langganan.

  1. Pilih API yang Anda buat pada langkah sebelumnya.
  2. Pada halaman Pengaturan , di bawah Langganan, pilih (aktifkan) Langganan diperlukan.

Jika Anda mengaktifkan autentikasi kunci langganan, klien harus menyertakan kunci langganan yang valid di Ocp-Apim-Subscription-Key parameter header atau subscription-key kueri saat memanggil API agen A2A atau mengakses kartu agen.

Menguji API agen A2A

Untuk memastikan API agen A2A Anda berfungsi seperti yang diharapkan, panggil backend melalui API Management:

  1. Pilih API yang Anda buat pada langkah sebelumnya.
  2. Pada halaman Gambaran Umum , salin URL dasar Runtime. Gunakan URL ini untuk memanggil API agen A2A melalui API Management.
  3. Konfigurasikan klien pengujian atau gunakan alat seperti curl untuk membuat POST permintaan ke agen. Jika autentikasi kunci langganan diaktifkan, sertakan header kunci langganan atau parameter kueri yang valid dalam permintaan.

Petunjuk / Saran

Demikian pula, akses kartu agen melalui API Management dengan membuat GET permintaan ke URL kartu Agen yang ditampilkan di halaman Gambaran Umum API agen A2A Anda.

Keterbatasan

  • Fitur ini saat ini hanya tersedia dalam instans API Management di tingkat v2.
  • Hanya API agen A2A berbasis JSON-RPC yang didukung.
  • Deserialisasi badan respons keluar tidak didukung.

Konten terkait

  • Last updated on