Registrieren und Verwalten von Agents im Azure API Center

In diesem Artikel erfahren Sie, wie Sie A2A-Agents im API Center registrieren und wie Sie sie nach der Registrierung aktualisieren und verwalten. Sie können Fähigkeiten hinzufügen, Funktionen konfigurieren und Anbieterinformationen aktualisieren.

Voraussetzungen

• Eine Azure API Center-Instanz
• Ein A2A-Agent, der durch eine Agentenbeschreibungskarte dargestellt wird
• Entsprechende Berechtigungen zum Bearbeiten von APIs in Ihrem API Center

Agent registrieren

Geben Sie die erforderlichen Werte aus der Agentkarte des Agenten ein. Fügen Sie optional Fähigkeiten und andere Metadaten hinzu, die die Funktionen und Aktionen definieren, die Ihr A2A-Agent ausführen kann.

Tipp

Ausführliche Informationen zum Qualifikationsschema finden Sie in der offiziellen Spezifikation des Agent2Agent (A2A)-Protokolls.

1. Melden Sie sich beim Azure-Portal an, und wechseln Sie dann zum API Center.

2. Wählen Sie im Randleistenmenü unter "Bestand" die Option "Objekte" aus.

3. Wählen Sie + Vermögenswert registrieren>A2A-Agent.

4. Füllen Sie auf der Seite " API registrieren " die Standardeigenschaften aus, um eine API zu registrieren, und wählen Sie A2A als Agenttyp aus.

   • Das Formular wird aktualisiert, um andere Felder anzuzeigen, die für den A2A-API-Typ spezifisch sind.

5. Geben Sie im Abschnitt "Agent Card " die folgenden Details ein:

   Feld	Description
   Protokollversion	Die Version des A2A-Protokolls, das dieser Agent unterstützt.
   Agent-URL	Die bevorzugte Endpunkt-URL für die Interaktion mit dem Agent.
   Bevorzugter Transport	Das Transportprotokoll für den bevorzugten Endpunkt.
   Agent-Version	Die eigene Versionsnummer des Agents.

6. Suchen Sie den Abschnitt "Agent Skills".

7. Klicken Sie auf + Hinzufügen.

8. Definieren Sie auf der Seite "Agent Skills " die Fähigkeiten, indem Sie Informationen zu den erforderlichen Feldern bereitstellen.

9. Wählen Sie "Hinzufügen" aus, um die Fähigkeit hinzuzufügen.

10. Geben Sie im Abschnitt "Agent Provider " die folgenden Details ein:

    Feld	Description
    Name der Organisation	Der Name der Organisation des Agentanbieters
    Organisations-URL	Eine URL für die Website des Agentenanbieters oder relevante Dokumentation

11. Aktivieren oder deaktivieren Sie die Agent-Funktionen nach Bedarf:

    Feld	Description
    Streamingunterstützung	Gibt an, ob der Agent Server-Sent Events (SSE) für Streamingantworten unterstützt.
    Pushbenachrichtigungen	Gibt an, ob der Agent das Senden von Pushbenachrichtigungen für asynchrone Aufgabenupdates unterstützt.
    Statusübergangsverlauf	Gibt an, ob der Agent einen Verlauf der Statusübergänge für eine Aufgabe bereitstellt.

12. Wählen Sie "Erstellen" aus, um die API zu registrieren.

Updateagent

1. Wechseln Sie im Azure-Portal zu Ihrem API Center.

2. Wählen Sie im Randleistenmenü unter "Bestand" die Option "Objekte" aus.

3. Wählen Sie in der Tabelle Ihren A2A-Agent aus, indem Sie den Agentnamen in der Spalte "Titel " auswählen.

4. Wählen Sie die Schaltfläche "Bearbeiten " aus, um die Seite "Bearbeiten " im Arbeitsbereich zu öffnen.

   

Fügen Sie Ihrem Agenten Fähigkeiten hinzu

Fähigkeiten definieren die Funktionen und Aktionen, die Ihr A2A-Agent ausführen kann.

Tipp

Ausführliche Informationen zum Qualifikationsschema finden Sie in der offiziellen Spezifikation des Agent2Agent (A2A)-Protokolls.

1. Suchen Sie auf der Seite "Bearbeiten " den Abschnitt " Agent Skills ".
2. Klicken Sie auf + Hinzufügen.
3. Definieren Sie auf der Seite "Agent Skills " die Fähigkeiten, indem Sie Informationen zu den erforderlichen Feldern bereitstellen.
4. Wählen Sie "Hinzufügen" aus, um die Fähigkeit hinzuzufügen.

Hinzufügen von Anbieterinformationen

Anbieterinformationen helfen anderen Teams bei der Identifizierung, wer den Agent verwaltet.

1. Suchen Sie auf der Seite "Agent Bearbeiten" den Abschnitt "Agent-Anbieter".

2. Geben Sie die folgenden Details ein:

   Feld	Description
   Name der Organisation	Der Name der Organisation des Agentanbieters
   Organisations-URL	Eine URL für die Website des Agentenanbieters oder relevante Dokumentation

3. Wählen Sie Speichern aus.

Konfigurieren von Agentfunktionen

Die Agentfunktionen beschreiben, welche Features Ihr A2A-Agent unterstützt.

1. Suchen Sie auf der Seite "Bearbeiten " den Abschnitt "Agent-Funktionen" .

2. Aktivieren oder deaktivieren Sie die folgenden Funktionen nach Bedarf:

   Feld	Description
   Streamingunterstützung	Gibt an, ob der Agent Server-Sent Events (SSE) für Streamingantworten unterstützt.
   Pushbenachrichtigungen	Gibt an, ob der Agent das Senden von Pushbenachrichtigungen für asynchrone Aufgabenupdates unterstützt.
   Statusübergangsverlauf	Gibt an, ob der Agent einen Verlauf der Statusübergänge für eine Aufgabe bereitstellt.

3. Wählen Sie Speichern aus.

Verwandte Inhalte

Agentregistrierung im Azure API Center