Documentación de Oracle Cloud Infrastructure

Paquete DBMS_CLOUD_AI_AGENT

Este paquete define y gestiona agentes, tareas, herramientas y orquestación de Select AI.

Consulte también:

Tema principal: Referencia de paquete proporcionado de base de datos de IA autónoma

Resumen de Subprogramas DBMS_CLOUD_AI_AGENT

En esta sección se tratan los subprogramas DBMS_CLOUD_AI_AGENT de Select AI Agent proporcionados con Autonomous AI Database.

Subprograma Descripción

CREATE_AGENT Procedimiento

Este procedimiento crea un agente.

Atributos CREATE_AGENT

Proporciona atributos para crear un agentes.

ENABLE_AGENT Procedimiento

Este procedimiento activa un agente.

DISABLE_AGENT Procedimiento

Este procedimiento desactiva un agente.

DROP_AGENT Procedimiento

Este procedimiento borra un agente existente.

CREATE_TASK Procedimiento

Este procedimiento crea una tarea que un agente y un equipo de agentes pueden incluir.

Atributos CREATE_TASK

Proporciona atributos para crear una tarea de agente.

ENABLE_TASK Procedimiento

Este procedimiento activa una tarea de agente.

DISABLE_TASK Procedimiento

Este procedimiento desactiva una tarea de agente.

DROP_TASK Procedimiento

Este procedimiento borra una tarea de agente existente.

CREATE_TOOL Procedimiento

Este procedimiento crea herramientas personalizadas que un agente puede incluir.

Atributos CREATE_TOOL

Proporciona atributos para crear herramientas.

ENABLE_TOOL Procedimiento

Este procedimiento habilita una herramienta registrada.

DISABLE_TOOL Procedimiento

Este procedimiento desactiva una herramienta registrada.

DROP_TOOL Procedimiento

Este procedimiento elimina una herramienta existente.

CREATE_TEAM Procedimiento

Este procedimiento crea un equipo de agentes e incluye agentes y tareas.

Atributos CREATE_TEAM

Proporciona atributos para crear un equipo de agente.

Función SET_TEAM

Este procedimiento define el equipo del agente en la sesión actual.

Función GET_TEAM

Este procedimiento devuelve el juego de equipos del agente en la sesión actual.

Función CLEAR_TEAM

Este procedimiento borra el juego de equipos de agente en la sesión actual.

Función RUN_TEAM

Este procedimiento crea un nuevo agente o ejecuta uno en pausa.

ENABLE_TEAM Procedimiento

Este procedimiento permite a un equipo de agentes.

DISABLE_TEAM Procedimiento

Este procedimiento desactiva un equipo de agentes.

DROP_TEAM Procedimiento

