Oracle Cloud Infrastructure-Dokumentation

Benutzerdefiniertes Funktionstool 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 Funktionstools angezeigt.

Funktionstool erstellen

  1. Wählen Sie Tool erstellen aus.
  2. Wählen Sie Benutzerdefiniertes Tool aus.
  3. (Optional) Geben Sie folgende Informationen ein:
    • Name: Ein Name für das benutzerdefinierte Tool, der mit einem Buchstaben oder Unterstrich beginnt, gefolgt von Buchstaben, Zahlen, Bindestrichen oder Unterstrichen. Die Länge kann zwischen 1 und 255 Zeichen betragen.
    • Beschreibung: Eine optionale Beschreibung.
  4. Wählen Sie unter Toolkonfiguration die Option Funktionsaufruf aus.
  5. Geben Sie folgende Informationen ein:
    • Name: Ein Name für die Funktion, der mit einem Buchstaben oder Unterstrich beginnt, gefolgt von Buchstaben, Zahlen, Bindestrichen oder Unterstrichen. Die Länge kann zwischen 1 und 255 Zeichen betragen.
    • Beschreibung: Eine optionale Beschreibung.
  6. Geben Sie für die Funktionsparameter die Parameter ein, die von der Funktion in einem JSON-Format akzeptiert werden.
    Hier finden Sie einige Beispiele:
    // Get Compute Instance Details
{
            "name": "get_compute_instance_details",
            "description": "Fetch details of an OCI Compute instance given an instance OCID.",
            "parameters": {
                "type": "object",
                "properties": {
                    "instance_ocid": {
                        "type": "string",
                        "description": "The OCID of the compute instance."
                    },
                    "compartment_ocid": {
                        "type": "string",
                        "description": "The OCID of the compartment containing the instance."
                    }
                },
                "required": ["instance_ocid"],
                "additionalProperties": false
            }
        }


// Create an Object Storage Bucket
{
            "name": "create_object_storage_bucket",
            "description": "Creates a new bucket in OCI Object Storage within a specified compartment.",
            "parameters": {
                "type": "object",
                "properties": {
                    "bucket_name": {
                        "type": "string",
                        "description": "The name of the bucket to create."
                    },
                    "compartment_ocid": {
                        "type": "string",
                        "description": "The OCID of the compartment where the bucket will be created."
                    },
                    "storage_tier": {
                        "type": "string",
                        "enum": ["Standard", "Archive"],
                        "description": "The storage tier for the bucket."
                    }
                },
                "required": ["bucket_name", "compartment_ocid"],
                "additionalProperties": false
            }
        }


// Check Database Service Status
{
            "name": "check_database_status",
            "description": "Checks the operational status of an OCI Autonomous Database instance.",
            "parameters": {
                "type": "object",
                "properties": {
                    "db_ocid": {
                        "type": "string",
                        "description": "The OCID of the database instance."
                    }
                },
                "required": ["db_ocid"],
                "additionalProperties": false
            }
        }

// List Available Load Balancers
{
            "name": "list_load_balancers",
            "description": "Lists all load balancers in the given compartment in OCI.",
            "parameters": {
                "type": "object",
                "properties": {
                    "compartment_ocid": {
                        "type": "string",
                        "description": "The OCID of the compartment containing the load balancers."
                    }
                },
                "required": ["compartment_ocid"],
                "additionalProperties": false
            }
        }
  7. Wählen Sie Tool erstellen aus.
  8. Prüfen Sie die Schritte unter Funktion mit dem Java-SDK einrichten.
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.