DBMS_CLOUD_AI_AGENT-Package

Dieses Package definiert und verwaltet Select AI-Agents, -Aufgaben, -Tools und -Orchestrierung.

Zusammenfassung der DBMS_CLOUD_AI_AGENT-Unterprogramme

In diesem Abschnitt werden die DBMS_CLOUD_AI_AGENT-Unterprogramme des Select AI Agent beschrieben, die mit der autonomen KI-Datenbank bereitgestellt werden.

Unterprogramm Beschreibung
CREATE_AGENT - Prozedur Mit dieser Prozedur wird ein Agent erstellt.
CREATE_AGENT-Attribute Stellt Attribute für die Erstellung eines Agent bereit.
ENABLE_AGENT-Prozedur Mit dieser Prozedur wird ein Agent aktiviert.
Prozedur DISABLE_AGENT Mit diesem Verfahren wird ein Agent deaktiviert.
Prozedur DROP_AGENT Bei diesem Verfahren wird ein vorhandener Agent gelöscht.
Prozedur CREATE_TASK Mit diesem Verfahren wird eine Aufgabe erstellt, die ein Agent- und ein Agent-Team enthalten kann.
CREATE_TASK-Attribute Gibt Attribute zum Erstellen einer Agent-Aufgabe an.
Prozedur ENABLE_TASK Diese Prozedur aktiviert eine Agent-Aufgabe.
Prozedur DISABLE_TASK Mit diesem Verfahren wird eine Agent-Aufgabe deaktiviert.
Prozedur DROP_TASK Mit diesem Verfahren wird eine vorhandene Agent-Aufgabe gelöscht.
Prozedur CREATE_TOOL In diesem Verfahren werden benutzerdefinierte Tools erstellt, die ein Agent enthalten kann.
CREATE_TOOL-Attribute Bietet Attribute für die Erstellung von Tools.
Prozedur ENABLE_TOOL Dieses Verfahren ermöglicht ein Tool.
Prozedur DISABLE_TOOL Dieses Verfahren deaktiviert ein Tool.
DROP_TOOL-Prozedur Dieses Verfahren löscht ein vorhandenes Tool.
Prozedur CREATE_TEAM Dieses Verfahren erstellt ein Agent-Team und umfasst Agents und Aufgaben.
CREATE_TEAM-Attribute Gibt Attribute für die Erstellung eines Agent-Teams an.
SET_TEAM (Funktion) Mit diesem Verfahren wird das Agent-Team in der aktuellen Session festgelegt.
GET_TEAM-Funktion Diese Prozedur gibt das Agent-Team zurück, das in der aktuellen Session festgelegt wurde.
CLEAR_TEAM-Funktion Mit diesem Verfahren wird das in der aktuellen Session eingestellte Agent-Team gelöscht.
RUN_TEAM (Funktion) Mit dieser Prozedur wird ein neuer Agent erstellt oder ein angehaltener Agent ausgeführt.
Prozedur SET_ATTRIBUTE Diese Prozedur legt einen Attributwert für einen Agent, eine Aufgabe, ein Tool oder ein Team fest.
Prozedur SET_ATTRIBUTES In diesem Verfahren werden Attribute für einen Agent, eine Aufgabe, ein Tool oder ein Team festgelegt.
ENABLE_TEAM-Prozedur Mit diesem Verfahren wird ein Agent-Team aktiviert.
Prozedur DISABLE_TEAM Mit diesem Verfahren wird ein Agent-Team deaktiviert.
DROP_TEAM - Prozedur Bei diesem Verfahren wird ein vorhandenes Agent-Team gelöscht.
Funktion DESCRIBE_TOOL Gibt Metadaten- und Eingabeschemainformationen für ein Select AI Agent-Tool zurück.
RUN_TOOL-Funktion Ruft ein Select AI Agent-Tool nach Namen mit einer JSON-Eingabe-Payload auf.
LIST_TEAMS-Funktion Listet Agent-Teams auf, die für den aufrufenden Benutzer verfügbar sind.
Funktion DESCRIBE_TEAM Gibt Metadaten und aggregierte Funktionen für ein ausgewähltes Agent-Team zurück.
Funktion GET_TEAM_STATE Gibt den letzten Ausführungsstatus für eine Agent-Teamunterhaltung zurück.
Prozedur SET_EXECUTION_STATE Aktualisiert den Ausführungsstatus eines wartenden Teams, z.B. indem eine interaktive Session als erfolgreich markiert wird.
EXPORT_TEAM-Funktion Diese Funktion exportiert ein Select AI-Agent-Team in ein CLOB.
Prozedur EXPORT_TEAM Bei dieser Prozedur wird die exportierte Teamdefinition in eine Object Storage-URI oder in eine Datenbankverzeichnisdatei geschrieben.
IMPORT_TEAM Prozedur Diese Prozedur importiert eine Select AI Agent-Teamspezifikation in die Datenbank.
GET_DEFINITION (Funktion) Gibt kanonische ausführbare PL/SQL-Datei für einen Agent, eine Aufgabe, ein Tool oder ein Team zurück.
Prozedur GRANT_TEAM_ACCESS Erteilt einem Benutzer oder einer Rolle Zugriff auf die Ausführung eines Agent-Teams.
Prozedur REVOKE_TEAM_ACCESS Entzieht eine Benutzer- oder Rollenberechtigung für ein Agent-Team.
Funktion GET_VARIABLE Liest eine Laufzeitvariable mit Namespace.
SET_VARIABLE - Prozedur Legt eine Laufzeitvariable im Namespace fest oder löscht sie.

Prozedur CREATE_AGENT

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.CREATE_AGENT, um einen neuen AI-Agent im Select AI Agent-Framework zu registrieren. Definieren Sie die Identität des Agent mit agent_name, konfigurieren Sie sein Verhalten mit dem Attributparameter, und geben Sie optional eine Beschreibung an.

Syntax

DBMS_CLOUD_AI_AGENT.CREATE_AGENT(
     agent_name          IN  VARCHAR2,
     attributes          IN  CLOB,
     status              IN  VARCHAR2  DEFAULT NULL,
     description         IN  CLOB      DEFAULT NULL
  );

Parameter

Parameter Beschreibung
agent_name

Ein Name für den AI-Agent. Der Agent-Name muss den Benennungsregeln der Oracle SQL-ID entsprechen. Der Name darf maximal 125 Zeichen lang sein.

Dies ist ein obligatorischer Parameter.

attributes Benutzerdefinierte Attribute für den AI-Agent. Weitere Informationen finden Sie unter CREATE_AGENT-Attribute.
status

Status des Agent.

Der Standardwert ist enabled.

description

Benutzerdefinierte Beschreibung für den AI-Agent.

Der Standardwert ist NULL.

Beispiel

Im folgenden Beispiel wird ein Agent zur Verarbeitung von Kundenproduktretouren erstellt. Ein vollständiges Beispiel finden Sie unter Beispiel: Product Return Agent erstellen.

BEGIN
  DBMS_CLOUD_AI_AGENT.CREATE_AGENT(
    agent_name => 'CustomerAgent',
    attributes => '{
       "profile_name": "GOOGLE",
                       "role": "You are an experienced customer agent who deals with customers return request."
     }'
  );
END;
/

PL/SQL procedure successfully completed.

CREATE_AGENT-Attribute

Diese Attribute definieren die Rolle eines Agent und den AI-Profilnamen.

Attribute

Attributname Standardwert Beschreibung
profile_name -

Das KI-Profil, das der Agent zum Senden einer Anforderung an LLM verwendet.

Dies ist ein obligatorischer Parameter.

role -

Definieren Sie die Funktion des Agents, und geben Sie dem Agent Kontext an. Wird an LLM gesendet.

Dies ist ein obligatorischer Parameter.

enable_human_tool True Ermöglichen Sie dem Agent, dem Benutzer Fragen zur Information oder Klärung zu stellen.
tools Keine Gibt die Tools an, auf die ein Agent zugreifen kann, wenn der Agent Tools direkt ausführt.
short_term_memory_length 30 Gibt die maximale Anzahl von Konversationsumdrehungen an, die in jedem LLM-Aufruf für eine Aufgabenausführung enthalten sind.
supervisor false Bestimmt den Agent als Supervisor, der ein beaufsichtigtes Team kontrollieren kann.

Im folgenden Beispiel wird gezeigt, wie Sie Agent-Attribute in der Prozedur anpassen können.

BEGIN
  DBMS_CLOUD_AI_AGENT.CREATE_AGENT(
    agent_name => 'Customer_Return_Agent',
    attributes => '{
       "profile_name": "GOOGLE",
                       "role": "You are an experienced customer agent who deals with customers return request.",
			   "enable_human_tool": "False"
     }'
  );
END;
/

PL/SQL procedure successfully completed

Hinweise zur Verwendung

  • profile_name gibt das AI-Profil an, das für LLM-Aufrufe verwendet wird.
  • supervisor ist optional und hat standardmäßig den Wert false.
  • Setzen Sie supervisor nur für Agents auf true, die das Teamrouting steuern.
  • Nach der Agent-Erstellung können Sie die Supervisor-Option nicht mehr aktualisieren.
  • Verhindern Sie, dass mitarbeiterspezifische Aufgabenanweisungen aus dem Vorgesetzten entfernt werden, wenn möglich, und nehmen Sie sie in die Aufgaben eines Mitarbeiters auf.

Beispiel: Supervisor-Agent erstellen

In diesem Beispiel wird ein Supervisor-Agent erstellt, der ein Team steuern und Unteraufgaben an konfigurierte Mitarbeiter-Agents delegieren kann.

BEGIN
  DBMS_CLOUD_AI_AGENT.CREATE_AGENT(
    agent_name => 'ORCHESTRATOR_AGENT',
    attributes => '{
      "profile_name": "<AI_PROFILE_NAME>",
      "role": "Route requests to the appropriate worker agent.",
      "supervisor": true
    }',
    description => 'Routes subtasks to worker agents'
  );
END;
/

Prozedur ENABLE_AGENT

Diese Prozedur aktiviert den AI-Agent, den der Benutzer angibt. Die Prozedur ändert den Status des AI-Agent in ENABLED.

Syntax

DBMS_CLOUD_AI_AGENT.ENABLE_AGENT(
   agent_name           IN  VARCHAR2
);

Parameter

Parameter Beschreibung
agent_name

Name des zu aktivierenden AI-Agents.

Dieser Parameter ist obligatorisch.

Beispiel zum Aktivieren des AI-Profils

BEGIN
     DBMS_CLOUD_AI_AGENT.ENABLE_AGENT(
         agent_name    => 'Customer_Return_Agent'
     );
END;
/

Prozedur DISABLE_AGENT

Mit dieser Prozedur wird der AI-Agent in der aktuellen Datenbank deaktiviert. Der Status des AI-Agent wird durch diese Prozedur in DISABLED geändert.

Syntax

DBMS_CLOUD_AI_AGENT.DISABLE_AGENT(
   agent_name           IN  VARCHAR2
);

Parameter

Parameter Beschreibung
agent_name

Name für den AI-Agent.

Dieser Parameter ist obligatorisch.

Beispiel

BEGIN
     DBMS_CLOUD_AI_AGENT.DISABLE_AGENT(
         agent_name    => 'Customer_Return_Agent'
     );
END;
/

Prozedur DROP_AGENT