Este procedimiento elimina un equipo de agentes existente.
  • CREATE_AGENT Procedimiento
    Utilice el procedimiento DBMS_CLOUD_AI_AGENT.CREATE_AGENT para registrar un nuevo agente de AI en el marco Seleccionar agente de AI. Defina la identidad del agente mediante agent_name, configure su comportamiento con el parámetro de atributos y, opcionalmente, proporcione una descripción.
  • CREATE_AGENT Atributos
    Estos atributos definen el rol de un agente y el nombre del perfil de AI.
  • Procedimiento ENABLE_AGENT
    Este procedimiento activa el agente AI que especifica el usuario. El procedimiento cambia el estado del agente AI a ENABLED.
  • DISABLE_AGENT Procedimiento
    Este procedimiento desactiva el agente AI en la base de datos actual. En este procedimiento, el estado del agente AI cambia a DISABLED.
  • DROP_AGENT Procedimiento
    El procedimiento borra un agente de AI existente. Si el agente no existe, el procedimiento devuelve un error.
  • Procedimiento CREATE_TASK
    Utilice el procedimiento DBMS_CLOUD_AI_AGENT.CREATE_TASK para definir una tarea que un agente de Select AI puede incluir en su proceso de razonamiento. Cada tarea tiene un nombre único y un juego de atributos que especifican el comportamiento del agente al planificar y realizar la tarea.
  • CREATE_TASK Atributos
    Estos atributos definen las instrucciones y herramientas del agente disponibles para la tarea.
  • Procedimiento ENABLE_TASK
    Utilice el procedimiento DBMS_CLOUD_AI_AGENT.ENABLE_TASK para activar una tarea definida anteriormente. Esto cambia el estado de la tarea a ENABLED, lo que permite al agente utilizarla durante el procesamiento.
  • Procedimiento DISABLE_TASK
    Utilice el procedimiento DBMS_CLOUD_AI_AGENT.DISABLE_TASK para desactivar una tarea en la base de datos actual. Esto cambia el estado de la tarea a DISABLED, lo que impide que el agente la utilice durante el procesamiento.
  • Procedimiento DROP_TASK
    Utilice el procedimiento DBMS_CLOUD_AI_AGENT.DROP_TASK para eliminar una tarea definida previamente de la base de datos. Si la tarea no existe, puede suprimir el error definiendo el parámetro force en TRUE.
  • Procedimiento CREATE_TOOL
    Utilice el procedimiento DBMS_CLOUD_AI_AGENT.CREATE_TOOL para registrar una herramienta personalizada que un agente puede utilizar durante el procesamiento de tareas. Cada herramienta se identifica mediante un tool_name único e incluye atributos que definen su finalidad, lógica de implantación y metadatos.
  • CREATE_TOOL Atributos
    Estos atributos proporcionan una configuración de herramienta mediante un objeto JSON en el parámetro de atributos. Cada atributo configura el modo en que el agente utiliza la herramienta durante el razonamiento.
  • Procedimiento ENABLE_TOOL
    Utilice el procedimiento DBMS_CLOUD_AI_AGENT.ENABLE_TOOL para activar una herramienta registrada anteriormente. Esto cambia el estado de la herramienta a ENABLED, lo que permite al agente utilizar las tareas.
  • Procedimiento DISABLE_TOOL
    Utilice el procedimiento DBMS_CLOUD_AI_AGENT.DISABLE_TOOL para desactivar una herramienta registrada. Esto cambia el estado de la herramienta a DISABLED, lo que impide que el agente lo utilice en tareas.
  • Procedimiento DROP_TOOL
    Utilice el procedimiento DBMS_CLOUD_AI_AGENT.DROP_TOOL para eliminar una herramienta registrada anteriormente con el agente. Si la tarea no existe, puede suprimir el error definiendo el parámetro force en TRUE.
  • CREATE_TEAM Procedimiento
    Utilice el procedimiento DBMS_CLOUD_AI_AGENT.CREATE_TEAM para definir un equipo de agentes de IA que trabajen juntos para realizar tareas. Puede especificar agentes y sus tareas asociadas, junto con la forma en que se deben procesar las tareas.
  • CREATE_TEAM Atributos
    Estos atributos proporcionan la configuración del equipo del agente de AI. Cada equipo tiene un team_name único y utiliza un juego de atributos para definir su estructura y estrategia de ejecución.
  • Función SET_TEAM
    Utilice DBMS_CLOUD_AI_AGENT.SET_TEAM para especificar el equipo de agente de AI para la sesión actual.
  • GET_TEAM Función
    Utilice DBMS_CLOUD_AI_AGENT.GET_TEAM para devolver el equipo de agente de AI para la sesión actual.
  • Función CLEAR_TEAM
    Utilice DBMS_CLOUD_AI_AGENT.CLEAR_TEAM para borrar el juego de equipos de agente de AI en la sesión actual. Este procedimiento no elimina al equipo.
  • Función RUN_TEAM
    Utilice DBMS_CLOUD_AI_AGENT.RUN_TEAM para iniciar un nuevo equipo de agente de IA o reanudar uno en pausa que esté esperando la entrada humana. Si proporciona un ID de proceso existente y el proceso de equipo asociado tiene el estado WAITING_FOR_HUMAN, la función reanuda el flujo de trabajo utilizando la entrada que proporciona como respuesta humana.
  • Procedimiento ENABLE_TEAM
    Utilice el procedimiento DBMS_CLOUD_AI_AGENT.ENABLE_TEAM para activar un equipo de agente de AI especificado por el usuario. Esto cambia el estado del equipo a ENABLED.
  • Procedimiento DISABLE_TEAM
    Utilice el procedimiento DBMS_CLOUD_AI_AGENT.DISABLE_TEAM para desactivar un equipo de agente de AI existente. Esto cambia el estado del equipo a DISABLED.
  • Procedimiento DROP_TEAM
    Utilice el procedimiento DBMS_CLOUD_AI_AGENT.DROP_TEAM para eliminar un equipo de agente de AI creado anteriormente.

