Registrieren und Entdecken von Fähigkeiten in Ihrem API-Inventar

In diesem Artikel wird beschrieben, wie Sie mithilfe des Azure API Center Agent-Fähigkeiten im Rahmen Ihres API-Inventars registrieren. Fähigkeiten sind wiederverwendbare Funktionen, die KI-Agents entdecken und nutzen können, um ihre Funktionalität zu erweitern.

Durch die Registrierung von Fähigkeiten im API Center erstellen Sie eine zentrale Registrierung, die Ihrer Organisation hilft:

• Entdecken Sie verfügbare Funktionen und deren Möglichkeiten
• Zugriff auf Quellcode und Dokumentation für die Skills

Voraussetzungen

• Ein API-Center. Wenn Sie noch kein API-Center haben, lesen Sie die Schnellstartanleitung zum Erstellen eines API-Centers.
• Mindestens eine Fähigkeit, die Sie registrieren möchten, wird in der Regel in einem Quellcoderepository wie GitHub gehostet.

Registrieren einer Fähigkeit

So registrieren Sie eine Fähigkeit im API Center:

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

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

3. Wählen Sie + Ein Asset registrieren>Fertigkeit.

   

4. Geben Sie im Formular "Qualifikation registrieren " die Informationen in der folgenden Tabelle an:

   Feld	Beschreibung
   Title	Geben Sie einen beschreibenden Namen für die Fähigkeit ein (z. B. Code Review Skill).
   Identifizierung	API Center generiert automatisch einen Bezeichner basierend auf dem Titel (z. B. Codeüberprüfungskompetenz). Sie können dies bei Bedarf bearbeiten.
   Zusammenfassung	Geben Sie eine kurze einzeilige Beschreibung der Fähigkeiten an (z. B. führt automatisierte Codeüberprüfungen mithilfe statischer Analysen aus).
   Beschreibung	Geben Sie eine detailliertere Beschreibung der Fähigkeiten, Anwendungsfälle und Verhaltensweisen der Fähigkeiten ein.
   Lebenszyklusstufe	Wählen Sie im Dropdownmenü die aktuelle Phase des Lebenszyklus der Fähigkeiten aus.
   Quelle
   Quell-URL	Geben Sie die Git-Repository-URL für den Skill-Quellcode ein (z. B. https://github.com/<org>/<repo>/tree/main/skills/<skill-name>).
   Kompatibilität	Beschreiben sie die Anforderungen, Abhängigkeiten und Voraussetzungen für die Verwendung der Fähigkeiten (z. B. erforderliche Software oder Tools wie Git, Docker, Programmiersprachen; Systemanforderungen; Netzwerkzugriffsanforderungen; API-Schlüssel oder Authentifizierungsanforderungen).
   Zulässige Tools	Wählen Sie +Tool hinzufügen aus, um die APIs oder MCP-Server aus Ihrem API-Bestand anzugeben, auf den diese Fähigkeit zugreifen kann. Dieser Ansatz trägt dazu bei, eine ordnungsgemäße Governance und Sicherheit zu gewährleisten, indem explizit definiert wird, welche Ressourcen die Fähigkeiten nutzen können.
   Lizenz	Wählen Sie +Hinzufügen aus, um Lizenzinformationen bereitzustellen. Geben Sie den Lizenznamen (z. B. MIT, Apache 2.0 oder Proprietäre) ein, geben Sie optional eine Lizenz-URL ein, und fügen Sie ggf. eine Beschreibung hinzu, um Lizenzbedingungen oder Einschränkungen zu klären.
   Kontaktinformationen	Wählen Sie +Hinzufügen aus, um Kontaktpunkte für Support oder Anfragen hinzuzufügen. Geben Sie einen Kontaktnamen oder eine Rolle ein (z. B. API-Team oder John Smith), geben Sie Kontaktdetails wie E-Mail-Adresse ein, und fügen Sie optional eine Beschreibung hinzu, um zu klären, wann und warum Sie diese Person oder dieses Team kontaktieren möchten.

5. Wählen Sie "Erstellen" aus, um die Fähigkeiten in Ihrem API Center zu registrieren.

Nach der Registrierung wird die Fähigkeit in Ihrem Bestand auf der Seite "Bestandsressourcen>" angezeigt.

Aktualisieren einer registrierten Fähigkeit

Sie können Qualifikationsinformationen jederzeit aktualisieren:

1. Wechseln Sie im API Center zu "Bestandsressourcen>".
2. Suchen Und wählen Sie die Fähigkeiten aus, die Sie aktualisieren möchten.
3. Wählen Sie "Bearbeiten" aus, um die Eigenschaften der Fähigkeiten zu ändern.
4. Nehmen Sie Ihre Änderungen vor und wählen Sie Speichern aus.

Synchronisieren von Fähigkeiten aus einem Git-Repository

Um die Qualifikationsregistrierung zu automatisieren und Ihr Inventar auf dem neuesten Stand zu halten, können Sie ein Git-Repository in Ihr API Center integrieren. Weitere Informationen finden Sie unter Synchronisieren von API-Ressourcen aus einem Git-Repository.

Entdecken von Fähigkeiten im API Center-Portal

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

• Fähigkeiten im Inventar durchsuchen und filtern.
• Zeigen Sie detaillierte Informationen zu den einzelnen Fähigkeiten 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:

   

   • 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.

Verwandte Inhalte

• Synchronisieren von API-Ressourcen aus einem Git-Repository
• Registrieren und ermitteln Sie MCP-Server und Plug-Ins in Ihrem API-Bestand.
• Einrichten Ihres API Center-Portals
• Wichtige Konzepte im Azure API Center