27 AI-Registry

AI Registry ist der zentrale Katalog von Agents und MCP-Servern für Oracle AI Data Platform. Es unterstützt offene Standards, einschließlich MCP und A2A.

AI Data Platform ist der Ort, an dem Agents erstellt und bereitgestellt werden. Oracle Agent Hub ist der Ort, an dem Geschäftsbenutzer mit ihnen sprechen. Die AI Registry ist die Schicht dazwischen. AI Registry macht einen Agent oder ein Tool außerhalb der Umgebung, in der es integriert wurde, auffindbar und verwendbar. Agents und Tools müssen in AI Registry registriert sein, bevor sie im Agent Hub freigegeben werden können. Siehe Funktionsweise von Enterprise AI in Agent Hub in Oracle Agent Hub verwenden.

Sie können die folgenden Agents und Tools in der AI-Registry von AI Data Platform registrieren:

Typ Beschreibung
AI Data Platform-Agent Ein Agent, der in AI Data Platform in einem Workspace erstellt und bereitgestellt wird, auf den Sie Zugriff haben. Wird auch als lokaler Agent in der AI-Registry von AI Data Platform bezeichnet.
Externer Mitarbeiter Ein Agent, der außerhalb der AI Data Platform gehostet wird und von der zugehörigen Agent-Karten-URL A2A hinzugefügt wird.
MCP-Server Ein Model Context Protocol-(MCP-)Server, der eine Reihe von Tools bereitstellt, die Agents aufrufen können.

In AI Registry können Sie KI-Agents, MCP-Server und Zugangsdaten verwalten, die für die Verwendung beider Agents erforderlich sind. Auf der Seite "KI-Registry" können Sie die Registerkarten Agents, MCP-Server und Zugangsdaten verwenden, um jeweils eine Liste anzuzeigen. Mit der Suchleiste können Sie sichtbare Optionen nach Name oder Beschreibung filtern. Auf der Registerkarte "Agents" können Sie mit dem Dropdown-Menü Sortieren nach sortieren, wie zuletzt Agents der Registry hinzugefügt wurden.

Wenn Sie auf eine Agent-Karte klicken, werden die Details für diesen Agent angezeigt. Dabei werden der Ersteller, die Quelle, die Version, eine URL für die Agent-Karte und die Protokollversion angegeben. Mit den Optionen in der oberen rechten Ecke der Karte können Sie zwischen der Detailansicht und einer JSON-Ansicht der Karte wechseln.

Bevor Sie neue externe Agents oder MCP-Server registrieren, müssen Sie zunächst ihre Authentifizierungszugangsdaten auf der Registerkarte Zugangsdaten registrieren. Anschließend können Sie neue Agents und MCP-Server registrieren, indem Sie oben rechts auf Registrieren klicken und die entsprechende Option auswählen. Berechtigungen für AI Registry werden über die Registerkarte Berechtigungen verwaltet.

Agent-Karten

Agent-Karten sind die Metadatenstruktur, die einen Agent beschreibt. AI Registry liest sie während der Registrierung und zeigt sie Ihnen zur Prüfung vor dem Commit an.

Weitere Informationen finden Sie in der A2A Protokollspezifikation.

Agent-Karten enthalten die folgenden Informationen:
  • Name, Version und Beschreibung.
  • Die Agent-Karten-URL, in der die Karte selbst veröffentlicht wird.
  • Protokollversion.
  • Eingangs- und Ausgangsmodi. Beispiel: Text, Text/Nur oder Text/HTML.
  • Funktionen wie Streaming.
  • Fähigkeiten, die jeweils einen eigenen Namen und eine eigene Beschreibung haben.
Die Karte entspricht der Orchestrierung. Wenn ein Benutzer eine Frage in Agent Hub stellt, ohne einen Agent auszuwählen, bestimmen der Name, die Beschreibung, die Skills und die Funktionen auf dieser Karte, ob Ihr Agent angezeigt wird. Eine vage Beschreibung ist der häufigste Grund, warum ein Agent nie ausgewählt wird.

Zugangsdaten in AI-Registry erstellen

Sie können Zugangsdaten speichern, die für die Authentifizierung von AI-Registry-Objekten wie Agents und MCP-Servern erforderlich sind.

  1. Klicken Sie auf der Homepage auf AI-Registry-SymbolAI-Registry.
  2. Klicken Sie auf die Registerkarte Zugangsdaten und dann auf Zugangsdaten erstellen.
  3. Geben Sie einen Namen und eine Beschreibung für die Zugangsdaten an.
  4. Wählen Sie aus dem Dropdown-Menü den Zugangsdatentyp aus.
  5. Wählen Sie den Grant-Typ aus dem Dropdown-Menü.
  6. Geben Sie die Autorisierungs-URL, die Zugriffstoken-URL, die Client-ID, das Client Secret und die Aktualisierungs-URL für Ihre Zugangsdaten ein.
  7. Geben Sie einen Geltungsbereichsnamen und -wert ein. Mindestens ein Geltungsbereichsname und -wert ist erforderlich. Fügen Sie weitere Geltungsbereichsnamen und -werte hinzu, indem Sie auf Geltungsbereich hinzufügen klicken.
  8. Kopieren Sie die Umleitungs-URL. Sie müssen die Umleitungs-URL in die vertrauliche Anwendung in Ihrer Identitätsdomain einfügen. Das folgende Beispiel zeigt, wie Sie die Umleitungs-URL in Oracle Cloud Infrastructure kopieren:
    1. Melden Sie sich bei der OCI-Konsole an.
    2. Klicken Sie auf Identität und Sicherheit, Domains, Integrierte Anwendungen.
    3. Wählen Sie die Anwendung aus, für die Sie Umleitungs-URLs aktualisieren möchten.
    4. Klicken Sie auf die Registerkarte OAuth-Konfiguration und dann auf OAuth-Konfiguration bearbeiten.
    5. Wenden Sie alle erforderlichen Umleitungs-URLs an, und klicken Sie auf Weiterleiten.
  9. Klicken Sie auf Create.

