Registrieren und Verwalten von Agents im Azure API Center

In diesem Artikel erfahren Sie, wie Sie KI-Agents, einschließlich A2A-Agents, im API Center registrieren, benutzern auffindbar machen und diese aktualisieren und verwalten.

Voraussetzungen

  • Eine Azure API Center-Instanz
  • Ein Agent, der von einer Agentkarte im JSON-Format oder einer Agentdefinition im Markdown-Format beschrieben wird
  • Entsprechende Berechtigungen zum Bearbeiten von APIs in Ihrem API Center

Agent registrieren

  1. Melden Sie sich beim portal Azure an, und wechseln Sie zum API Center.

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

  3. Wählen Sie + Asset registrieren>Agent.

    Screenshot der Registrierung eines Agents im Portal.

  4. Geben Sie im Formular "Agent registrieren " die in der folgenden Tabelle beschriebenen Informationen ein:

    Feld Description
    Title Geben Sie einen beschreibenden Namen für den Agent ein, z. B. Helpdesk-Agent.
    Identifizierung API Center generiert automatisch einen Bezeichner basierend auf dem Titel, z. B. Helpdesk-Agent. Sie können diesen Bezeichner bei Bedarf bearbeiten.
    Kurze Zusammenfassung Geben Sie eine kurze, einzeilige Beschreibung dessen ein, was der Agent tut und die im API Center-Portal und an anderen Stellen angezeigt wird.
    Beschreibung Geben Sie optional eine detailliertere Beschreibung der Fähigkeiten, Anwendungsfälle und Verhaltensweisen der Fähigkeiten ein.
    Version
    Versionstitel Geben Sie einen Versionstitel Ihrer Wahl ein, z. B. v1.
    Versionsidentifikation API Center generiert automatisch einen Bezeichner basierend auf dem Versionstitel. Sie können diesen Bezeichner bei Bedarf bearbeiten.
    Versionslebenszyklus Wählen Sie im Dropdownmenü die aktuelle Phase des Lebenszyklus der Agentversion aus. Weitere Informationen zu Versionen im API Center.
    Agentendetails
    Agentdefinition Geben Sie eine URL ein, oder wählen Sie eine Datei aus, um eine Agentdefinition hochzuladen. Die Agentdefinition sollte im Markdown-Format vorliegen und Details zu den Funktionen, Fähigkeiten und anderen relevanten Informationen des Agents enthalten.
    Protokoll Wenn zutreffend, wählen Sie das A2A-Protokoll aus, wenn der Agent es befolgt.
    Agentenkarte Geben Sie optional eine URL ein, oder wählen Sie eine Datei aus, um eine A2A-Agent-Karte im JSON-Format hochzuladen.

    Screenshot des Bereichs

  5. Wählen Sie "Erstellen" aus, um den Agent hinzuzufügen.

Nach der Registrierung wird der Agent in Ihrem Bestand auf der Seite "Bestandsressourcen>" angezeigt.

Aktualisieren eines registrierten Agents

Sie können Agent-Informationen jederzeit aktualisieren.

  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 den Namen des Agenten in der Spalte Title aus.
  4. Wählen Sie die Schaltfläche "Bearbeiten " aus, um die Seite "Bearbeiten " im Arbeitsbereich zu öffnen.
  5. Nehmen Sie Ihre Änderungen vor und wählen Sie Speichern aus.

Synchronisieren von Agents aus API-Quellen

Um die Agentregistrierung zu automatisieren und Ihren Bestand auf dem neuesten Stand zu halten, können Sie die folgenden upstream-Quellen in Ihr API Center integrieren:

  • Azure API Management: Wenn Sie A2A-Agents in Azure API Management verwalten, können Sie die automatische Synchronisierung aktivieren, um Ihr API Center auf dem neuesten Stand zu halten. Weitere Informationen finden Sie unter Synchronisieren von APIs aus Azure API Management Instanz.

  • Git-Repository: Für A2A-Agents und andere KI-Ressourcen, die in einem Git-Repository gespeichert sind, können Sie die automatische Synchronisierung aktivieren, um Ihr API Center auf dem neuesten Stand zu halten. Weitere Informationen finden Sie unter Synchronisieren von API-Ressourcen aus einem Git-Repository.

Agenten im API Center-Portal entdecken

Richten Sie Ihr API Center-Portal ein, damit Entwickler und andere Projektbeteiligte in Ihrer Organisation Agents in Ihrem API-Inventar ermitteln können. Über das API Center-Portal können Benutzer:

  • Durchsuchen und filtern Sie Agenten im Inventar.
  • Zeigen Sie detaillierte Informationen zu jedem Agent an.

KI-Ressourcen bewerten

DAS API Center kann die Qualität von KI-Ressourcen wie Fähigkeiten und Agents bewerten, die in Ihrem API Center registriert sind. DAS API Center verfügt über standardmäßige Bewertungskriterien und bewertet Ressourcen über vordefinierte Dimensionen hinweg. Unternehmensplattformadministratoren können diese Standardwerte weiter erweitern, indem benutzerdefinierte Bewertungskriterien definiert werden, die auf die spezifischen Standards, Complianceanforderungen und Governancerichtlinien ihrer Organisation zugeschnitten sind.

So aktivieren Sie automatisierte Bewertungen von KI-Ressourcen in Ihrem Bestand:

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

  2. Im Seitenleistenmenü. Gehen Sie zu Governance>KI-Bewertung.

  3. Wählen Sie die Registerkarte "Fähigkeiten " aus, um Bewertungen für Fähigkeiten zu konfigurieren, oder wählen Sie die Registerkarte "Agents " aus, um Bewertungen für Agents zu konfigurieren.

  4. Wählen Sie im Bewertungsstatus"Aktiviert" aus.

  5. Geben Sie eine Beschreibung für die Bewertung ein.

  6. Führen Sie in den Bewertungskriterien eine der folgenden Aktionen aus:

    • Akzeptieren Sie die standardkriterien , die vom API Center bereitgestellt werden. Entfernen Sie optional Standardkriterien, die für Ihre Organisation nicht relevant sind.

    Der folgende Screenshot zeigt Standardkriterien für Fähigkeiten:

    Screenshot der Konfiguration der KI-Qualifikationsbewertung im Portal.

    • Fügen Sie ein oder mehrere benutzerdefinierte Kriterien hinzu.
      1. Wählen Sie +Kriterien hinzufügen aus.
      2. Geben Sie einen Namen und eine optionale Bewertungsanweisung für das Kriterium ein.
      3. Geben Sie "Minimum score " und "Maximum score values" für die Bewertung ein (z. B. "1" und "5").
      4. Geben Sie einen Pass-Schwellenwert (z. B. 3) ein, der den minimal zulässigen Wert für das Kriterium angibt.
      5. Geben Sie einen Gewichtungswert ein, der den Beitrag des Kriteriums zur Gesamtbewertung angibt (z. B. multipliziert eine Gewichtung von 0,3 den Bewertungswert mit 0,3, sodass 30 % zur Gesamtbewertung beitragen).
      6. Wiederholen Sie die vorstehenden Schritte, um nach Bedarf weitere Kriterien hinzuzufügen.

  7. Wählen Sie Speichern aus.

Anschließend können Sie die Bewertungsergebnisse im API Center-Portal anzeigen. Zeigen Sie beispielsweise die Bewertungsergebnisse für jede Qualifikation auf der Seite mit den Qualifikationsdetails an.

Screenshot der Qualifikationsbewertung im API Center-Portal.

Verwandte Inhalte

  • Last updated on