Die Prozedur löscht einen vorhandenen AI-Agent. Wenn der Agent nicht vorhanden ist, löst die Prozedur einen Fehler aus.

Syntax

DBMS_CLOUD_AI_AGENT.DROP_AGENT(
    agent_name          IN  VARCHAR2,
    force               IN  BOOLEAN DEFAULT FALSE
 );

Parameter

Parameter Beschreibung
agent_name

Name des AI-Agent.

Dies ist ein obligatorischer Parameter.

force

Wenn TRUE, ignoriert die Prozedur Fehler, wenn kein AI-Agent vorhanden ist.

Der Standardwert für diesen Parameter ist FALSE.

Beispiel

BEGIN
     DBMS_CLOUD_AI_AGENT.DROP_AGENT(agent_name => 'Customer_Return_Agent);
END;
/

Hinweise zur Verwendung

Verwenden Sie force, um einen Agent zu löschen und Fehler zu ignorieren, wenn kein AI-Agent vorhanden ist.

Prozedur CREATE_TASK

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.CREATE_TASK, um eine Aufgabe zu definieren, die ein Select AI-Agent in seinen Argumentationsprozess aufnehmen kann. Jede Aufgabe hat einen eindeutigen Namen und eine Gruppe von Attributen, die das Verhalten des Agents bei der Planung und Ausführung der Aufgabe angeben.

Sie können Abhängigkeiten zwischen Aufgaben mit dem Attribut input definieren, sodass Select AI die Ausgabe einer Aufgabe an eine andere übergeben kann. Dies unterstützt verkettetes Denken und mehrstufige Workflows.

Syntax

DBMS_CLOUD_AI_AGENT.CREATE_TASK(
     task_name           IN  VARCHAR2,
     attributes          IN  CLOB,
     status              IN  VARCHAR2  DEFAULT NULL,
     description         IN  CLOB      DEFAULT NULL
  );

Parameter

Parameter Beschreibung
task_name

Ein eindeutiger Name für die Aufgabe.

Dies ist ein obligatorischer Parameter.

attributes JSON-Objekt mit aufgabenspezifischen Attributen. Siehe CREATE_TASK-Attribute.
status

Status der Aufgabe.

Der Standardwert ist ENABLED.

description

Benutzerdefinierte Beschreibung zur Identifizierung der Aufgabe. Dieser Wert wird in der Datenbank gespeichert, aber nicht an das LLM gesendet.

Der Standardwert ist NULL.

Beispiel

Im folgenden Beispiel wird eine Aufgabe zur Verarbeitung einer Produktretoure von einem Kunden erstellt.

BEGIN
  DBMS_CLOUD_AI_AGENT.CREATE_TASK(
    task_name => 'Return_And_Price_Match',
    attributes => '{"instruction": "Process a product return request from a customer:{query}' ||
                    '1. Ask customer the reason for return (price match or defective)' ||
                    '2. If price match:' ||
                    '   a. Request customer to provide a price match link' ||
                    '   b. Use websearch tool to get the price for that price match link' ||
                    '   c. Ask customer if they want a refund.' ||
                    '   d. Send email notification only if customer accept the refund.' ||
                    '3. If defective:' ||
                     '   a. Process the defective return",
                    "tools": ["WebSearch", "Email"]}'
  );
END;
/

CREATE_TASK-Attribute

Diese Attribute definieren die Anweisungen und Tools des Agents, die für die Aufgabe verfügbar sind.

Attribute

Attributname Standardwert Beschreibung
instruction -

Eine klare, prägnante Aussage, die beschreibt, was die Aufgabe erfüllen sollte. Dieser Text ist in der Eingabeaufforderung enthalten, die an das LLM gesendet wird. Sie können einen Platzhalter {query} einfügen, um die Eingabe in natürlicher Sprache darzustellen. Beispiel:

SELECT AI AGENT \

Dies ist ein obligatorischer Parameter.

tools - Ein JSON-Array mit Toolnamen, mit denen der Agent die Aufgabe abschließen kann. Beispiel: "tools": ["RAG", "SQL", "WEBSEARCH", "NOTIFICATION"].
input - Gibt andere Aufgaben an, deren Ausgaben als Eingabe für diese Aufgabe verwendet werden sollen. Select AI stellt dem LLM diese Ausgaben automatisch zur Verfügung.
enable_human_tool -

Ermöglichen Sie dem Agent, dem Benutzer Fragen zu stellen, wenn während einer Aufgabe Informationen oder Klärungen erforderlich sind.

Der Standardwert ist "true".

Hinweis: Aufgabe enable_human_tool überschreibt das Attribut enable_human_tool des Agent. Wenn Agent enable_human_tool auf false und Aufgabe enable_human_tool auf true gesetzt ist, wird erwartet, dass das LLM während der Aufgabenausführung Fragen stellt.

Prozedur ENABLE_TASK

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.ENABLE_TASK, um eine zuvor definierte Aufgabe zu aktivieren. Dadurch wird der Status der Aufgabe in ENABLED geändert, sodass der Agent sie während der Verarbeitung verwenden kann.

Syntax

DBMS_CLOUD_AI_AGENT.ENABLE_TASK(
   task_name           IN  VARCHAR2
);

Parameter

Parameter Beschreibung
task_name

Name der zu aktivierenden Aufgabe.

Dieser Parameter ist obligatorisch.

Hinweise zur Verwendung

Die Aufgabe muss bereits im System vorhanden sein. Diese Prozedur aktualisiert den Aufgabenstatus und stellt ihn während der Logikworkflows für den Agent-Prozess zur Verfügung.

Beispiel für die Aktivierung einer Aufgabe

BEGIN
     DBMS_CLOUD_AI_AGENT.ENABLE_TASK(
         task_name    => 'Return_And_Price_Match'
     );
END;
/

Prozedur DISABLE_TASK

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.DISABLE_TASK, um eine Aufgabe in der aktuellen Datenbank zu deaktivieren. Dadurch wird der Status der Aufgabe in DISABLED geändert, sodass der Agent sie während der Verarbeitung nicht verwendet.

Syntax

DBMS_CLOUD_AI_AGENT.DISABLE_TASK(
   task_name           IN  VARCHAR2
);

Parameter

Parameter Beschreibung
task_name

Name der zu deaktivierenden Aufgabe.

Dieser Parameter ist obligatorisch.

Hinweise zur Verwendung

Wenn Sie eine Aufgabe deaktivieren, wird sie nicht gelöscht. Sie können sie später mit DBMS_CLOUD_AI_AGENT.ENABLE_TASK erneut aktivieren. Nach der Deaktivierung wird die Aufgabe inaktiv, und der Agent berücksichtigt sie bei der Aufgabenauswahl nicht mehr.

Beispiel

Im folgenden Beispiel wird eine vorhandene Aufgabe deaktiviert.

BEGIN
     DBMS_CLOUD_AI_AGENT.DISABLE_TASK(
         task_name    => 'Return_And_Price_Match'
     );
END;
/

Prozedur DROP_TASK

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.DROP_TASK, um eine zuvor definierte Aufgabe aus der Datenbank zu entfernen. Wenn die Aufgabe nicht vorhanden ist, können Sie den Fehler unterdrücken, indem Sie den Parameter force auf TRUE setzen.

Syntax

DBMS_CLOUD_AI_AGENT.DROP_TASK(
   task_name IN  VARCHAR2,
   force     IN  BOOLEAN DEFAULT FALSE
);

Parameter

Parameter Beschreibung
task_name

Name der zu löschenden Aufgabe.

Dies ist ein obligatorischer Parameter.

force

Wenn TRUE, ignoriert die Prozedur Fehler, wenn die Aufgabe nicht vorhanden ist.

Der Standardwert für diesen Parameter ist FALSE.

Beispiel

BEGIN
     DBMS_CLOUD_AI_AGENT.DROP_TASK(task_name => 'Return_And_Price_Match');
END;
/

Hinweise zur Verwendung

Verwenden Sie force, um eine Aufgabe zu löschen und Fehler zu ignorieren, wenn die Aufgabe nicht vorhanden ist.

Prozedur CREATE_TOOL

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.CREATE_TOOL, um ein benutzerdefiniertes Tool zu registrieren, das ein Agent während der Aufgabenverarbeitung verwenden kann. Jedes Tool wird durch eine eindeutige tool_name identifiziert und enthält Attribute, die seinen Zweck, seine Implementierungslogik und seine Metadaten definieren.

Die Tools können benutzerdefinierte PL/SQL-Funktionen oder integrierte Tooltypen wie RAG, SQL, WEBSEARCH oder NOTIFICATION sein.

Syntax

DBMS_CLOUD_AI_AGENT.CREATE_TOOL(
     tool_name          IN  VARCHAR2,
     attributes          IN  CLOB,
     status              IN  VARCHAR2  DEFAULT NULL,
     description         IN  CLOB      DEFAULT NULL
  );

Parameter

Parameter Beschreibung
tool_name

Ein eindeutiger Name zur Identifizierung des Tools.

Dies ist ein obligatorischer Parameter.

attributes

Toolattribute im JSON-Format. Siehe CREATE_TOOL-Attribute.

Dies ist ein obligatorischer Parameter.

status

Status des Tools.

Der Standardwert ist ENABLED.

description

Benutzerdefinierte Beschreibung zur Identifizierung des Tools. Dieser Wert wird in der Datenbank gespeichert, aber nicht an das LLM gesendet.

Der Standardwert ist NULL.

Beispiel

Im folgenden Beispiel wird ein SQL-Tool erstellt, um SQL aus einem vorhandenen NL2SQL-Profil zu generieren. Weitere Informationen finden Sie unter Beispiel: Integrierte Tools erstellen.

BEGIN
  DBMS_CLOUD_AI_AGENT.CREATE_TOOL(
    tool_name  => 'SQL',
    attributes => '{"tool_type": "SQL",
                    "tool_params": {"profile_name": "nl2sql_profile"}}'
  );
END;
/

CREATE_TOOL-Attribute

Diese Attribute stellen die Toolkonfiguration mit einem JSON-Objekt im Attributparameter bereit. Jedes Attribut konfiguriert, wie der Agent das Tool während der Argumentation verwendet.

Attribute

Attributname Standardwert Beschreibung
instruction -

Eine klare, prägnante Aussage, die beschreibt, was das Tool erreichen sollte und wie es zu tun ist. Dieser Text ist in der Eingabeaufforderung enthalten, die an das LLM gesendet wird.

Dies ist ein obligatorischer Parameter.

function -

Gibt die PL/SQL-Prozedur oder -Funktion an, die aufgerufen wird, wenn das Tool verwendet wird.

Dies ist ein obligatorischer Parameter für benutzerdefinierte Tools.

tool_type -

Gibt einen integrierten Tooltyp an. Wenn diese Option festgelegt ist, sind instruction und function nicht erforderlich.

Mögliche Werte sind:

  • SQL
  • RAG
  • WEBSEARCH
  • NOTIFICATION

Sie können integrierte Tools mit benutzerdefinierten Namen und Parametern erstellen. Sie können auch mehrere integrierte Tools mit demselben tool_type, aber einem anderen tool_params erstellen.

tool_params - Gibt Parameter für die Registrierung von integrierten Tools an.
tool_inputs -

Beschreibt Eingabeargumente. Ähnlich wie Spaltenkommentare in einer Tabelle. Beispiel:

"tool_inputs": [ 
{
"name": "data_guard",
"description": "Only supported values are "Enabled" and "Disabled""
}
]

Voraussetzungen für das integrierte Tool

Führen Sie die folgenden Schritte aus, bevor Sie integrierte Tools verwenden:

RAG-Tool
  1. Erstellen Sie ein AI-Profil, das einen Vektorindex referenziert. Siehe AI mit Retrieval Augmented Generation (RAG) auswählen.
Benachrichtigungstool

Die folgenden Elemente werden unterstützt: SLACK und EMAIL.

SLACK-Werkzeug:
  1. Richten Sie eine Slack-Anwendung ein, um Nachrichten von der autonomen KI-Datenbank zu empfangen.

  2. Erstellen Sie Zugangsdaten mit DBMS_CLOUD_NOTIFICATION, um Slack-Benachrichtigungen aus der autonomen KI-Datenbank zu senden. Siehe Slack-Benachrichtigungen aus Autonomous AI Database senden.

E-MAIL-Tool:

Hinweis

Hinweis: Das E-Mail-Tool sendet E-Mail-Benachrichtigungen von OCI.

  1. Geben Sie den SMTP-Endpunkt an. Beispiel: Wählen Sie einen der SMTP-Endpunkte aus:
    smtp.us-phoenix-1.oraclecloud.com
    smtp.us-ashburn-1.oraclecloud.com
    smtp.email.uk-london-1.oci.oraclecloud.com
    smtp.email.eu-frankfurt-1.oci.oraclecloud.com
  2. SMTP-Zugriff mit einer ACL erteilen Siehe SMTP-Verbindung konfigurieren.

  3. Generieren Sie SMTP-Zugangsdaten für E-Mail-Zustellung. Das Package UTL_SMTP verwendet Zugangsdaten zur Authentifizierung bei E-Mail-Zustellungsservern, wenn Sie eine E-Mail versenden. Weitere Informationen finden Sie unter SMTP-Zugangsdaten für einen Benutzer generieren.

  4. Genehmigte Absender erstellen Führen Sie diesen Schritt für alle E-Mail-Adressen aus, die Sie als From-Adresse mit dem Unterprogramm UTL_SMTP.MAIL verwenden. Weitere Informationen finden Sie unter Genehmigte Absender verwalten.

  5. Erteilen Sie dem Benutzer SMTP-Zugriff, indem Sie Access Control Entry (ACE) hinzufügen. Weitere Details finden Sie unter E-Mails aus autonomer KI-Datenbank mit DBMS_CLOUD_NOTIFICATION senden.

Integrierte Tooltypen im DBMS_CLOUD_AI_AGENT-Package

Sie können integrierte Tools mit den Attributen tool_type und tool_params registrieren.

Tooltyp Beschreibung Obligatorische Parameter
SQL Übersetzt natürliche Sprache in SQL-Abfragen.

Hinweis: Das integrierte SQL-Tool verwendet Select AI-Aktionen, wie runsql, showsql und explainsql, um datenbankbezogene Prompts zu verarbeiten. Das integrierte Tool enthält Standardanweisungen, die das Verhalten und die Verwendung dieser Aktionen definieren. Sie können das Standardverhalten ergänzen, indem Sie das Attribut instruction in der Prozedur CREATE_TOOL verwenden, um zu bestimmen, wie der Agent einen Prompt der am besten geeigneten Aktion zuordnet.
profile_name
RAG Führt Retrieval-Augmented Generation durch Vektorsuche durch. profile_name
NOTIFICATION

Sendet Nachrichten an einen Slack-Kanal oder sendet E-Mails mit SMTP. Verfügbare Optionen:

  • slack
  • email

notification_type.

Wenn notification_type slack ist, sind credential_name und channel obligatorisch.

Wenn notification_type email ist, sind credential_name, recipient, sender und smtp_host obligatorisch.

WEBSEARCH Sucht Informationen aus dem Web. credential_name

Prozedur ENABLE_TOOL

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.ENABLE_TOOL, um ein zuvor erstelltes Tool zu aktivieren. Dadurch wird der Status des Tools in ENABLED geändert, sodass der Agent seine Aufgaben verwenden kann.

Syntax

DBMS_CLOUD_AI_AGENT.ENABLE_TOOL(
   tool_name           IN  VARCHAR2
);

Parameter

Parameter Beschreibung
tool_name

Name des zu aktivierenden Tools.

Dieser Parameter ist obligatorisch.

Beispiel

BEGIN
     DBMS_CLOUD_AI_AGENT.ENABLE_TOOL(
         tool_name    => 'SQL'
     );
END;
/

Prozedur DISABLE_TOOL

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.DISABLE_TOOL, um ein Tool zu deaktivieren. Dadurch wird der Status des Tools in DISABLED geändert, sodass der Agent ihn nicht in Aufgaben verwenden kann.

Syntax

DBMS_CLOUD_AI_AGENT.DISABLE_TOOL(
   tool_name           IN  VARCHAR2
);

Parameter

Parameter Beschreibung
tool_name

Name des zu deaktivierenden Werkzeugs.

Dieser Parameter ist obligatorisch.

Beispiel

Im folgenden Beispiel wird ein vorhandenes Tool deaktiviert.

BEGIN
     DBMS_CLOUD_AI_AGENT.DISABLE_TOOL(
         tool_name    => 'SQL'
     );
END;
/

Prozedur DROP_TOOL

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.DROP_TOOL, um ein zuvor erstelltes Tool mit dem Agent zu entfernen. Wenn die Aufgabe nicht vorhanden ist, können Sie den Fehler unterdrücken, indem Sie den Parameter force auf TRUE setzen.

Syntax

DBMS_CLOUD_AI_AGENT.DROP_TOOL(
   tool_name IN  VARCHAR2,
   force     IN  BOOLEAN DEFAULT FALSE
);

Parameter

Parameter Beschreibung
tool_name

Name des zu löschenden Werkzeugs.

Dies ist ein obligatorischer Parameter.

force

Wenn TRUE, ignoriert die Prozedur Fehler, wenn das Tool nicht vorhanden ist.

Der Standardwert für diesen Parameter ist FALSE.

Beispiel

BEGIN
     DBMS_CLOUD_AI_AGENT.DROP_TOOL(tool_name => 'SQL');
END;
/

Hinweise zur Verwendung

Verwenden Sie force, um ein Tool zu löschen und Fehler zu ignorieren, wenn das Tool nicht vorhanden ist.

Prozedur CREATE_TEAM

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.CREATE_TEAM, um ein Team von KI-Agents zu definieren, die zusammenarbeiten, um Aufgaben zu erledigen. Sie geben Agents und die zugehörigen Aufgaben sowie die Verarbeitung der Aufgaben an.

Syntax

DBMS_CLOUD_AI_AGENT.CREATE_TEAM(
   team_name    IN VARCHAR2,
   attributes   IN CLOB,
   status       IN VARCHAR2 DEFAULT NULL,
   description  IN CLOB     DEFAULT NULL
);

Parameter

Parameter Beschreibung
team_name

Ein eindeutiger Name zur Identifizierung des KI-Agent-Teams.

Dies ist ein obligatorischer Parameter.

attributes

JSON-formatierte Zeichenfolge, die Teamattribute wie Agents und Prozesse definiert. Siehe CREATE_TEAM-Attribute.

Dies ist ein obligatorischer Parameter.

status

Status des Teams.

Der Standardwert ist ENABLED.

description

Benutzerdefinierte Beschreibung zur Angabe des Zwecks des Teams. Dieser Wert wird in der Datenbank gespeichert, aber nicht an das LLM gesendet.

Der Standardwert ist NULL.

Beispiel

Im folgenden Beispiel wird ein Agent-Team erstellt, um die Produktretoure eines Kunden zu verarbeiten.

BEGIN
  DBMS_CLOUD_AI_AGENT.CREATE_TEAM(
    team_name  => 'ReturnAgency',
    attributes => '{"agents": [{"name":"Customer_Return_Agent","task" : "Return_And_Price_Match"}],
                    "process": "sequential"}');
END;
/

CREATE_TEAM-Attribute

Diese Attribute stellen die Konfiguration des AI-Agent-Teams bereit. Jedes Team hat eine eindeutige team_name und verwendet eine Gruppe von Attributen, um seine Struktur und Ausführungsstrategie zu definieren.

Attribute

Attributname Standardwert Beschreibung
agents -

Gibt JSON-Array mit Agents und den zugehörigen Aufgaben an. Ein Agent kann mehreren Aufgaben unter demselben Namen zugewiesen werden.

Dies ist ein obligatorischer Parameter.

Beispiel:

[ {"name": "", "task": "" ]
process - Gibt an, wie Aufgaben ausgeführt werden. Verwenden Sie "sequential", um Aufgaben nacheinander auszuführen.
long_term_memory_length 30 Gibt die maximale Anzahl früherer Übersichten auf Aufgabenebene an, die in der Systemaufforderung zu Beginn jeder neuen Ausführung als Speicherkontext enthalten sind.
supervisor_agent - Name des Vorgesetzten-Agents. Dieses Attribut ist für ein von einem Vorgesetzten geführtes Team erforderlich.

Hinweise zur Verwendung

Prüfen Sie die Teamattributregeln, bevor Sie ein beaufsichtigtes Team erstellen, damit die Zuordnungen von Vorgesetzten und Mitarbeitern getrennt bleiben.

Hinweis

Im Entwurf des Vorgesetzten ist die Verarbeitung der Unteraufgabe sequenziell: Das Vorgesetzten-Agent-Objekt delegiert jeweils eine Mitarbeiter-Unteraufgabe und wird fortgesetzt, nachdem der Mitarbeiter ein Ergebnis zurückgegeben hat, einschließlich eines Fehlerergebnisses.

  • supervisor_agent benennt das Supervisor-Agent-Objekt, das das Team kontrolliert.
  • agents listet Worker-Agent-Aufgabenpaare auf, die für die Delegierung verfügbar sind.
  • Listen Sie den ausgewählten Vorgesetzten nicht als Mitarbeiter im Array agents auf.
  • Verwenden Sie process mit der Teamdefinition. Für das anfängliche Vorgesetztendesign ist sequential erforderlich. Eine Mitarbeiterunteraufgabe muss abgeschlossen sein, bevor der Vorgesetzte die nächste Unteraufgabe delegiert.

Beispiel: Vorgesetztenteam erstellen

In diesem Beispiel wird ein beaufsichtigtes Team mit Konten- und Zahlungsmitarbeiter-Agent-Aufgabenpaaren erstellt, die für das Supervisor-Agentobjekt verfügbar sind.

BEGIN
  DBMS_CLOUD_AI_AGENT.CREATE_TEAM(
    team_name => 'CUSTOMER_SUPPORT',
    attributes => '{
      "process": "sequential",
      "supervisor_agent": "ORCHESTRATOR_AGENT",
      "agents": [
        {"name":"ACCOUNT_AGENT", "task":"ACCOUNT_MANAGEMENT_TASK"},
        {"name":"PAYMENT_AGENT", "task":"PAYMENT_MANAGEMENT_TASK"}
      ]
    }'
  );
END;
/

Funktion SET_TEAM

Verwenden Sie DBMS_CLOUD_AI_AGENT.SET_TEAM, um das AI-Agent-Team für die aktuelle Session anzugeben und eine optionale Laufzeitkonfiguration bereitzustellen.