Tema principal: Paquete DBMS_CLOUD_AI_AGENT

CREATE_AGENT Procedimiento

Utilice el procedimiento DBMS_CLOUD_AI_AGENT.CREATE_AGENT para registrar un nuevo agente AI en el marco Select AI Agent. Defina la identidad del agente mediante agent_name, configure su comportamiento con el parámetro de atributos y, opcionalmente, proporcione una descripción.

Sintaxis

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

Parámetros

Parámetro Descripción

agent_name

Nombre del agente de AI. El nombre del agente debe seguir las reglas de nomenclatura del identificador de Oracle SQL. La longitud de nombre máxima es de 125 caracteres.

Este parámetro es obligatorio.

attributes

Atributos personalizados para el agente AI. Consulte CREATE_AGENT Attributes para obtener más información.

status

Estado del agente.

El valor por defecto es enabled.

description

Descripción especificada por el usuario para el agente AI.

El valor por defecto es NULL.

Ejemplo

En el siguiente ejemplo, se crea un agente para procesar las devoluciones de productos del cliente. Para obtener un ejemplo completo, consulte Ejemplo: creación de un agente de devolución de productos. 

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.

Atributos CREATE_AGENT

Estos atributos definen el rol de un agente y el nombre del perfil de AI.

Atributos

Nombre de atributo Valor por defecto Descripción

profile_name

 -

Perfil de AI que utiliza el agente para enviar la solicitud al LLM.

Este parámetro es obligatorio.

role

NULO

Definir la función del agente y proporcionar contexto al agente. Esto se envía al LLM.

Este parámetro es obligatorio.

enable_human_tool

True

Permite que el agente haga preguntas al usuario para obtener información o aclaraciones.

En el siguiente ejemplo, se muestra cómo puede personalizar los atributos de agente en el procedimiento.
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

ENABLE_AGENT Procedimiento

Este procedimiento activa el agente AI que especifica el usuario. El procedimiento cambia el estado del agente AI a ENABLED.

Sintaxis

DBMS_CLOUD_AI_AGENT.ENABLE_AGENT(
   agent_name           IN  VARCHAR2
);

Parámetros

Parámetro Descripción

agent_name

Nombre del agente de AI que se va a activar.

Este parámetro es obligatorio.

Ejemplo para activar el perfil AI

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

DISABLE_AGENT Procedimiento

Este procedimiento desactiva el agente de AI en la base de datos actual. En este procedimiento, el estado del agente AI cambia a DISABLED.

Sintaxis

DBMS_CLOUD_AI_AGENT.DISABLE_AGENT(
   agent_name           IN  VARCHAR2
);

Parámetros

Parámetro Descripción

agent_name

Nombre del agente de AI.

Este parámetro es obligatorio.

Ejemplo

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

DROP_AGENT Procedimiento

El procedimiento elimina un agente de AI existente. Si el agente no existe, el procedimiento devuelve un error.

Sintaxis

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

Parámetros

Parámetro Descripción

agent_name

Nombre del agente AI.

Este parámetro es obligatorio.

force

