Pacote DBMS_CLOUD_AI_AGENT

Sintaxe

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

Exemplo

O exemplo a seguir cria um agente para processar devoluções de produtos do cliente. Para obter um exemplo completo, consulte Exemplo: Criar um Agente de Devolução de Produto.

Atributos

Sintaxe

DBMS_CLOUD_AI_AGENT.ENABLE_AGENT(
   agent_name           IN  VARCHAR2
);

Parâmetros

Exemplo para Ativar Perfil de IA

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

Sintaxe

DBMS_CLOUD_AI_AGENT.DISABLE_AGENT(
   agent_name           IN  VARCHAR2
);

Parâmetros

Exemplo

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

Sintaxe

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

Parâmetros

Exemplo

Observações de Uso

Use force para eliminar um agente e ignorar erros se o agente do AI não existir.

Você pode definir dependências entre tarefas usando o atributo input, permitindo que o Select AI transmita a saída de uma tarefa para outra. Isso suporta raciocínio encadeado e fluxos de trabalho de várias etapas.

Sintaxe

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

Exemplo

O exemplo a seguir cria uma tarefa para processar uma devolução de produto de um cliente.

Atributos

SELECT AI AGENT <user_prompt>

Sintaxe

DBMS_CLOUD_AI_AGENT.ENABLE_TASK(
   task_name           IN  VARCHAR2
);

Parâmetros

Observações de Uso

A tarefa já deve existir no sistema. Este procedimento atualiza o status da tarefa, tornando-o disponível para o processo do agente durante workflows de argumentos.

Exemplo de Ativação de uma Tarefa

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

Sintaxe

DBMS_CLOUD_AI_AGENT.DISABLE_TASK(
   task_name           IN  VARCHAR2
);

Parâmetros

Observações de Uso

A desativação de uma tarefa não a exclui; você pode reativá-la posteriormente usando DBMS_CLOUD_AI_AGENT.ENABLE_TASK. Depois de desativada, a tarefa se torna inativa e o agente não a considera mais durante a seleção da tarefa.

Exemplo

O exemplo a seguir desativa uma tarefa existente.

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

Sintaxe

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

Parâmetros

Exemplo

Observações de Uso

Use force para eliminar uma tarefa e ignorar erros se a tarefa não existir.

As ferramentas podem ser funções ou procedimentos PL/SQL personalizados ou tipos de ferramentas incorporados, como RAG, SQL, WEBSEARCH ou NOTIFICATION.

Sintaxe

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

Exemplo

O exemplo a seguir cria uma ferramenta para gerar um e-mail para o destinatário.

Atributos

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

Pré-requisitos para a Ferramenta Incorporada

Execute estas etapas antes de usar ferramentas incorporadas:

Ferramenta RAG

Ferramenta de NOTIFICAÇÃO

Os seguintes itens são suportados: SLACK e EMAIL.

Ferramenta SLACK:

Ferramenta E-MAIL:

Ferramenta HTTP:

Conceda acesso à rede usando ACL para o ponto final especificado pelo usuário para ativar a solicitação 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 Ferramenta Incorporados no Pacote DBMS_CLOUD_AI_AGENT

Você pode registrar ferramentas incorporadas usando os atributos tool_type e tool_params.

Sintaxe

DBMS_CLOUD_AI_AGENT.ENABLE_TOOL(
   tool_name           IN  VARCHAR2
);

Parâmetros

Exemplo

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

Sintaxe

DBMS_CLOUD_AI_AGENT.DISABLE_TOOL(
   tool_name           IN  VARCHAR2
);

Parâmetros

Exemplo

O exemplo a seguir desativa uma ferramenta existente.

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

Sintaxe

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

Parâmetros

Exemplo

Observações de Uso

Use force para eliminar uma ferramenta e ignorar erros se a ferramenta não existir.

Sintaxe

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

Exemplo

O exemplo a seguir cria uma equipe de agente para processar a devolução do produto de um cliente.

Atributos

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

Depois que uma equipe é definida, somente a ação select ai agent é ativada, o sistema não suporta outras ações Selecionar IA.

Sintaxe

DBMS_CLOUD_AI_AGENT.SET_TEAM(
    team_name      IN  VARCHAR2,
);

Parâmetros

Exemplo

O exemplo a seguir define a equipe do agente de IA especificada pelo usuário na sessão atual.

EXEC DBMS_CLOUD_AI_AGENT.SET_TEAM('ReturnAgency');
  

Sintaxe

DBMS_CLOUD_AI_AGENT.GET_TEAM RETURN VARCHAR2;

Exemplo

O exemplo a seguir retorna a equipe do agente do AI na sessão atual.

SELECT DBMS_CLOUD_AI_AGENT.GET_TEAM from DUAL;
  

Sintaxe

DBMS_CLOUD_AI_AGENT.CLEAR_TEAM;

Exemplo

O exemplo a seguir limpa a equipe do agente AI na sessão atual.

BEGIN
  DBMS_CLOUD_AI_AGENT.CLEAR_TEAM;
END;
/
  

Sintaxe

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

Parâmetros

Exemplo

O exemplo a seguir executa a equipe do agente de IA especificada pelo usuário na sessão atual.

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

  

Sintaxe

DBMS_CLOUD_AI_AGENT.ENABLE_TEAM(
   team_name           IN  VARCHAR2
);

Parâmetros

Exemplo

O exemplo a seguir ativa uma equipe de agente de IA especificada pelo usuário.

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

Sintaxe

DBMS_CLOUD_AI_AGENT.DISABLE_TEAM(
   team_name           IN  VARCHAR2
);

Parâmetros

Exemplo

O exemplo a seguir desativa uma equipe de agente do AI existente.

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

Sintaxe

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

Parâmetros

Exemplo

Observações de Uso

Use force para eliminar uma equipe e ignorar erros se a equipe não existir.