Sobald ein Team festgelegt ist, wird nur die Aktion select ai agent aktiviert. Andere Select AI-Aktionen werden vom System nicht unterstützt.

Syntax

DBMS_CLOUD_AI_AGENT.SET_TEAM(
    team_name      IN  VARCHAR2,
    params         IN  CLOB DEFAULT NULL,
);

Parameter

Parameter Beschreibung
team_name

Gibt den Namen des AI-Agent-Teams an, das in der aktuellen Session verwendet werden soll. Das Team muss bereits im System vorhanden sein.

Dieser Parameter ist obligatorisch.

params

Gibt benutzerdefinierte Parameter an, die während des AI-Agent-Teamprozesses und des JSON-formatierten CLOBs mit Laufzeitparametern verwendet werden. Folgende Parameter werden unterstützt:

  • variables (deprecated) oder instruction_variables: Definieren Sie Schlüssel/Wert-Paare, die zusätzliche Eingaben für das Agent-Team bereitstellen. Diese Variablen helfen dabei, das Verhalten des Teams während des Prozesses anzupassen.
  • attribute_variables: Laufzeitwerte, die konfigurierbare Agent- oder Toolattribute angeben oder ersetzen, wie profile_name oder tool_params, ohne die gespeicherte Definition zu ändern.
  • state_variables: Laufzeitwerte, die den Status speichern und Informationen zwischen Tools während einer Teamausführung übergeben. Tools können diese Werte während der Ausführung lesen oder aktualisieren.

Zum Beispiel:

{"attribute_variables":{"llm_profile":"LLM_PROFILE_NAME"},"state_variables":{"request_context":"REQUEST_CONTEXT"}}

Hinweise zur Verwendung

  1. variables ist veraltet und wird als instruction_variables behandelt.
  2. Die mit SET_TEAM angegebenen Werte sind für spätere Ausführungen in derselben Session verfügbar, bis sie geändert oder gelöscht werden.
  3. Laufzeit params ändert keine permanenten Teammetadaten.
  4. Wenn SET_TEAM gültig ist, wird nur die Agent-Aktion unterstützt. Wenn Sie eine andere Aktion angeben, gibt das System eine Fehlermeldung aus, die angibt, dass die Aktion für die aktuelle Sitzung nicht unterstützt wird.

Beispiel

Im folgenden Beispiel wird das benutzerdefinierte AI-Agent-Team in der aktuellen Session festgelegt.

EXEC DBMS_CLOUD_AI_AGENT.SET_TEAM('ReturnAgency');

Im folgenden Beispiel werden Sessionlaufzeitparameter für ein gemeinsam verwendetes Team festgelegt.

BEGIN
  DBMS_CLOUD_AI_AGENT.SET_TEAM(
    team_name => 'TEAM_OWNER.SHARED_SUPPORT_TEAM',
    params    => '{"attribute_variables":{"llm_profile":"LLM_PROFILE_NAME"},"state_variables":{"request_id":"REQUEST_ID"}}');
END;
/

Funktion GET_TEAM

Verwenden Sie DBMS_CLOUD_AI_AGENT.GET_TEAM, um das AI-Agent-Team für die aktuelle Session zurückzugeben.

Syntax

DBMS_CLOUD_AI_AGENT.GET_TEAM RETURN VARCHAR2;

Beispiel

Im folgenden Beispiel wird das AI-Agent-Team in der aktuellen Session zurückgegeben.

SELECT DBMS_CLOUD_AI_AGENT.GET_TEAM from DUAL;

Funktion CLEAR_TEAM

Verwenden Sie DBMS_CLOUD_AI_AGENT.CLEAR_TEAM, um das in der aktuellen Session festgelegte AI-Agent-Team zu löschen. Diese Prozedur lässt das Team nicht fallen.

Syntax

DBMS_CLOUD_AI_AGENT.CLEAR_TEAM;

Beispiel

Im folgenden Beispiel wird das AI-Agent-Team in der aktuellen Session gelöscht.

BEGIN
  DBMS_CLOUD_AI_AGENT.CLEAR_TEAM;
END;
/

Funktion RUN_TEAM

Verwenden Sie DBMS_CLOUD_AI_AGENT.RUN_TEAM, um ein neues AI-Agent-Team zu starten oder ein unterbrochenes Team fortzusetzen, das auf menschliche Eingaben wartet. Wenn Sie eine vorhandene conversation_id angeben und der zugehörige Teamprozess den Status WAITING_FOR_HUMAN aufweist, wird der Workflow mit der Eingabe fortgesetzt, die Sie als menschliche Antwort angeben. Wenn Sie eine neue conversation_id angeben, startet RUN_TEAM einen neuen Unterhaltungsthread.

Ein gemeinsam verwendetes Team wird als Consumer in der initiierenden Datenbanksession ausgeführt.

Syntax

DBMS_CLOUD_AI_AGENT.RUN_TEAM(
     team_name               IN  VARCHAR2,
     user_prompt             IN  CLOB DEFAULT NULL,
     params                  IN  CLOB DEFAULT NULL,
  );

Parameter

Parameter Beschreibung
team_name

Gibt den Namen des AI-Agent-Teams an, das in der aktuellen Session verwendet werden soll. Das Team muss bereits im System vorhanden sein.

Dieser Parameter ist obligatorisch.

user_prompt

Gibt die Benutzerabfrage oder -antwort an, die für die Aufgabe angegeben wurde.

Wenn die Aufgabe den Status RUNNING aufweist, fungiert die Eingabe als Platzhalter für die {query} in der Aufgabenanweisung.

Wenn die Aufgabe den Status WAITING_FOR_HUMAN aufweist, dient die Eingabe als menschliche Antwort.

params

Gibt benutzerdefinierte Parameter an, die während des AI-Agent-Teamprozesses und des JSON-formatierten CLOBs mit Laufzeitparametern verwendet werden. Folgende Parameter werden unterstützt:

  • conversation_id: Gibt die Unterhaltungssession an, die dem Agent-Team zugeordnet ist. Verwenden Sie diesen Parameter für zustandslose Anwendungsintegrationen (z.B. APEX), um zwischen verschiedenen Benutzerverbindungen zu unterscheiden.
  • variables (deprecated) oder instruction_variables: Definieren Sie Schlüssel/Wert-Paare, die zusätzliche Eingaben für das Agent-Team bereitstellen. Diese Variablen helfen dabei, das Verhalten des Teams während des Prozesses anzupassen.
  • attribute_variables: Laufzeitwerte, die konfigurierbare Agent- oder Toolattribute angeben oder ersetzen, wie profile_name oder tool_params, ohne die gespeicherte Definition zu ändern.
  • state_variables: Laufzeitwerte, die den Status speichern und Informationen zwischen Tools während einer Teamausführung übergeben. Tools können diese Werte während der Ausführung lesen oder aktualisieren.

Zum Beispiel:

{"conversation_id":"CONVERSATION_ID","attribute_variables":{"llm_profile":"LLM_PROFILE_NAME"},"instruction_variables":{"audience":"support analyst"},"state_variables":{"request_context":"REQUEST_CONTEXT"}}

Hinweise zur Verwendung

  • RUN_TEAM gibt das Endergebnis der letzten Aufgabe als CLOB zurück.
  • Wenn ein Prozess auf eine menschliche Eingabe wartet, gibt RUN_TEAM Statusinformationen zurück oder setzt den wartenden Schritt fort, wenn Sie den erforderlichen Ausführungskontext und die erforderliche Eingabe angeben.
  • Die an RUN_TEAM übergebene Runlevel params hat Vorrang vor der mit SET_TEAM festgelegten Sessionebene params.
  • Ein gemeinsam verwendetes Team wird mit den Berechtigungen des Consumers in der Datenbanksession ausgeführt, in der die Ausführung gestartet wird.
  • Ein benutzerdefiniertes PL/SQL-Tool folgt der Einstellung AUTHID seiner Funktion. Eine Funktion AUTHID CURRENT_USER verwendet die Berechtigungen des Verbrauchers, während eine Funktion "Definer-Rights" die Berechtigungen des Eigentümers verwendet. Der Zugriff auf ein freigegebenes Team erteilt der Consumer-Berechtigung EXECUTE für eine benutzerdefinierte Funktion oder keinen Zugriff auf Ressourcen, die für die Funktion erforderlich sind.

Beispiel

Im folgenden Beispiel wird das benutzerdefinierte AI-Agent-Team in der aktuellen Session ausgeführt.

l_final_answer := DBMS_CLOUD_AI_AGENT.RUN_TEAM(
  team_name => 'ReturnAgency',
  user_prompt => 'I want to return computer desk chair',
  params => '{"conversation_id": "' \|\|l_conversation_id \|\| '"}'
);

Im folgenden Beispiel wird ein gemeinsames Team mit Laufzeitparametern ausgeführt.

DECLARE
  l_result CLOB;
BEGIN
  l_result := DBMS_CLOUD_AI_AGENT.RUN_TEAM(
    team_name   => 'TEAM_OWNER.SHARED_SUPPORT_TEAM',
    user_prompt => 'Summarize the account status for ACCOUNT_NAME.',
    params      => '{"attribute_variables":{"llm_profile":"LLM_PROFILE_NAME"},"state_variables":{"request_context":"REQUEST_CONTEXT"},"conversation_id":"CONVERSATION_ID"}');
END;
/

Prozedur SET_ATTRIBUTE

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.SET_ATTRIBUTE, um einen Attributwert für einen Agent, eine Aufgabe, ein Tool oder ein Team festzulegen.

Syntax

DBMS_CLOUD_AI_AGENT.SET_ATTRIBUTE(
  object_name     IN VARCHAR2,
  object_type     IN VARCHAR2,
  attribute_name  IN VARCHAR2,
  attribute_value IN {BOOLEAN | VARCHAR2}
);

DBMS_CLOUD_AI_AGENT.SET_ATTRIBUTE(
  object_name     IN VARCHAR2,
  object_type     IN VARCHAR2,
  attribute_name  IN VARCHAR2,
  attribute_value IN CLOB DEFAULT NULL
);

Parameter

Parameter Beschreibung Erforderlich
object_name Name des Agents, der Aufgabe, des Tools oder des Teams. Ja
object_type Typ des Objekts. Gültige Werte sind 'agent', 'task', 'tool' und 'team'. Ja
attribute_name Name des festzulegenden Objektattributs. Ja
attribute_value Wert, der dem Attribut zugewiesen werden soll. Die dokumentierten Wertetypen sind BOOLEAN, CLOB, NUMBER und VARCHAR2. Die Überladung CLOB ist standardmäßig NULL. Nein

Hinweise zur Verwendung

  • SET_ATTRIBUTE legt ein Attribut für das angegebene Objekt fest.
  • Verwenden Sie die Überladung, die mit dem Attributwerttyp übereinstimmt.

Beispiel

Legen Sie das Attribut profile_name für den Agent CUSTOMERAGENT fest:

BEGIN
  DBMS_CLOUD_AI_AGENT.SET_ATTRIBUTE(
    object_name     => 'CUSTOMERAGENT',
    object_type     => 'agent',
    attribute_name  => 'profile_name',
    attribute_value => 'GOOGLE'
  );
END;
/

Prozedur SET_ATTRIBUTES

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.SET_ATTRIBUTES, um Attribute für einen Agent, eine Aufgabe, ein Tool oder ein Team festzulegen.