Si es TRUE, el procedimiento ignora los errores si el agente AI no existe.

El valor por defecto de este parámetro es FALSE.

Ejemplo

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

Notas de uso

Utilice force para borrar un agente e ignorar los errores si el agente de AI no existe.

CREATE_TASK Procedimiento

Utilice el procedimiento DBMS_CLOUD_AI_AGENT.CREATE_TASK para definir una tarea que un agente de Select AI puede incluir en su proceso de razonamiento. Cada tarea tiene un nombre único y un juego de atributos que especifican el comportamiento del agente al planificar y realizar la tarea.

Puede definir dependencias entre tareas mediante el atributo input, lo que permite que Select AI transfiera la salida de una tarea a otra. Esto admite el razonamiento encadenado y los flujos de trabajo de varios pasos.

Sintaxis

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

Parámetros

Parámetro Descripción

task_name

Nombre único para la tarea.

Este parámetro es obligatorio.

attributes

Objeto JSON que contiene atributos específicos de la tarea. Consulte CREATE_TASK Attributes.

status

Estado de la tarea.

El valor por defecto es ENABLED.

description

Descripción definida por el Usuario para ayudar a identificar la tarea. Este valor se almacena en la base de datos, pero no se envía al LLM.

El valor por defecto es NULL.

enable_human_tool

Permite que el agente haga preguntas al usuario cuando necesite información o aclaraciones durante una tarea.

El valor por defecto es true.

Nota

La tarea enable_human_tool sobrescribe el atributo enable_human_tool del agente. Si el agente enable_human_tool se define en false y la tarea enable_human_tool se define en true, durante la ejecución de la tarea, se espera que el LLM haga preguntas.

Ejemplo

En el siguiente ejemplo, se crea una tarea para procesar una devolución de producto de un cliente. 

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;
/

Atributos CREATE_TASK

Estos atributos definen las instrucciones y herramientas del agente disponibles para la tarea.

Atributos

Nombre de atributo Valor por defecto Descripción

instruction

 -
Declaración clara y concisa que describe lo que debe lograr la tarea. Este texto se incluye en la petición de datos enviada al LLM. Puede incluir un marcador de posición {query} para representar la entrada de lenguaje natural. Por ejemplo: 
SELECT AI AGENT <user_prompt>

Este parámetro es obligatorio.

tools

-

Matriz JSON de nombres de herramientas que el agente puede utilizar para completar la tarea. Por ejemplo: "tools": ["RAG", "SQL", "WEBSEARCH", "NOTIFICATION"].

Este parámetro es obligatorio.

input

 -

Identifica otras tareas cuyas salidas se deben utilizar como entrada para esta tarea. Select AI proporciona automáticamente estas salidas al LLM.

ENABLE_TASK Procedimiento

Utilice el procedimiento DBMS_CLOUD_AI_AGENT.ENABLE_TASK para activar una tarea definida anteriormente. Esto cambia el estado de la tarea a ENABLED, lo que permite al agente utilizarla durante el procesamiento.

Sintaxis

DBMS_CLOUD_AI_AGENT.ENABLE_TASK(
   task_name           IN  VARCHAR2
);

Parámetros

Parámetro Descripción

task_name

Nombre de la tarea que se va a activar.

Este parámetro es obligatorio.

Notas de uso

La tarea ya debe existir en el sistema. Este procedimiento actualiza el estado de la tarea para que esté disponible para el proceso de agente durante los flujos de trabajo de razonamiento.

Ejemplo para activar una tarea

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

DISABLE_TASK Procedimiento

Utilice el procedimiento DBMS_CLOUD_AI_AGENT.DISABLE_TASK para desactivar una tarea en la base de datos actual. Esto cambia el estado de la tarea a DISABLED, lo que impide que el agente la utilice durante el procesamiento.

Sintaxis

DBMS_CLOUD_AI_AGENT.DISABLE_TASK(
   task_name           IN  VARCHAR2
);

Parámetros

