Einen KI-gestützten Chat-Router mit der Oracle Cloud Infrastructure AI Agent Platform erstellen

Einführung

In diesem Tutorial wird gezeigt, wie Sie einen Oracle Cloud Infrastructure-(OCI-)KI-Agent erstellen, der die Benutzereingabe basierend auf seinem Kontext an die LLMs weiterleitet, die im OCI Generative AI-Service mit dem Oracle Cloud Infrastructure Agent Development Kit (OCI ADK) gehostet werden. Sie lernen, wie Sie OCI-Servicelogik als Tools verpacken, einen KI-Agent erstellen, der natürliche Sprache interpretiert und effektiv Antworten basierend auf dem Kontext erhält. Dies bringt das Beste aus den LLMs heraus, die in OCI mit KI-Agents gehostet werden.

Im Rahmen dieses Tutorials werden nur zwei LLMs im Backend verwendet. Wenn die Eingabe des Benutzers auf der Inhaltsgenerierung oder Textzusammenfassung basiert, wird diese Eingabe an Llama 3.3 70B gesendet. Wenn es sich bei der Eingabe des Benutzers um Codierung oder Mathematik handelt, wird sie an Llama 4 Maverick gesendet, das auf den OCI Generative AI-Services gehostet wird.

Hinweis:

Ziele

Voraussetzungen

Aufgabe 1: OCI AI Agent über die OCI-Konsole erstellen

Mit der Oracle Cloud Infrastructure AI Agent Platform (OCI AI Agent Platform) können Sie intelligente Assistenten erstellen, die Benutzerfragen interpretieren, Aktionen planen und benutzerdefinierte oder integrierte Tools (Kompetenzen) für OCI-APIs aufrufen. Jedes Tool wird als Python-Klasse mit bestimmten Methoden verpackt, was das Toolregistrierungssystem von OCI ADK bestätigt.

  1. Melden Sie sich bei der OCI-Konsole an, navigieren Sie zu Generative AI Agents, und klicken Sie auf Agent erstellen.

    image

  2. Geben Sie im Abschnitt Basisinformationen einen Namen und die Willkommensmeldung ein. Die Routinganweisung wird im Rahmen dieses Tutorials leer bleiben. Klicken Sie anschließend auf Weiter.

    image

  3. Erstellen Sie im Abschnitt Tool hinzufügen keine Tools. Wir verwenden OCI ADK, um es zu erstellen.

  4. Wählen Sie im Abschnitt Agent-Endpunkt einrichten die Option Schutzschienen aus.

    image

  5. Klicken Sie auf Agent erstellen.

Schlüsselkonzepte:

Hinweis: Ein Agent kann Benutzeranforderungen über mehrere Toolkits (z.B. Oracle Cloud Guard, Compartments) hinweg weiterleiten und nach Bedarf mehrstufige Vorgänge erstellen.

Aufgabe 2: OCI ADK lokal einrichten

Sie schreiben Python-Klassen, die Tools definieren, um Oracle Cloud Guard-Vorgänge verfügbar zu machen. Jede Funktion wird mit @tool versehen und kann vom Agent in natürlicher Sprache aufgerufen werden.

Authentifizierung in der Agent-Datei aktualisieren

image

Aufgabe 3. AI-Agent ausführen

  1. Laden Sie die folgende Datei herunter, und speichern Sie sie im selben Verzeichnis.

  2. Aktualisieren Sie die Eingabe in der Datei oci_ai_route.py entsprechend Ihren Anforderungen.

    image

  3. Führen Sie die Datei oci_ai_route.py mit dem folgenden Befehl aus.

    uv run oci_ai_route.py 
    
  4. Je nach Kontext wird das erforderliche Modell aufgerufen und Inhalt generiert.

    image

Hinweis: Sie können diesen Agent mit der agent.run() aus der oci_ai_route.py aufrufen, die Ihrer Webanwendung oder Anwendung hinzugefügt wurde.

Bestätigungen

Weitere Lernressourcen

Sehen Sie sich weitere Übungen zu docs.oracle.com/learn an, oder greifen Sie auf weitere kostenlose Lerninhalte im Oracle Learning YouTube-Kanal zu. Besuchen Sie außerdem education.oracle.com/learning-explorer, um ein Oracle Learning Explorer zu werden.

Die Produktdokumentation finden Sie im Oracle Help Center.