Syntax

DBMS_CLOUD_AI_AGENT.SET_ATTRIBUTES(
  object_name IN VARCHAR2,
  object_type IN VARCHAR2,
  attributes  IN CLOB
);

Parameter

Parameter Beschreibung Erforderlich
object_name Name des Objekts. Ja
object_type Typ des Objekts. Gültige Werte sind 'agent', 'task', 'tool' und 'team'. Ja
attributes Attributdaten, die für das Objekt festgelegt werden. Der Parameter ist ein CLOB. Ja

Beispiel

Legen Sie Attribute für den Agent CUSTOMERAGENT fest:

BEGIN
  DBMS_CLOUD_AI_AGENT.SET_ATTRIBUTES(
    object_name => 'CUSTOMERAGENT',
    object_type => 'agent',
    attributes  => '{
      "profile_name": "GOOGLE",
      "role": "airline analytics SQL assistant",
      "short_term_memory_length": "30"
    }'
  );
END;
/

Prozedur ENABLE_TEAM

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.ENABLE_TEAM, um ein benutzerdefiniertes AI-Agent-Team zu aktivieren. Dadurch wird der Status des Teams in ENABLED geändert.

Syntax

DBMS_CLOUD_AI_AGENT.ENABLE_TEAM(
   team_name           IN  VARCHAR2
);

Parameter

Parameter Beschreibung
team_name

Name des zu aktivierenden KI-Agent-Teams.

Dieser Parameter ist obligatorisch.

Beispiel

Im folgenden Beispiel wird ein benutzerdefiniertes AI-Agent-Team aktiviert.

BEGIN
     DBMS_CLOUD_AI_AGENT.ENABLE_TEAM(
         team_name    => 'ReturnAgency'
     );
END;
/

Prozedur DISABLE_TEAM

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.DISABLE_TEAM, um ein vorhandenes AI-Agent-Team zu deaktivieren. Dadurch wird der Status des Teams in DISABLED geändert.

Syntax

DBMS_CLOUD_AI_AGENT.DISABLE_TEAM(
   team_name           IN  VARCHAR2
);

Parameter

Parameter Beschreibung
team_name

Name des zu deaktivierenden AI-Agent-Teams.

Dieser Parameter ist obligatorisch.

Beispiel

Im folgenden Beispiel wird ein vorhandenes AI-Agent-Team deaktiviert.

BEGIN
     DBMS_CLOUD_AI_AGENT.DISABLE_TEAM(
         team_name    => 'ReturnAgency'
     );
END;
/

Prozedur DROP_TEAM

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.DROP_TEAM, um ein zuvor erstelltes AI-Agent-Team zu entfernen.

Syntax

DBMS_CLOUD_AI_AGENT.DROP_TEAM(
   team_name IN  VARCHAR2,
   force     IN  BOOLEAN DEFAULT FALSE
);

Parameter

Parameter Beschreibung
team_name

Name des abzugebenden Teams.

Dies ist ein obligatorischer Parameter.

force

Wenn TRUE, ignoriert die Prozedur Fehler, wenn das Team nicht vorhanden ist.

Der Standardwert für diesen Parameter ist FALSE.

Beispiel

BEGIN
     DBMS_CLOUD_AI_AGENT.DROP_TEAM(team_name => 'ReturnAgency');
END;
/

Hinweise zur Verwendung

Mit force können Sie ein Team löschen und Fehler ignorieren, wenn das Team nicht vorhanden ist.

Funktion DESCRIBE_TOOL

Verwenden Sie die Funktion DBMS_CLOUD_AI_AGENT.DESCRIBE_TOOL, um JSON-Metadaten für ein Tool zurückzugeben. Das Ergebnis enthält den Toolnamen, die Beschreibung, die Attribute und die Informationen zum Eingabeschema, die ein MCP-kompatibler Client für die Tool-Discovery verwenden kann.

Syntax

DBMS_CLOUD_AI_AGENT.DESCRIBE_TOOL(
  tool_name IN VARCHAR2
) RETURN CLOB;

Parameter

Parameter Beschreibung
tool_name Name des Select AI Agent-Tools, dessen Metadaten zurückgegeben werden.

Retouren

Gibt eine CLOB zurück, die JSON-formatierte Toolmetadaten und Argumentinformationen enthält.

Beispiel

DECLARE
  l_result CLOB;
BEGIN
  l_result := DBMS_CLOUD_AI_AGENT.DESCRIBE_TOOL(
    tool_name => 'FETCH_LOG_TOOL'
  );

  DBMS_OUTPUT.PUT_LINE(l_result);
END;
/

RUN_TOOL-Funktion

Verwenden Sie die Funktion DBMS_CLOUD_AI_AGENT.RUN_TOOL, um ein erstelltes Tool nach Namen aufzurufen. Der Eingabeparameter übergibt die Toolargumente als JSON-Payload.

Syntax

DBMS_CLOUD_AI_AGENT.RUN_TOOL(
  tool_name IN VARCHAR2,
  input IN CLOB
) RETURN CLOB;

Parameter

Parameter Beschreibung
tool_name Name des Tools "AI-Agent auswählen", das aufgerufen werden soll.
input JSON-Eingabe-Payload an das Tool übergeben.

Retouren

Gibt eine CLOB zurück, die das Toolausführungsergebnis enthält.

Beispiel

SELECT DBMS_CLOUD_AI_AGENT.RUN_TOOL(
  tool_name => 'FETCH_LOG_TOOL',
  input => '{"P_SINCE":"2026-01-01"}'
) AS tool_result
FROM dual;

LIST_TEAMS-Funktion

Mit der Funktion DBMS_CLOUD_AI_AGENT.LIST_TEAMS können Sie Agent-Teams auflisten, die für den aufrufenden Benutzer verfügbar sind. Das Ergebnis kann von A2A-kompatiblen Integrationsschichten für die Teamerkennung verwendet werden.

Syntax

DBMS_CLOUD_AI_AGENT.LIST_TEAMS
  RETURN CLOB;

Parameter

Parameter Beschreibung
Keine Diese Funktion hat keine Parameter.

Retouren

Gibt eine CLOB zurück, die ein JSON-Array enthält. Jeder Eintrag enthält den Teamnamen und die Beschreibung.

Beispiel

SELECT DBMS_CLOUD_AI_AGENT.LIST_TEAMS()
FROM dual;

Funktion DESCRIBE_TEAM

Verwenden Sie die Funktion DBMS_CLOUD_AI_AGENT.DESCRIBE_TEAM, um Metadaten für ein Agent-Team zurückzugeben. Die Funktion ordnet dem Team verfügbare AI-Agent-Tools der A2A-kompatiblen Skilldarstellung zu.

Syntax

DBMS_CLOUD_AI_AGENT.DESCRIBE_TEAM(
  team_name IN VARCHAR2
) RETURN CLOB;

Parameter

Parameter Beschreibung
team_name Name des Agent-Teams, dessen Metadaten und Funktionen zurückgegeben werden.

Retouren

Gibt eine CLOB zurück, die ein JSON-Objekt mit dem Teamnamen, der Beschreibung, der optionalen Version und der Qualifikationsliste enthält.

Hinweise zur Verwendung

  • Skills sind eine Protokolldarstellung von Tools für A2A-kompatible Clients. Sie führen keinen neuen Select AI Agent-Datenbankobjekttyp ein.

Beispiel

SELECT DBMS_CLOUD_AI_AGENT.DESCRIBE_TEAM('SUPPORT_TEAM')
FROM dual;

Funktion GET_TEAM_STATE

Mit der Funktion DBMS_CLOUD_AI_AGENT.GET_TEAM_STATE können Sie den letzten Ausführungsstatus für eine Agent-Teamunterhaltung zurückgeben.

Syntax

DBMS_CLOUD_AI_AGENT.GET_TEAM_STATE(
  team_name IN VARCHAR2,
  params IN CLOB DEFAULT NULL
) RETURN VARCHAR2;

Parameter

Parameter Beschreibung
team_name Name des Agent-Teams, dessen letzter Ausführungsstatus zurückgegeben wird.
params Optionales JSON-Objekt. Verwenden Sie conversation_id, um den letzten Ausführungsstatus für eine bestimmte Unterhaltung abzurufen. Wird diese Option ausgelassen, wird die Konversation der aktuellen Sitzung verwendet.

Retouren

Gibt einen VARCHAR2-Ausführungsstatus zurück, wie RUNNING, WAITING_FOR_HUMAN, SUCCEEDED oder FAILED.

Beispiel

SELECT DBMS_CLOUD_AI_AGENT.GET_TEAM_STATE(
  team_name => 'SUPPORT_TEAM',
  params => '{"conversation_id":"<CONVERSATION_ID>"}'
)
FROM dual;

Prozedur SET_EXECUTION_STATE

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.SET_EXECUTION_STATE, um einen wartenden Teamlauf in einen bestimmten Status zu aktualisieren. Dies ist nützlich für Agent-Direct-Tool-Aufrufworkflows, bei denen die Anwendung steuert, wann die interaktive Session abgeschlossen ist.

Syntax

DBMS_CLOUD_AI_AGENT.SET_EXECUTION_STATE(
  team_name IN VARCHAR2,
  state IN CLOB DEFAULT 'SUCCEEDED',
  params IN CLOB DEFAULT NULL
);

Parameter

Parameter Beschreibung
team_name Name des Agentteams, dessen Ausführungsstatus aktualisiert wird.
state Ausführungsstatus, der festgelegt werden soll. Der Standardwert ist SUCCEEDED.
params Optionales JSON-Objekt. Verwenden Sie conversation_id, um die Unterhaltung zu identifizieren, deren Ausführungsstatus aktualisiert wird.

Beispiel

BEGIN
  DBMS_CLOUD_AI_AGENT.SET_EXECUTION_STATE(
    team_name => 'CUSTOMER_AGENT_ONLY_TEAM',
    state => 'SUCCEEDED',
    params => '{"conversation_id":"<CONVERSATION_ID>"}'
  );
END;
/

Funktion DESCRIBE_TOOL

Verwenden Sie die Funktion DBMS_CLOUD_AI_AGENT.DESCRIBE_TOOL, um JSON-Metadaten für ein Tool zurückzugeben. Das Ergebnis enthält den Toolnamen, die Beschreibung, die Attribute und die Informationen zum Eingabeschema, die ein MCP-kompatibler Client für die Tool-Discovery verwenden kann.

Syntax

DBMS_CLOUD_AI_AGENT.DESCRIBE_TOOL(
  tool_name IN VARCHAR2
) RETURN CLOB;

Parameter

Parameter Beschreibung
tool_name Name des Select AI Agent-Tools, dessen Metadaten zurückgegeben werden.

Retouren

Gibt eine CLOB zurück, die JSON-formatierte Toolmetadaten und Argumentinformationen enthält.

Beispiel

DECLARE
  l_result CLOB;
BEGIN
  l_result := DBMS_CLOUD_AI_AGENT.DESCRIBE_TOOL(
    tool_name => 'FETCH_LOG_TOOL'
  );

  DBMS_OUTPUT.PUT_LINE(l_result);
END;
/

RUN_TOOL-Funktion

Verwenden Sie die Funktion DBMS_CLOUD_AI_AGENT.RUN_TOOL, um ein erstelltes Tool nach Namen aufzurufen. Der Eingabeparameter übergibt die Toolargumente als JSON-Payload.