Parámetro Descripción

task_name

Nombre de la tarea que se va a desactivar.

Este parámetro es obligatorio.

Notas de uso

La desactivación de una tarea no la suprime; puede volver a activarla más adelante mediante DBMS_CLOUD_AI_AGENT.ENABLE_TASK. Una vez desactivada, la tarea se vuelve inactiva y el agente ya no la considera durante la selección de la tarea.

Ejemplo

En el siguiente ejemplo, se desactiva una tarea existente.

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

DROP_TASK Procedimiento

Utilice el procedimiento DBMS_CLOUD_AI_AGENT.DROP_TASK para eliminar una tarea definida previamente de la base de datos. Si la tarea no existe, puede suprimir el error definiendo el parámetro force en TRUE.

Sintaxis

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

Parámetros

Parámetro Descripción

task_name

Nombre de la tarea que se va a borrar.

Este parámetro es obligatorio.

force

Si es TRUE, el procedimiento ignora los errores si la tarea no existe.

El valor por defecto de este parámetro es FALSE.

Ejemplo

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

Notas de uso

Utilice force para borrar una tarea e ignorar los errores si la tarea no existe.

CREATE_TOOL Procedimiento

Utilice el procedimiento DBMS_CLOUD_AI_AGENT.CREATE_TOOL para registrar una herramienta personalizada que un agente puede utilizar durante el procesamiento de tareas. Cada herramienta se identifica mediante un tool_name único e incluye atributos que definen su finalidad, lógica de implantación y metadatos.

Las herramientas pueden ser funciones o procedimientos PL/SQL personalizados, o tipos de herramientas incorporadas como RAG, SQL, WEBSEARCH o NOTIFICATION.

Sintaxis

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

Parámetros

Parámetro Descripción

tool_name

Nombre único para identificar la herramienta.

Este parámetro es obligatorio.

attributes

Atributos de herramienta en formato JSON. Consulte CREATE_TOOL Attributes.

Este parámetro es obligatorio.
status

Estado de la herramienta.

El valor por defecto es ENABLED.

description

Descripción definida por el Usuario para ayudar a identificar la herramienta. Este valor se almacena en la base de datos, pero no se envía al LLM.

El valor por defecto es NULL.

Ejemplo

En el siguiente ejemplo, se crea una herramienta para generar un correo electrónico para el destinatario. 

BEGIN
  DBMS_CLOUD_AI_AGENT.CREATE_TOOL(
    tool_name  => 'NOTIFICATION',
    attributes => '{"tool_type": "EMAIL"}'
  );
END;
/

Atributos CREATE_TOOL

Estos atributos proporcionan la configuración de la herramienta mediante un objeto JSON en el parámetro de atributos. Cada atributo configura el modo en que el agente utiliza la herramienta durante el razonamiento.

Atributos

Nombre de atributo Valor por defecto Descripción

instruction

 -

Declaración clara y concisa que describe lo que debe lograr la herramienta y cómo hacerlo. Este texto se incluye en la petición de datos enviada al LLM.

Este parámetro es obligatorio.

function

-

Especifica el procedimiento o la función PL/SQL que se va a llamar cuando se utilice la herramienta.

Éste es un parámetro obligatorio para las herramientas personalizadas.

tool_type

 -

Especifica un tipo de herramienta incorporado. Si se define, instruction y function no son necesarios.

Los valores posibles son los siguientes:
  • SQL
  • RAG
  • WEBSEARCH
  • NOTIFICATION

Puede crear herramientas incorporadas con nombres y parámetros personalizados. También puede crear varias herramientas incorporadas con el mismo tool_type pero diferente tool_params.

tool_params

 -

Especifica los parámetros para registrar herramientas incorporadas.

tool_inputs

 -

Describe los argumentos de entrada. Similar a los comentarios de columna de una tabla. Por ejemplo:

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

Requisitos previos para la herramienta incorporada

Realice estos pasos antes de utilizar las herramientas incorporadas:

