Oracle Cloud Infrastructure-Dokumentation

SQL-Tool in generativen KI-Agents erstellen

In generativen KI-Agents muss jeder Agent über ein oder mehrere Tools verfügen. Sie können das Tool eines Agent während oder nach dem Erstellen des Agent erstellen. Für beide Optionen sind die gleichen Schritte beim Erstellen eines Tools erforderlich. In diesem Abschnitt werden die Schritte zum Erstellen eines SQL-Tools beschrieben.

Bevor Sie ein SQL-Tool erstellen, lesen Sie die SQL-Toolrichtlinien für generative KI-Agents, und führen Sie alle erforderlichen Aufgaben aus.

SQL-Tool erstellen

  1. Wählen Sie Tool erstellen und dann SQL aus.
  2. Geben Sie einen Namen und eine Beschreibung für dieses SQL-Tool ein.
    Mit einer Beschreibung des Datenbankschemas in diesem Tool kann der Agent besser verstehen, wie SQL-Abfrageanweisungen generiert werden.
  3. Wählen Sie unter Datenbankschemakonfiguration importieren eine der folgenden Optionen aus, um das Datenbankschema anzugeben, das für dieses Tool verwendet werden soll. Ein Schema ist eine Gruppe von SQL-Anweisungen, die Tabellen, Spalten, Datentypen und Beziehungen enthalten müssen, um die Organisation von Objekten in der Datenbank zu definieren.
    • Inline: Geben Sie eine Zeichenfolge ein, die SQL-Anweisungen enthält. Die Zeichenfolge muss mit einem gültigen SQL-Schlüsselwort wie CREATE und ALTER oder einer öffnenden Klammer ( beginnen.
    • Aus Objektspeicher auswählen: Wählen Sie ein Compartment und einen Bucket aus. Wählen Sie dann die Datei .sql aus, die SQL-Anweisungen enthält.
  4. Wählen Sie unter Modellanpassung eine der folgenden Optionen aus.
    • Klein: Wählen Sie diese Option für einfache Abfragen aus, z.B. "Gesamtumsatz für Januar 2025 abrufen". Ein kleines Modell bietet schnellere Reaktionszeiten.
    • Groß: Wählen Sie diese Option für komplexere Abfragen aus, z.B. "Zeigen Sie den durchschnittlichen Umsatz der 5 leistungsstärksten Produkte in Q1 2023 gruppiert nach Region an." Ein großes Modell bietet mehr Genauigkeit, aber auf Kosten einer höheren Latenz.
  5. Wählen Sie unter Dialekt eine der folgenden Optionen aus.
    • SQLite: Wählen Sie diese Option aus, um SQL-Abfragen zu generieren, die den SQLite-Syntaxregeln entsprechen. Beispiel: SELECT * FROM users LIMIT 5;
    • Oracle SQL: Wählen Sie diese Option aus, um Abfragen zu generieren, die den Oracle SQL-Syntaxregeln entsprechen. Beispiel: SELECT * FROM users FETCH FIRST 5 ROWS ONLY;

      Mit dieser Option wird sichergestellt, dass das generierte SQL vollständig mit der Syntax und Ausführungsumgebung einer Oracle Database kompatibel ist.

  6. (Optional) Wählen Sie unter Kontextbezogene Lernbeispiele eine der folgenden Optionen aus, um Beispiele für Abfragen in natürlicher Sprache anzugeben, die Benutzer im Kontext des angegebenen Schemas und der erwarteten zu generierenden SQL-Abfragen stellen können.
    • Inline: Geben Sie eine Zeichenfolge ein, die Beispielfragen in natürlicher Sprache und die erwarteten SQL-Abfragen enthält.

      Beispiele:

      Question: Show all employees who were born in CA.
Oracle SQL: SELECT * FROM Employees WHERE BIRTHSTATE = 'CA';
    • Aus Objektspeicher auswählen: Wählen Sie ein Compartment und einen Bucket aus. Wählen Sie dann die Datei .txt aus, die Beispiele für Fragen und Antworten im Kontext des Datenbankschemas enthält.
    • Keine: Keine Beispiele vorhanden.
  7. (Optional) Wählen Sie unter Verbindung zum Datenbanktool ein Compartment und dann eine Verbindung im Menü aus.

    Eine Verbindung ist nur erforderlich, wenn Sie die SQL-Ausführung oder Selbstkorrektur während einer Chatsession aktivieren möchten.

    Um sicherzustellen, dass die ausgewählte Verbindung funktioniert, wählen Sie Verbindung testen aus.

    Hinweis

    Der Verbindungstest validiert nur, ob das Setup der Verbindung zur Datenbank im Datenbanktoolservice ordnungsgemäß funktioniert und auf die Datenbank zugegriffen werden kann. Der Test validiert nicht den Zugriff des Agent auf die Datenbank. Verwenden Sie Policys, um sicherzustellen, dass generative AI-Agents auf die Datenbank zugreifen können.
    Tipp

    Wenn Sie keine Verbindung für dieses Tool verwenden möchten, nachdem Sie eine ausgewählt haben, wählen Sie x am Ende des Menüs aus, um die Verbindung zu entfernen.
  8. (Optional) Wählen Sie unter SQL-Ausführung aktivieren aus, ob die SQL-Ausführung aktiviert oder deaktiviert werden soll.

    Wenn die SQL-Ausführung aktiviert ist, generiert der Agent die SQL-Abfrageanweisung, führt die Abfrage aus und sendet die Antwort während der Chatsession an den Benutzer. Nur SELECT-Abfragen wie Join, mehrere Bedingungen und Aggregation werden generiert und ausgeführt. Wenn die Ausführung nicht erfolgreich verläuft, gibt der Agent einen Datenbankausführungsfehler mit dem ORA-Code (z.B. ORA-00933) zusammen mit der generierten SQL-Abfrage zurück.

    Tipp

    Um Ergebnisse zu speichern, die größer als 100 Zeilen in einem Objektspeicher-Bucket sind, wählen Sie im Agent-Endpunkt die Option Speicher großer Ausgabeergebnisse aktivieren aus.
  9. (Optional) Wählen Sie unter SQL-Korrektur aktivieren aus, ob die Selbstkorrektur aktiviert oder deaktiviert werden soll.

    Aktivieren Sie die Selbstkorrektur, um die Abfrage zu korrigieren, wenn während der Ausführung ein Fehler zurückgegeben wird. Sie sollten die Selbstkorrektur nicht aktivieren, um eine schnellere Ausführung bei einfacheren Abfragen zu ermöglichen.

  10. (Optional) Geben Sie unter Benutzerdefinierte Anweisungen Text ein, der den Agent auffordert, sich spezifischer zu verhalten.

    Beispiele:

    Always use aggregators such as COUNT, SUM, AVG, MIN, MAX in Oracle SQL queries that contain GROUP BY.

  11. (Optional) Wählen Sie unter Beschreibung der Tabellen und Spalten eine der folgenden Optionen aus, um detailliertere Beschreibungen der in der Datenbank verwendeten Tabellen und Spalten anzugeben.
    • Inline: Geben Sie eine Zeichenfolge ein.

      Beispiele:

      birthYear      Year employee was born
birthMonth     Month employee was born
    • Aus Objektspeicher auswählen: Wählen Sie ein Compartment und einen Bucket aus. Wählen Sie dann die Datei .txt aus, die beschreibenden Text für die Datenbanktabellen und -spalten enthält.
    • Keine: Keine Beschreibung anzugeben.
  12. Wählen Sie Tool erstellen aus.
Tipp

Führen Sie einen der folgenden Schritte durch:

  • Wenn Sie einen Agent erstellen, gehen Sie zurück zu Agent in Generative AI Agents erstellen, um ein anderes Tool oder einen Endpunkt zu erstellen.
  • Wenn Sie das Tool einem vorhandenen Agent hinzugefügt haben, wählen Sie auf der Detailseite des Agent nach dem Aktivieren des Tools die Option Chat starten aus, um mit dem Agent mit diesem Tool zu chatten.
  • Wenn Sie den Agent ohne Endpunkt erstellt haben und den Agent verwenden möchten, erstellen Sie einen Endpunkt für diesen Agent.
Hinweis

Um eine generierte Abfrage zu überwachen und zu bearbeiten, bevor sie an den Benutzer gesendet wird, wählen Sie das optionale Feature Mensch in der Schleife aktivieren im Agent-Endpunkt aus.