Syntax

DBMS_CLOUD_AI_AGENT.RUN_TOOL(
  tool_name IN VARCHAR2,
  input IN CLOB
) RETURN CLOB;

Parameter

Parameter Beschreibung
tool_name Name des Tools "AI-Agent auswählen", das aufgerufen werden soll.
input JSON-Eingabe-Payload an das Tool übergeben.

Retouren

Gibt eine CLOB zurück, die das Toolausführungsergebnis enthält.

Beispiel

SELECT DBMS_CLOUD_AI_AGENT.RUN_TOOL(
  tool_name => 'FETCH_LOG_TOOL',
  input => '{"P_SINCE":"2026-01-01"}'
) AS tool_result
FROM dual;

LIST_TEAMS-Funktion

Mit der Funktion DBMS_CLOUD_AI_AGENT.LIST_TEAMS können Sie Agent-Teams auflisten, die für den aufrufenden Benutzer verfügbar sind. Das Ergebnis kann von A2A-kompatiblen Integrationsschichten für die Teamerkennung verwendet werden.

Syntax

DBMS_CLOUD_AI_AGENT.LIST_TEAMS
  RETURN CLOB;

Parameter

Parameter Beschreibung
Keine Diese Funktion hat keine Parameter.

Retouren

Gibt eine CLOB zurück, die ein JSON-Array enthält. Jeder Eintrag enthält den Teamnamen und die Beschreibung.

Beispiel

SELECT DBMS_CLOUD_AI_AGENT.LIST_TEAMS()
FROM dual;

Funktion DESCRIBE_TEAM

Verwenden Sie die Funktion DBMS_CLOUD_AI_AGENT.DESCRIBE_TEAM, um Metadaten für ein Agent-Team zurückzugeben. Die Funktion ordnet dem Team verfügbare AI-Agent-Tools der A2A-kompatiblen Skilldarstellung zu.

Syntax

DBMS_CLOUD_AI_AGENT.DESCRIBE_TEAM(
  team_name IN VARCHAR2
) RETURN CLOB;

Parameter

Parameter Beschreibung
team_name Name des Agent-Teams, dessen Metadaten und Funktionen zurückgegeben werden.

Retouren

Gibt eine CLOB zurück, die ein JSON-Objekt mit dem Teamnamen, der Beschreibung, der optionalen Version und der Qualifikationsliste enthält.

Hinweise zur Verwendung

  • Skills sind eine Protokolldarstellung von Tools für A2A-kompatible Clients. Sie führen keinen neuen Select AI Agent-Datenbankobjekttyp ein.

Beispiel

SELECT DBMS_CLOUD_AI_AGENT.DESCRIBE_TEAM('SUPPORT_TEAM')
FROM dual;

Funktion GET_TEAM_STATE

Mit der Funktion DBMS_CLOUD_AI_AGENT.GET_TEAM_STATE können Sie den letzten Ausführungsstatus für eine Agent-Teamunterhaltung zurückgeben.

Syntax

DBMS_CLOUD_AI_AGENT.GET_TEAM_STATE(
  team_name IN VARCHAR2,
  params IN CLOB DEFAULT NULL
) RETURN VARCHAR2;

Parameter

Parameter Beschreibung
team_name Name des Agent-Teams, dessen letzter Ausführungsstatus zurückgegeben wird.
params Optionales JSON-Objekt. Verwenden Sie conversation_id, um den letzten Ausführungsstatus für eine bestimmte Unterhaltung abzurufen. Wird diese Option ausgelassen, wird die Konversation der aktuellen Sitzung verwendet.

Retouren

Gibt einen VARCHAR2-Ausführungsstatus zurück, wie RUNNING, WAITING_FOR_HUMAN, SUCCEEDED oder FAILED.

Beispiel

SELECT DBMS_CLOUD_AI_AGENT.GET_TEAM_STATE(
  team_name => 'SUPPORT_TEAM',
  params => '{"conversation_id":"<CONVERSATION_ID>"}'
)
FROM dual;

Prozedur SET_EXECUTION_STATE

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.SET_EXECUTION_STATE, um einen wartenden Teamlauf in einen bestimmten Status zu aktualisieren. Dies ist nützlich für Agent-Direct-Tool-Aufrufworkflows, bei denen die Anwendung steuert, wann die interaktive Session abgeschlossen ist.

Syntax

DBMS_CLOUD_AI_AGENT.SET_EXECUTION_STATE(
  team_name IN VARCHAR2,
  state IN CLOB DEFAULT 'SUCCEEDED',
  params IN CLOB DEFAULT NULL
);

Parameter

Parameter Beschreibung
team_name Name des Agentteams, dessen Ausführungsstatus aktualisiert wird.
state Ausführungsstatus, der festgelegt werden soll. Der Standardwert ist SUCCEEDED.
params Optionales JSON-Objekt. Verwenden Sie conversation_id, um die Unterhaltung zu identifizieren, deren Ausführungsstatus aktualisiert wird.

Beispiel

BEGIN
  DBMS_CLOUD_AI_AGENT.SET_EXECUTION_STATE(
    team_name => 'CUSTOMER_AGENT_ONLY_TEAM',
    state => 'SUCCEEDED',
    params => '{"conversation_id":"<CONVERSATION_ID>"}'
  );
END;
/

EXPORT_TEAM-Funktion

Mit der Funktion DBMS_CLOUD_AI_AGENT.EXPORT_TEAM können Sie alle Agents, Aufgaben und zugehörigen Tools in einem Agent-Team in eine Zeichenfolge exportieren. Die Funktion verwendet team_name und optionales params als Eingabe und gibt die exportierte Teamdefinition als CLOB zurück.

Syntax

DBMS_CLOUD_AI_AGENT.EXPORT_TEAM(
    team_name                        IN VARCHAR2,
    params                           IN CLOB     DEFAULT NULL
  ) RETURN CLOB;

Parameter

Parameter Beschreibung
team_name Gibt den Namen des vorhandenen AI-Agent-Teams an, das exportiert werden soll. Dies ist ein obligatorischer Parameter.
params Optionale JSON-Parameter für Exportverhalten.

Hinweise zur Verwendung

  • EXPORT_TEAM exportiert die Teamdefinition und die zugehörigen Metadaten für das angegebene Select AI Agent-Team.

  • Der Export umfasst das Team und die zugehörigen Agents, Tools und Aufgaben, die Teil der Teamspezifikation sind.

  • Der Export enthält keine Zugangsdatendefinitionen oder Zugangsdatenkennwörter. Es werden nur referenzierte Zugangsdatennamen beibehalten, sofern zutreffend.

  • Der Export umfasst keine vom Benutzer erstellten unterstützenden Implementierungen außerhalb der exportierten Spezifikation. Diese ausgeschlossenen Abhängigkeiten umfassen PL/SQL-Prozeduren und -Funktionen von Kunden, die von Tools, externen REST-Services, OCI Functions, AWS Lambda-Funktionen, Netzwerk-ACLs und anderen externen Ressourcen verwendet werden.

  • Der Export der integrierten Select AI-Tools umfasst die Tooldefinition in der Team-Spezifikation.

  • Stellen Sie sicher, dass die erforderliche unterstützende Konfiguration in der Zielumgebung vorhanden ist, bevor Sie das exportierte Team importieren und verwenden.

  • Wenn das exportierte Team, Agents, Tools oder Aufgaben deaktiviert sind, enthält die exportierte Spezifikation Metadaten, die diese Komponenten als deaktiviert kennzeichnen.

  • Wenn "AI-Agent auswählen" beim Agent-Teamimport automatisch eine Aufgabe erstellt, weil die importierte Spezifikation keine Aufgabendefinition enthält, wird diese generierte Aufgabe nicht eingeschlossen, wenn das Agent-Team erneut exportiert wird. Es werden nur Aufgaben exportiert, die explizit im Agent-Team definiert sind.

  • Wenn die zurückgegebene CLOB groß ist, schreiben Sie sie in Blöcken, wenn Sie sie in einer Datei speichern.

Beispiel

Im folgenden Beispiel wird das ReturnAgency-Team in eine CLOB exportiert und die Ausgabe mit UTL_FILE in eine Datei geschrieben.

DECLARE
  output          clob;
  params_clob     clob;
  file_handler    UTL_FILE.FILE_TYPE;
BEGIN
  output := DBMS_CLOUD_AI_AGENT.EXPORT_TEAM(
              team_name => 'ReturnAgency'
  );
END;
/
/

Prozedur EXPORT_TEAM

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.EXPORT_TEAM, um eine Agent-Teamdefinition, einschließlich ihrer Agents, Aufgaben und zugehörigen Tooldefinitionen, in eine Zeichenfolge zu exportieren. Die Prozedur schreibt die exportierte Teamdefinition in eine Object Storage-URI oder in eine Datenbankverzeichnisdatei, wenn der Speicherortwert das Verzeichnisobjekt und den Dateinamen enthält. Die Prozedur nimmt eine optionale params als Eingabe an und gibt die exportierte Teamdefinition als CLOB zurück.

Syntax

DBMS_CLOUD_AI_AGENT.EXPORT_TEAM(
    team_name                        IN VARCHAR2,
    object_storage_credential_name   IN VARCHAR2,
    location                         IN VARCHAR2,
    params                           IN CLOB     DEFAULT NULL
  );

Parameter

Parameter Beschreibung
team_name

Gibt den Namen des vorhandenen AI-Agent-Teams an, das exportiert werden soll.

Dies ist ein obligatorischer Parameter.

object_storage_credential_name Zugangsdatenname für den Objektspeicherort, in dem Sie die exportierte Datei speichern möchten. Geben Sie diesen Parameter nicht an, wenn location eine Datenbankverzeichnisdatei identifiziert.
location Der Object Storage-Speicherort oder ein Datenbankverzeichnis, einschließlich des Dateinamens, in dem die Prozedur die exportierte Datei schreibt.
params

Optionale JSON-Parameter für Exportverhalten. Der Parameter overwrite ist der einzige unterstützte Parameter.

  • TRUE: Überschreibt eine vorhandene Datei mit demselben Namen.
  • FALSE: Verhindert das Überschreiben einer vorhandenen Datei mit demselben Namen.

Der Standardwert ist FALSE. Wenn Sie diesen Parameter weglassen, überschreibt der Vorgang keine vorhandene Datei.

Hinweise zur Verwendung

  • EXPORT_TEAM exportiert die Teamdefinition und die zugehörigen Metadaten für das angegebene Select AI Agent-Team.

  • Der Export umfasst das Team und die zugehörigen Agents, Tools und Aufgaben, die Teil der Teamspezifikation sind.

  • Der Export enthält keine Zugangsdatendefinitionen oder Zugangsdatenkennwörter. Es werden nur referenzierte Zugangsdatennamen beibehalten, sofern zutreffend.

  • Der Export umfasst keine vom Benutzer erstellten unterstützenden Implementierungen außerhalb der exportierten Spezifikation.

  • Der Export der integrierten Select AI-Tools umfasst die Tooldefinition in der Team-Spezifikation.

  • Stellen Sie sicher, dass die erforderliche unterstützende Konfiguration in der Zielumgebung vorhanden ist, bevor Sie das exportierte Team importieren und verwenden.

  • Wenn das exportierte Team, Agents, Tools oder Aufgaben deaktiviert sind, enthält die exportierte Spezifikation Metadaten, die diese Komponenten als deaktiviert kennzeichnen.

  • Wenn "AI-Agent auswählen" beim Agent-Teamimport automatisch eine Aufgabe erstellt, weil die importierte Spezifikation keine Aufgabendefinition enthält, wird diese generierte Aufgabe nicht eingeschlossen, wenn das Agent-Team erneut exportiert wird. Es werden nur Aufgaben exportiert, die explizit im Agent-Team definiert sind.