Herramienta RAG

  1. Cree un perfil de IA que haga referencia a un índice vectorial. Consulte Seleccionar AI con generación aumentada de recuperación (RAG).

Herramienta de notificación

Se admiten los siguientes elementos: SLACK y EMAIL.

herramienta SLACK:

  1. Configure una aplicación Slack para recibir mensajes de Autonomous Database.
  2. Cree una credencial mediante DBMS_CLOUD_NOTIFICATION para enviar notificaciones de Slack desde Autonomous Database. Consulte Envío de notificaciones de Slack desde Autonomous AI Database.

HerramientaEMAIL:

Nota

La herramienta de correo electrónico envía una notificación por correo electrónico desde OCI.
  1. Identifique el punto final SMTP. Por ejemplo, seleccione uno de los puntos finales SMTP: 
    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. Otorgue acceso SMTP mediante una ACL. Consulte Configuración de la conexión SMTP.
  3. Genere credenciales SMTP para la entrega de correo electrónico. El paquete UTL_SMTP utiliza credenciales para autenticarse con los servidores de Email Delivery al enviar un correo electrónico. Consulte Generación de credenciales SMTP para un usuario para obtener más información.
  4. Creación de remitentes aprobados. Complete este paso para todas las direcciones de correo electrónico que utilice como dirección From con el subprograma UTL_SMTP.MAIL. Consulte Gestión de emisores aprobados para más información.
  5. Otorgue acceso SMTP al usuario agregando la entrada de control de acceso (ACE). Para obtener más información, consulte Envío de correo electrónico desde Autonomous Database mediante DBMS_CLOUD_NOTIFICATION.

Herramienta HTTP:

Otorgue acceso de red mediante ACL al punto final especificado por el usuario para activar la solicitud http:

BEGIN
  DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
    host => 'www.example.com',
    ace  => xs$ace_type(
             privilege_list => xs$name_list('http'),
             principal_name => 'ADB_USER',
             principal_type => xs_acl.ptype_db
           )
  );
END;
/

Tipos de herramientas incorporadas en el paquete DBMS_CLOUD_AI_AGENT

Puede registrar herramientas incorporadas mediante los atributos tool_type y tool_params.

Tipo de Herramienta Descripción Parámetros obligatorios

SQL

Convierte el lenguaje natural en consultas SQL.

profile_name

RAG

Realiza la generación con recuperación aumentada mediante la búsqueda vectorial.

profile_name

NOTIFICATION
Envía mensajes a un canal de Slack o envía correos electrónicos mediante SMTP. Opciones disponibles:
  • slack
  • email

notification_type.

Cuando notification_type es slack, credential_name y slack_channel son obligatorios.

Cuando notification_type es email, credential_name, recipient, sender y smtp_host son obligatorios.

WEBSEARCH

Busca información de la web.

credential_name

ENABLE_TOOL Procedimiento

Utilice el procedimiento DBMS_CLOUD_AI_AGENT.ENABLE_TOOL para activar una herramienta registrada anteriormente. Esto cambia el estado de la herramienta a ENABLED, lo que permite al agente utilizar las tareas.

Sintaxis

DBMS_CLOUD_AI_AGENT.ENABLE_TOOL(
   tool_name           IN  VARCHAR2
);

Parámetros

Parámetro Descripción

tool_name

Nombre de la herramienta que se va a activar.

Este parámetro es obligatorio.

Ejemplo

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

DISABLE_TOOL Procedimiento

Utilice el procedimiento DBMS_CLOUD_AI_AGENT.DISABLE_TOOL para desactivar una herramienta registrada. Esto cambia el estado de la herramienta a DISABLED, lo que impide que el agente lo utilice en tareas.

Sintaxis

DBMS_CLOUD_AI_AGENT.DISABLE_TOOL(
   tool_name           IN  VARCHAR2
);

Parámetros

Parámetro Descripción

tool_name

Nombre de la herramienta que se va a desactivar.

