Teilen über

Importieren einer A2A-Agent-API (Vorschau)

GILT FÜR: Basic v2 | Standard v2 | Premium v2

API Management unterstützt die Verwaltung von AI-Agent-APIs, die mit der Protokollspezifikation Agent2Agent (A2A) kompatibel sind. Das A2A-Protokoll ist ein offener Clientserverstandard, der es verschiedenen KI-Agent-Systemen ermöglicht, mithilfe eines gemeinsamen Interaktionsmodells zu kommunizieren und zusammenzuarbeiten. Mit der Unterstützung der A2A-Agent-API in der API-Verwaltung können Sie Agent-APIs zusammen mit anderen API-Typen verwalten und steuern, einschließlich AI-Modell-APIs, MCP-Tools (Model Context Protocol) und herkömmliche APIs wie REST, SOAP und GraphQL.

Hinweis

Dieses Feature befindet sich in der Vorschau und hat einige Einschränkungen.

Weitere Informationen zum Verwalten von KI-APIs in der API-Verwaltung:

Wichtige Funktionen

Wenn Sie eine A2A-Agent-API importieren, bietet die API-Verwaltung die folgenden Funktionen:

  • Vermittelt JSON-RPC Laufzeitvorgänge an das A2A-Back-End.
    • Ermöglicht Regelungsverwaltung und Datenverkehrskontrolle mithilfe von Richtlinien.
    • Wenn Einblick über Application Insights aktiviert ist, werden die folgenden A2A-spezifischen Attribute hinzugefügt, um die semantische OpenTelemetry GenAI-Konvention einzuhalten:
      • genai.agent.id – Auf die agent-ID festgelegt, die in den API-Einstellungen konfiguriert ist
      • genai.agent.name– Legen Sie den API-Namen in den API-Einstellungen fest
  • Macht die Agentkarte mit den folgenden Transformationen verfügbar:
    • Ersetzt den Hostnamen durch den Hostnamen der API-Verwaltungsinstanz.
    • Legt das bevorzugte Transportprotokoll auf JSON-RPC fest.
    • Entfernt alle anderen Schnittstellen in additionalInterfaces.
    • Schreibt Sicherheitsanforderungen neu, um die Schlüsselanforderung für das API-Verwaltungsabonnement einzuschließen.

Voraussetzungen

Importieren der A2A-Agent-API mithilfe des Portals

Führen Sie die folgenden Schritte aus, um eine A2A-Agent-API in die API-Verwaltung zu importieren.

  1. Wechseln Sie im Azure-Portal zu Ihrer API-Verwaltungsinstanz.

  2. Wählen Sie im linken Menü unter APIs die Option APIs>+ API hinzufügen aus.

  3. Wählen Sie die Kachel "A2A-Agent" aus.

    Screenshot der Auswahl der Kachel

  4. Geben Sie unter der Agent-Karte die URL ein, die auf das JSON-Dokument der Agentkarte verweist. Wählen Sie Weiteraus.

  5. Konfigurieren Sie auf der Seite " A2A-Agent-API erstellen" die API-Einstellungen.

    1. Wenn die Laufzeit-URL und die Agent-ID nicht automatisch basierend auf der Agentkarte konfiguriert werden, geben Sie die Laufzeit-URL von JSON-RPC Vorgängen an Ihren Agent und die agent-ID an, die in OpenTelemetry-Ablaufverfolgungen verwendet wird, die vom Agent (gen_ai.agent.id Attribut) ausgegeben werden.
    2. Geben Sie unter den allgemeinen API-Einstellungen einen Anzeigenamen Ihrer Wahl in die API-Verwaltungsinstanz ein, und geben Sie optional eine Beschreibung ein.
    3. Geben Sie unter DER URL einen Basispfad ein, den Ihre API-Verwaltungsinstanz für den Zugriff auf die A2A-Agent-API verwendet. Die API-Verwaltung zeigt eine Basis-URL an, die Clients für den Zugriff auf die JSON-RPC-API und eine Agentkarten-URL für den Zugriff auf die Agentkarte über die API-Verwaltung verwenden können.

  6. Wählen Sie "Erstellen" aus, um die API zu erstellen.

Screenshot der Erstellung einer A2A-agentkompatiblen API im Portal.

Konfigurieren von Richtlinien für die A2A-Agent-API

Konfigurieren Sie eine oder mehrere API-Verwaltungsrichtlinien , um die A2A-Agent-API zu verwalten.

So konfigurieren Sie Richtlinien für Ihre A2A-Agent-API:

  1. Wechseln Sie im Azure-Portal zu Ihrer API-Verwaltungsinstanz.
  2. Wählen Sie im linken Menü unter APIs Ihre A2A-Agent-API aus.
  3. Wählen Sie im linken Menü unter A2A die Option "Richtlinien" aus.
  4. Fügen Sie im Richtlinien-Editor die Richtlinien hinzu, die Sie auf die A2A-Agent-API anwenden möchten, oder bearbeiten Sie sie. Die Richtlinien werden im XML-Format definiert.

Hinweis

Die API-Verwaltung wertet Richtlinien aus, die im globalen Bereich (alle APIs) vor Richtlinien im A2A-Agent-API-Bereich konfiguriert sind.

Konfigurieren der Authentifizierung mit Abonnementschlüsseln

In den A2A-API-Einstellungen können Sie optional die Authentifizierung mit Abonnementschlüsseln über die API-Verwaltung konfigurieren. Erfahren Sie mehr über die Authentifizierung mit Abonnementschlüsseln.

  1. Wählen Sie die API aus, die Sie im vorherigen Schritt erstellt haben.
  2. Wählen Sie auf der Seite Einstellungen unter Abonnement die Option Abonnement aktivieren aus.

Wenn Sie die Authentifizierung mit Abonnementschlüsseln aktivieren, müssen Clients einen gültigen Abonnementschlüssel in den Ocp-Apim-Subscription-Key Header- oder subscription-key Abfrageparameter einschließen, wenn Sie die A2A-Agent-API aufrufen oder auf die Agentkarte zugreifen.

Testen der A2A-Agent-API

Um sicherzustellen, dass Ihre A2A-Agent-API wie erwartet funktioniert, rufen Sie das Back-End über die API-Verwaltung auf:

  1. Wählen Sie die API aus, die Sie im vorherigen Schritt erstellt haben.
  2. Kopieren Sie auf der Seite "Übersicht" die Runtime-Basis-URL. Verwenden Sie diese URL, um die A2A-Agent-API über die API-Verwaltung aufzurufen.
  3. Konfigurieren Sie einen Testclient, oder verwenden Sie ein Tool wie curl , um eine POST Anforderung an den Agent zu senden. Wenn die Authentifizierung des Abonnementschlüssels aktiviert ist, fügen Sie einen gültigen Abonnementschlüsselheader oder Abfrageparameter in die Anforderung ein.

Tipp

Ebenso greifen Sie über die API-Verwaltung auf die Agentkarte zu, indem Sie eine GET Anforderung an die Agentkarten-URL senden, die auf der Seite "Übersicht" Ihrer A2A-Agent-API angezeigt wird.

Einschränkungen

  • Dieses Feature ist derzeit nur in API-Verwaltungsinstanzen in den v2-Ebenen verfügbar.
  • Es werden nur JSON-RPC-basierte A2A-Agent-APIs unterstützt.
  • Die Deserialisierung ausgehender Antworttexte wird nicht unterstützt.

Verwandte Inhalte

  • Last updated on