Beispiele

Im folgenden Beispiel wird das Team ReturnAgency exportiert und die exportierte Ausgabe in den angegebenen Object Storage-Speicherort geschrieben.

DECLARE
  output          clob;
  params_clob     clob;
BEGIN
  DBMS_CLOUD_AI_AGENT.export_team(
              team_name => 'ReturnAgency',
              object_storage_credential_name  => 'OBJ_STORAGE_CRED',
              location => 'https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/my_namespace/my_bucket/my_data_folder/return_agency.json',
	            params => '{"overwrite": true}'

  );
END;
/

Im folgenden Beispiel wird das ReturnAgency-Team in eine Datenbankverzeichnisdatei exportiert.

BEGIN
  DBMS_CLOUD_AI_AGENT.EXPORT_TEAM(
    team_name => 'ReturnAgency',
    location  => 'MY_DIR:return_agency.json'
  );
END;
/

IMPORT_TEAM Prozedur

Verwenden Sie die Prozedur DBMS_CLOUD_AI_AGENT.IMPORT_TEAM, um eine Agent-Teamspezifikation in die Datenbank zu importieren. Die Spezifikation kann Teammetadaten und zugehörige Agent-, Aufgaben- und Tooldefinitionen enthalten. Es importiert nur die Informationen, die in der Teamspezifikation und dem zugehörigen KI-Profil gespeichert sind. Sie können eine Spezifikationszeichenfolge, Object Storage-Zugangsdaten und -Speicherort oder einen Speicherort für Datenbankverzeichnisdateien angeben, um die Teamdefinition aus einer Datei zu importieren.

Syntax

DBMS_CLOUD_AI_AGENT.IMPORT_TEAM(
    profile_name                   IN VARCHAR2,
    team_name                      IN VARCHAR2 DEFAULT NULL,
    specification                  IN CLOB     DEFAULT NULL,
    object_storage_credential_name IN VARCHAR2 DEFAULT NULL,
    location                       IN VARCHAR2 DEFAULT NULL,
    force                          IN BOOLEAN  DEFAULT FALSE
);

Parameter

Parameter Beschreibung
profile_name

Geben Sie den Namen eines gültigen aktivierten KI-Profils an, das für das importierte Agent-Team verwendet werden soll. Importierte Agents verwenden dieses Profil, um Anforderungen an das LLM zu senden.

Dies ist ein obligatorischer Parameter.

team_name

Gibt den Namen des Agent-Teams an, das durch den Importvorgang erstellt wurde. Verwenden Sie einen Teamnamen, der nicht mit einem vorhandenen Teamnamen in Konflikt steht.

Dies ist ein obligatorischer Parameter.

specification Teamdefinition im JSON-Format.
object_storage_credential_name Zugangsdatenname für den Object Storage-Speicherort, der die Importdatei enthält. Geben Sie diesen Parameter nur an, wenn location eine Object Storage-Datei identifiziert. Geben Sie diesen Parameter nicht an, wenn der Speicherort eine Datenbankverzeichnisdatei identifiziert.
location Der Speicherort des Object Storage- oder Datenbankverzeichnisses, einschließlich des Dateinamens, aus dem die Prozedur die Teamdefinition importiert. Geben Sie entweder location oder specification an, nicht jedoch beides.
force Wenn dieser Wert auf TRUE gesetzt ist, werden widersprüchliche Komponenten gelöscht, die Importfehler verursachen, und die Teamdefinition wird importiert.

Hinweise zur Verwendung

  • IMPORT_TEAM importiert nur die Komponenten, die in der angegebenen Teamspezifikation definiert sind.

  • Beim Import werden das Team und die zugehörigen Agents, Tools und Aufgaben erstellt, die in der Spezifikation vorhanden sind.

  • Der Parameter specification und die Kombination aus object_storage_credential_name und location verwenden dasselbe Importverhalten. Der einzige Unterschied ist die Quelle des Spezifikationsinhalts.

  • Beim Import werden keine abhängigen Ressourcen erstellt, die nicht Teil der Spezifikation sind. Diese Ressourcen umfassen Zugangsdaten, vom Kunden erstellte PL/SQL-Prozeduren und -Funktionen, externe REST-Services, OCI Functions, AWS Lambda-Funktionen, Netzwerk-ACLs, Endpunkte, Profile, Indizes und andere externe unterstützende Ressourcen. Erstellen Sie diese Abhängigkeiten separat in der Zielumgebung, bevor Sie das importierte Team verwenden.

  • Integrierte Select AI-Tools erfordern keine manuelle Neuerstellung als importierte Komponentendefinitionen. Das erforderliche Umgebungssetup für diese Tools muss jedoch bereits in der Zieldatenbank vorhanden sein.

  • Wenn die Spezifikation keine Aufgabe enthält, kann DBMS_CLOUD_AI_AGENT beim Import automatisch eine Aufgabe erstellen. Bei dieser generierten Aufgabe handelt es sich um vom System erstellte Metadaten. Sie entspricht nicht einer Aufgabe, die explizit in der Quellspezifikation definiert ist.

  • Wenn force auf TRUE gesetzt ist, sucht der Import nach vorhandenen widersprüchlichen importierten Komponenten nach Namen, wie Agent, Tool oder Aufgabe. Wenn ein Konflikt auftritt, löscht der Import die vorhandene Komponente mit demselben Namen und erstellt diese Komponente aus der Importspezifikation neu. Dieses Verhalten gilt nur für unvereinbare importierte Komponenten.

  • Mit dieser Prozedur werden keine externen Abhängigkeiten oder zugehörigen Ressourcen gelöscht oder neu erstellt, die nicht Teil der Spezifikation sind, wie vom Kunden erstellte PL/SQL-Funktionen, Zugangsdaten oder Netzwerk-ACLs.

  • Wenn die importierte Spezifikation Metadaten enthält, die das Team, die Agents, Tools oder Aufgaben als deaktiviert kennzeichnen, importiert Select AI Agent diese Komponenten als deaktiviert.

Beispiele

Team aus einer Datei in Object Storage importieren

In diesem Beispiel wird eine Teamdefinition aus einer JSON-Datei importiert, die in Object Storage gespeichert ist. Verwenden Sie diese Methode, wenn Sie die Teamdefinition bereits in eine Datei exportiert haben. Im folgenden Beispiel wird das Team ReturnAgency importiert.

BEGIN
  DBMS_CLOUD_AI_AGENT.IMPORT_TEAM(
    profile_name                   => 'PROFILE_NAME',
    team_name                      => 'Marketing',
    object_storage_credential_name => 'cred1',
    location                       => 'https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/my_namespace/my_bucket/my_data_folder/return_agency.json'
  );
END;
/
Team aus einer Verzeichnisdatei importieren

Importieren Sie eine Select AI Agent-Teamdefinition aus einer JSON-Datei, die in einem Verzeichnisobjekt gespeichert ist. Der Parameter location gibt das Verzeichnisobjekt und den Dateinamen an.

BEGIN
    DBMS_CLOUD_AI_AGENT.import_team(
        profile_name 		=> 'PROFILE_NAME',
        team_name 		=> 'returnagency',
        location 		=> 'MY_DIR:return_agency.json'
  );
END;
/
Team aus einer Spezifikation importieren, die als CLOB übergeben wurde

In diesem Beispiel werden zuerst die erforderlichen vom Benutzer erstellten Funktionen erstellt. Anschließend wird das Team aus einer JSON-Spezifikation importiert, die in einer CLOB gespeichert ist. Verwenden Sie diese Methode, wenn Sie die Teamdefinition in PL/SQL erstellen oder ändern.

-- Create required functions first

CREATE OR REPLACE FUNCTION run_sql(nl_query IN CLOB)
RETURN CLOB
IS
  v_query CLOB;
BEGIN
  v_query := '(Name,Description,Category,Date Created,Price,Discounted Price,Offer Expiration Date)
("AquaPure Water Pitcher", "2-liter BPA-free water pitcher with filter", "Kitchen", "2024-04-12", 34.95, 27.95, "2024-07-01")
("CozyLuxe Throw Blanket", "Ultra-soft microfiber throw blanket (50""x60"")", "Living Room", "2024-03-22", 19.99, None, None)
("SafeStep Bath Mat", "Non-slip bath mat, mildew resistant, gray", "Bathroom", "2024-05-05", 12.50, 9.99, "2024-06-15")
("PowerPlug Extension", "6-outlet surge protector power strip", "Electrical", "2024-01-10", 21.75, None, None)
("FreshGuard Storage Bags", "Set of 20 reusable silicone food storage bags", "Kitchen", "2024-03-17", 15.60, 12.48, "2024-06-10")';

  RETURN v_query;
END run_sql;
/

CREATE OR REPLACE FUNCTION email(contents IN CLOB)
RETURN CLOB
IS
BEGIN
  DBMS_OUTPUT.PUT_LINE('>>>>>>>> Agent generated:' || CHR(10) ||
                       contents || CHR(10) ||
                       '<<<<<<<<<');
  RETURN 'Email sent successfully';
END email;
/

DECLARE
  l_input_json CLOB;
BEGIN
  l_input_json :=
  q'[
{
    "agents": [],
    "component_type": "Agent",
    "description": "You are a marketing agent who helps plan campaigns.",
    "flows": [],
    "id": "1d02da...",
    "inputs": [],
    "llm_config": {
        "component_type": "OCI_CONFIG",
        "default_generation_parameters": {
            "max_tokens": null,
            "temperature": null,
            "top_p": null
        },
        "description": null,
        "id": "9e2a1...",
        "metadata": {},
        "model_id": "gpt-5.5",
        "name": "openai/gpt-5.5"
    },
    "metadata": {},
    "name": "Marketing assistant",
    "outputs": [],
    "system_prompt": "Help the user with tasks around marketing products for their business.",
    "tools": [
        {
            "component_type": "ServerTool",
            "description": "Send an email to the current user.",
            "id": "9fcc6...",
            "inputs": [
                {
                    "title": "content",
                    "type": "string"
                }
            ],
            "metadata": {},
            "name": "Email",
            "outputs": [
                {
                    "type": "string"
                }
            ]
        },
        {
            "component_type": "ServerTool",
            "description": "Generates a SQL query for the given natural language question, runs it, and returns the results.",
            "id": "ae1e6...",
            "inputs": [
                {
                    "title": "nl_query",
                    "type": "string"
                }
            ],
            "metadata": {},
            "name": "run_sql",
            "outputs": [
                {
                    "type": "string"
                }
            ]
        }
    ]
}
]';

  DBMS_CLOUD_AI_AGENT.IMPORT_TEAM(
    profile_name  => 'PROFILE_NAME',
    team_name     => 'TEAM_NAME',
    specification => l_input_json
  );
END;
/

GET_DEFINITION (Funktion)