Este parámetro es obligatorio.

Ejemplo

En el siguiente ejemplo, se desactiva una herramienta existente.

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

DROP_TOOL Procedimiento

Utilice el procedimiento DBMS_CLOUD_AI_AGENT.DROP_TOOL para eliminar una herramienta registrada anteriormente con el agente. Si la tarea no existe, puede suprimir el error definiendo el parámetro force en TRUE.

Sintaxis

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

Parámetros

Parámetro Descripción

tool_name

Nombre de la herramienta que desea borrar.

Este parámetro es obligatorio.

force

Si es TRUE, el procedimiento ignora los errores si la herramienta no existe.

El valor por defecto de este parámetro es FALSE.

Ejemplo

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

Notas de uso

Utilice force para borrar una herramienta e ignorar los errores si la herramienta no existe.

CREATE_TEAM Procedimiento

Utilice el procedimiento DBMS_CLOUD_AI_AGENT.CREATE_TEAM para definir un equipo de agentes de IA que trabajen juntos para realizar tareas. Puede especificar agentes y sus tareas asociadas, junto con la forma en que se deben procesar las tareas.

Sintaxis

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

Parámetros

Parámetro Descripción

team_name

Nombre único para identificar al equipo de agente de IA.

Este parámetro es obligatorio.

attributes

Cadena con formato JSON que define atributos de equipo, como agentes y procesos. Consulte CREATE_TEAM Attributes.

Este parámetro es obligatorio.
status

Estado del equipo.

El valor por defecto es ENABLED.

description

Descripción definida por el usuario para identificar la finalidad del equipo. Este valor se almacena en la base de datos, pero no se envía al LLM.

El valor por defecto es NULL.

Ejemplo

En el siguiente ejemplo, se crea un equipo de agente para procesar la devolución de productos de un cliente. 

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

Atributos CREATE_TEAM

Estos atributos proporcionan la configuración del equipo del agente de AI. Cada equipo tiene un team_name único y utiliza un juego de atributos para definir su estructura y estrategia de ejecución.

Atributos

Nombre de atributo Valor por defecto Descripción

agents

 -

Especifica los agentes de lista de matriz JSON y sus tareas correspondientes. Un agente se puede asignar a varias tareas con el mismo nombre.

Este parámetro es obligatorio.

Ejemplo:

[
  {"name": "<agent_name>", "task": "<task_name>"
]

process

-

Especifica cómo se ejecutan las tareas. Utilice "sequential" para que las tareas se ejecuten una tras otra en orden.

Función SET_TEAM

Utilice DBMS_CLOUD_AI_AGENT.SET_TEAM para especificar el equipo de agente de AI para la sesión actual.

Una vez que se define un equipo, solo se activa la acción select ai agent, el sistema no admite otras acciones de selección de IA.

Sintaxis

DBMS_CLOUD_AI_AGENT.SET_TEAM(
    team_name      IN  VARCHAR2,
);

Parámetros

Parámetro Descripción

team_name

Especifica el nombre del equipo del agente de AI que se utilizará en la sesión actual. El equipo ya debe existir en el sistema.

Este parámetro es obligatorio.

Ejemplo

En el siguiente ejemplo, se define el equipo de agente de AI especificado por el usuario en la sesión actual.

EXEC DBMS_CLOUD_AI_AGENT.SET_TEAM('ReturnAgency');

Función GET_TEAM

Utilice DBMS_CLOUD_AI_AGENT.GET_TEAM para devolver el equipo de agente de AI para la sesión actual.

Sintaxis

DBMS_CLOUD_AI_AGENT.GET_TEAM RETURN VARCHAR2;

Ejemplo

En el siguiente ejemplo, se devuelve el equipo del agente de AI en la sesión actual.

SELECT DBMS_CLOUD_AI_AGENT.GET_TEAM from DUAL;

Función CLEAR_TEAM

Utilice DBMS_CLOUD_AI_AGENT.CLEAR_TEAM para borrar el juego de equipos de agente de AI en la sesión actual. Este procedimiento no elimina al equipo.

Sintaxis

DBMS_CLOUD_AI_AGENT.CLEAR_TEAM;

Ejemplo

En el siguiente ejemplo, se borra el equipo del agente de IA en la sesión actual.

BEGIN
  DBMS_CLOUD_AI_AGENT.CLEAR_TEAM;
END;
/

Función RUN_TEAM

Utilice DBMS_CLOUD_AI_AGENT.RUN_TEAM para iniciar un nuevo equipo de agentes de IA o reanudar uno en pausa que esté esperando la entrada humana. Si proporciona un ID de proceso existente y el proceso de equipo asociado tiene el estado WAITING_FOR_HUMAN, la función reanuda el flujo de trabajo utilizando la entrada que proporciona como respuesta humana.

Sintaxis

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

Parámetros

Parámetro Descripción

team_name

Especifica el nombre del equipo del agente de AI que se utilizará en la sesión actual. El equipo ya debe existir en el sistema.

Este parámetro es obligatorio.

user_prompt

Especifica la consulta de usuario o la respuesta proporcionada a la tarea.

Si la tarea tiene el estado RUNNING, la entrada actúa como marcador de posición para {query} en la instrucción de la tarea.

Si la tarea tiene el estado WAITING_FOR_HUMAN, la entrada sirve como respuesta humana.

params
Especifica los parámetros personalizados utilizados durante el proceso de equipo de agente de AI. Los parámetros soportados incluyen:
  • conversation_id: identifica la sesión de conversación asociada al equipo del agente. Utilice este parámetro para las integraciones de aplicaciones sin estado (por ejemplo, APEX) para distinguir entre diferentes conexiones de usuario.
  • variables: define pares clave-valor que proporcionan una entrada adicional al equipo del agente. Estas variables ayudan a personalizar el comportamiento del equipo durante el proceso.

Ejemplo

En el siguiente ejemplo, se ejecuta el equipo de agente de AI especificado por el usuario en la sesión actual.

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 || '"}'
);

ENABLE_TEAM Procedimiento

Utilice el procedimiento DBMS_CLOUD_AI_AGENT.ENABLE_TEAM para activar un equipo de agente de AI especificado por el usuario. Esto cambia el estado del equipo a ENABLED.

Sintaxis

DBMS_CLOUD_AI_AGENT.ENABLE_TEAM(
   team_name           IN  VARCHAR2
);

Parámetros

Parámetro Descripción

team_name

Nombre que debe activar el equipo de agente de AI.

Este parámetro es obligatorio.

Ejemplo

En el siguiente ejemplo, se activa un equipo de agentes de AI especificado por el usuario.

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

DISABLE_TEAM Procedimiento

Utilice el procedimiento DBMS_CLOUD_AI_AGENT.DISABLE_TEAM para desactivar un equipo de agente de AI existente. Esto cambia el estado del equipo a DISABLED.

Sintaxis

DBMS_CLOUD_AI_AGENT.DISABLE_TEAM(
   team_name           IN  VARCHAR2
);

Parámetros

Parámetro Descripción

team_name

Nombre del equipo de agente de AI que se va a desactivar.

Este parámetro es obligatorio.

Ejemplo

En el siguiente ejemplo, se desactiva un equipo de agentes de IA existente.

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

DROP_TEAM Procedimiento

Utilice el procedimiento DBMS_CLOUD_AI_AGENT.DROP_TEAM para eliminar un equipo de agente de AI creado anteriormente.

Sintaxis

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

Parámetros

Parámetro Descripción

team_name

Nombre del equipo que se va a borrar.

Este parámetro es obligatorio.

force

Si es TRUE, el procedimiento ignora los errores si el equipo no existe.

El valor por defecto de este parámetro es FALSE.

Ejemplo

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

Notas de uso

Utilice force para borrar un equipo e ignorar los errores si el equipo no existe.