Lokalen Agent in AI-Registry registrieren

Sie können lokale KI-Agents über Oracle AI Data Platform-Workspaces registrieren, auf die Sie Zugriff haben.

Agents müssen in AI Data Platform bereitgestellt werden, bevor sie in AI Registry registriert werden können. Siehe Agent-Deployment.
  1. Klicken Sie auf der Homepage auf AI-Registry-SymbolAI-Registry.
  2. Klicken Sie auf Registrieren und dann auf Agent.
  3. Klicken Sie auf Lokaler Agent.
  4. Wählen Sie im Dropdown-Menü Workspace den Arbeitsbereich aus, in dem sich der lokale Agent befindet.
  5. Wählen Sie im Dropdown-Menü Agent den Agent aus, den Sie registrieren möchten.
  6. Optional: Bewegen Sie den Mauszeiger über das Kartensymbol, um eine Vorschau der Agent-Karte anzuzeigen.
  7. Klicken Sie auf Weiter.
  8. Stellen Sie sicher, dass die Agent-Details korrekt sind, und klicken Sie auf Registrieren.

Externen Agent in AI-Registry registrieren

Sie können externe KI-Agents aus unterstützten Quellen in Ihrer AI-Registry registrieren. Diese Agents müssen dem A2A-Protokoll entsprechen.

Wenn der externe Agent eine Authentifizierung erfordert, erstellen Sie diese Zugangsdaten zunächst in der Registerkarte Zugangsdaten der AI-Registry.
  1. Klicken Sie auf der Homepage auf AI-Registry-SymbolAI-Registry.
  2. Klicken Sie auf Registrieren und dann auf Agent.
  3. Klicken Sie auf Externer Agent.
  4. Geben Sie die Agent-Karten-URL ein.
  5. Optional: Wenn für Ihren Endpunkt sichere Zugangsdaten erforderlich sind, wählen Sie Authentifizierung erforderlich aus, und wählen Sie die Zugangsdaten aus dem Dropdown-Menü Zugangsdaten aus.
  6. Klicken Sie auf Weiter.
  7. Optional: Wenn Sie "Authentifizierung erforderlich" ausgewählt haben, geben Sie in dem angezeigten Dialogfeld die Zugangsdaten für ein Konto ein, das für den Agent berechtigt ist.
  8. Prüfen Sie die Agent-Details auf Richtigkeit, und klicken Sie dann auf Registrieren.

MCP-Server in AI-Registry registrieren

Ein MCP-Server stellt eine Reihe von Tools bereit, die Agents über eine Standardschnittstelle ermitteln und aufrufen können. Durch die Registrierung in AI Registry sind diese Tools in der Plattform verfügbar.

Hinweis:

Wenn der MCP-Server eine Authentifizierung erfordert, müssen Sie zuerst die OAuth-Zugangsdaten in AI Registry erstellen. Zugangsdaten können nicht als Teil der Registrierung eines MCP-Servers hinzugefügt werden.
  1. Klicken Sie auf der Homepage auf AI-Registry-SymbolAI-Registry.
  2. Klicken Sie auf Registrieren und dann auf MCP-Server.
  3. Geben Sie die URL des MCP-Serverendpunkts ein.
  4. Geben Sie einen hilfreichen Anzeigenamen und eine hilfreiche Beschreibung ein. Benutzer und Vertreter verwenden diese zur Identifizierung des Zwecks des MCP-Servers.
  5. Wählen Sie im Dropdown-Menü die Methode Transport aus.
  6. Optional: Wenn Ihr MCP-Server sichere Zugangsdaten benötigt, wählen Sie Authentifizierung erforderlich aus. Wählen Sie die Zugangsdaten aus dem Dropdown-Menü Zugangsdaten aus.
  7. Klicken Sie auf "Fortfahren".
  8. Hier finden Sie die Liste der enthaltenen Tools für den ausgewählten MCP-Server. Wählen Sie die Tools aus, die Sie einzeln einbeziehen möchten, oder klicken Sie auf Alle auswählen, um alle aufgeführten Tools einzuschließen.
  9. Klicken Sie auf Registrieren.