Mit der Funktion DBMS_CLOUD_AI_AGENT.GET_DEFINITION können Sie die kanonische PL/SQL-Definition eines vorhandenen AI-Agent-Objekts zurückgeben. Die Funktion rekonstruiert die Definition gemäß dem angeforderten Objekttyp über CREATE_AGENT, CREATE_TOOL, CREATE_TASK oder CREATE_TEAM.

Standardmäßig gibt die Funktion nur das angeforderte Objekt zurück. Setzen Sie "dependent_objects" auf "true", wenn die zurückgegebene Teamdefinition die abhängigen Agent-, Aufgaben- und Tooldefinitionen enthalten muss, die zum Neuerstellen des Teams erforderlich sind.

Syntax

DBMS_CLOUD_AI_AGENT.GET_DEFINITION(
  object_type IN VARCHAR2,
  object_name IN VARCHAR2,
  params      IN CLOB DEFAULT NULL
) RETURN CLOB;

Parameter

Parameter Beschreibung
object_type Zu exportierender Objekttyp. Unterstützte Werte sind AGENT, TASK, TOOL und TEAM.
object_name Name des Agents, der Aufgabe, des Tools oder des Teams, dessen Definition zurückgegeben wird.
params

Optionales JSON-Objekt. Unterstützter Schlüssel: dependent_objects. Setzen Sie dependent_objects auf true, um die abhängigen Objektdefinitionen einzuschließen, die zum Neuerstellen des angeforderten Objekts erforderlich sind.

  • Für TEAM gibt die Funktion die Definitionen TEAM, AGENT, TASK und TOOL zurück.
  • Für AGENT gibt die Funktion die Definitionen AGENT und TOOL zurück.
  • Für TASK gibt die Funktion die Definitionen TASK und TOOL zurück.

Standardmäßig ist dependent_objects NULL. Wenn Sie diesen Parameter weglassen, gibt die Funktion nur die Definition des angeforderten Objekts zurück.

Retouren

Gibt eine CLOB zurück, die einen oder mehrere kanonische ausführbare PL/SQL-Blöcke enthält. Der zurückgegebene Block verwendet die Erstellungsprozedur für den angeforderten Objekttyp.

Hinweise zur Verwendung

  • Die Funktion gibt Definitionen für Objekte zurück, die dem aktuellen Aufrufer gehören. Schemaübergreifende oder erteilte oder gemeinsam genutzte Objekte sind nicht enthalten.
  • Wenn params ausgelassen wird oder dependent_objects nicht true ist, enthält die Ausgabe nur die angeforderte Objektdefinition. Sie referenziert abhängige Objekte nach öffentlichem Namen, schließt jedoch ihre Erstellungsblöcke nicht ein.
  • Wenn dependent_objects true ist, enthält die Ausgabe die angeforderte Objektdefinition und die abhängigen Definitionen, die zum Neuerstellen des Teams erforderlich sind.
  • Die zurückgegebene Definition behält den strukturierten JSON-Inhalt für Benutzer bei und schließt verborgene Attribute, interne Linkage-Metadaten und reinen Implementierungsinhalt aus. Öffentliche Zugangsdatennamen können angezeigt werden, wenn sie für die Neuerstellung erforderlich sind. Secret-Werte werden jedoch nicht zurückgegeben.

Beispiel

Geben Sie eine Teamdefinition ohne abhängige Objekte zurück, und geben Sie dann die Teamdefinition mit abhängigen Objekten zurück.

SELECT DBMS_CLOUD_AI_AGENT.GET_DEFINITION(
  object_type => 'TEAM',
  object_name => 'TEAM_NAME'
) AS definition
FROM dual;

SELECT DBMS_CLOUD_AI_AGENT.GET_DEFINITION(
  object_type => 'TEAM',
  object_name => 'TEAM_NAME',
  params      => '{"dependent_objects": true}'
) AS definition
FROM dual;

Prozedur GRANT_TEAM_ACCESS

Erteilen Sie einem Datenbankbenutzer oder einer Rolle die Berechtigung zum Ausführen eines Agent-Teams.

Syntax

PROCEDURE DBMS_CLOUD_AI_AGENT.GRANT_TEAM_ACCESS(
 team_name IN VARCHAR2,
 user_or_role_name IN VARCHAR2);

Parameter

Parameter Beschreibung
team_name Name des Agent-Teams, dessen Ausführungszugriff Sie freigeben möchten. Verwenden Sie den im Eigentümerschema gespeicherten Teamnamen.
user_or_role_name Name des Datenbankbenutzers oder der Rolle, für den bzw. die das gemeinsame Team ausgeführt werden soll.

Hinweise zur Verwendung

  • Der Zuschuss gilt nur auf Teamebene.
  • Nur der Teamverantwortliche kann den Zugriff erteilen oder entziehen.
  • Wenn ein Benutzer bereits über direkten Zugriff verfügt, muss der Teamverantwortliche den Zugriff nicht erneut erteilen.
  • Führen Sie ein Schemaübergreifendes Team aus, indem Sie einen qualifizierten Namen wie TEAM_OWNER.SHARED_SUPPORT_TEAM verwenden.
  • Mit der Berechtigung kann der Consumer den vom Eigentümer definierten Workflow als einzelne Einheit ausführen.
  • Die Finanzhilfe gestattet dem Verbraucher nicht, separate Finanzhilfen für die zugrunde liegenden Agents, Aufgaben oder Tools unabhängig auszuführen, zu ändern oder zu erhalten.
  • Der Berechtigte darf nicht mit dem aktuellen Sessionbenutzer identisch sein.
  • Datenbankbenutzernamen und -rollennamen verwenden denselben Namespace für diese Zugriffsberechtigung.
  • Erteilen und widerrufen Sie den nicht qualifizierten Teamnamen des Eigentümers. PUBLIC kann nicht als Berechtigter verwendet werden.
  • Der Zugriff über eine Rolle funktioniert nur, wenn diese Rolle aktiviert ist, einschließlich, wenn der Zugriff von Standard- oder verschachtelten Rollen stammt.
  • Änderungen erteilen und entziehen werden wirksam, wenn der API-Aufruf abgeschlossen ist.

Beispiel

BEGIN
 DBMS_CLOUD_AI_AGENT.GRANT_TEAM_ACCESS(
 team_name => 'SHARED_SUPPORT_TEAM',
 user_or_role_name => 'TEAM_CONSUMER');
END;
/

Prozedur REVOKE_TEAM_ACCESS

Datenbankbenutzer oder Rollenberechtigung für ein Agent-Team entziehen.

Syntax

PROCEDURE DBMS_CLOUD_AI_AGENT.REVOKE_TEAM_ACCESS(
 team_name IN VARCHAR2,
 user_or_role_name IN VARCHAR2);

Parameter

Parameter Beschreibung
team_name Name des freigegebenen Agent-Teams, aus dem Sie den Ausführungszugriff entfernen möchten.
user_or_role_name Name des Datenbankbenutzers oder der Rolle, dessen Berechtigung zum Ausführen des freigegebenen Teams, das Sie entfernen möchten, erteilt wurde.

Hinweise zur Verwendung

  • Das Entziehen des Zugriffs verhindert, dass der Benutzer oder die Rolle neue Ausführungen des freigegebenen Teams starten.
  • Der Teamverantwortliche muss einem Benutzer ohne direkten Zugriff keinen Zugriff entziehen.
  • Änderungen erteilen und entziehen werden wirksam, wenn der API-Aufruf abgeschlossen ist.
  • Durch Entziehen des Teamzugriffs wird ein Prozess, der bereits in Bearbeitung ist, nicht beendet. Der Prozess kann fortgesetzt werden, bis er einen endgültigen Status erreicht.
  • Nachdem der Zugriff entzogen wurde, kann der Benutzer oder die Rolle keinen neuen Prozess starten oder einen Prozess mit dem Status WAITING_FOR_HUMAN fortsetzen.
  • Wählen Sie "KI prüft den Zugriff jedes Mal, wenn ein Consumer ein Team festlegt, ausführt oder wiederaufnimmt.
  • Das Entziehen des Teamzugriffs wirkt sich nicht auf die separaten Berechtigungen des Verbrauchers aus.
  • Die Teamdefinition bleibt Eigentümer und wird vom Eigentümerschema verwaltet.

Beispiel

BEGIN
 DBMS_CLOUD_AI_AGENT.REVOKE_TEAM_ACCESS(
 team_name => 'SHARED_SUPPORT_TEAM',
 user_or_role_name => 'TEAM_CONSUMER');
END;
/

Funktion GET_VARIABLE

Eine Laufzeitvariable mit Namespace aus der aktuellen Session lesen.

Syntax

FUNCTION DBMS_CLOUD_AI_AGENT.GET_VARIABLE(
 namespace IN VARCHAR2,
 name IN VARCHAR2,
 scope IN VARCHAR2 DEFAULT 'ephemeral')
RETURN CLOB;

Parameter

Parameter Beschreibung
namespace Name des Laufzeitvariablen-Namespace, der den Wert enthält. Verwenden Sie state_variables für den Toolstatus und die Übergabe, instruction_variables für Anweisungsplatzhalter oder attribute_variables für Agent- und Toolattribute.
name Name des Variablenschlüssels, der aus dem ausgewählten Namespace gelesen werden soll.
scope Geltungsbereich beim Lesen der Variablen. Unterstützter Wert ist ephemeral. Dies ist die standardmäßige Einstellung.

Hinweise zur Verwendung

  • GET_VARIABLE gibt NULL zurück, wenn der Schlüssel nicht gefunden wird.
  • Laufzeitwerte, die an RUN_TEAM übergeben werden, haben Vorrang vor Werten, die durch SET_TEAM festgelegt werden.

Beispiel

l_profile_name := DBMS_CLOUD_AI_AGENT.GET_VARIABLE(
 namespace => 'state_variables',
 name => 'llm_profile');

SET_VARIABLE - Prozedur

Legen Sie eine Namespace-Laufzeitvariable für die aktuelle Ausführung fest.

Syntax

PROCEDURE DBMS_CLOUD_AI_AGENT.SET_VARIABLE(
 namespace IN VARCHAR2,
 name IN VARCHAR2,
 value IN CLOB,
 scope IN VARCHAR2 DEFAULT 'ephemeral');

Parameter

Parameter Beschreibung
namespace Name des Laufzeitvariablen-Namespace, in dem der Wert festgelegt oder gelöscht werden soll. Verwenden Sie state_variables für den Toolstatus und die Übergabe, instruction_variables für Anweisungsplatzhalter oder attribute_variables für Agent- und Toolattribute.
name Name des Variablenschlüssels, der festgelegt oder gelöscht werden soll.
value CLOB-Wert für den Schlüssel. Geben Sie NULL an, um den Schlüssel für den aktuellen Ausführungsgeltungsbereich zu löschen.
scope Geltungsbereich, der beim Festlegen der Variablen verwendet wird. Unterstützter Wert ist ephemeral. Dies ist die standardmäßige Einstellung.

Hinweise zur Verwendung

  • Verwenden Sie SET_VARIABLE in einem Tool, wenn ein späteres Tool in derselben Ausführung den Wert benötigt.
  • Ein NULL-Wert löscht den ausgeführten Wert für den Schlüssel.

Beispiel

DBMS_CLOUD_AI_AGENT.SET_VARIABLE(
 namespace => 'state_variables',
 name => 'verified_account_id',
 value => 'ACCOUNT_ID');