Pacchetto DBMS_CLOUD_AI_AGENT

Sintassi

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

Parametri

Esempio

Nell'esempio seguente viene creato un agente per elaborare i resi dei prodotti del cliente. Per un esempio completo, vedere Esempio: creazione di un agente restituzione prodotto.

Attributi

Sintassi

DBMS_CLOUD_AI_AGENT.ENABLE_AGENT(
   agent_name           IN  VARCHAR2
);

Parametri

Esempio per abilitare il profilo AI

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

Sintassi

DBMS_CLOUD_AI_AGENT.DISABLE_AGENT(
   agent_name           IN  VARCHAR2
);

Parametri

Esempio

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

Sintassi

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

Parametri

Esempio

Note sull'uso

Utilizzare force per eliminare un agente e ignorare gli errori se l'agente AI non esiste.

È possibile definire le dipendenze tra i task utilizzando l'attributo input, consentendo a Select AI di passare l'output di un task a un altro. Questo supporta il ragionamento concatenato e i flussi di lavoro a più fasi.

Sintassi

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

Parametri

Esempio

Nell'esempio seguente viene creato un task per elaborare il reso di un prodotto da un cliente.

Attributi

SELECT AI AGENT <user_prompt>

Sintassi

DBMS_CLOUD_AI_AGENT.ENABLE_TASK(
   task_name           IN  VARCHAR2
);

Parametri

Note sull'uso

Il task deve esistere già nel sistema. Questa procedura aggiorna lo stato del task rendendolo disponibile per il processo agente durante i flussi di lavoro di ragionamento.

Esempio di abilitazione di un task

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

Sintassi

DBMS_CLOUD_AI_AGENT.DISABLE_TASK(
   task_name           IN  VARCHAR2
);

Parametri

Note sull'uso

La disabilitazione di un task non comporta l'eliminazione; è possibile riabilitarlo in un secondo momento utilizzando DBMS_CLOUD_AI_AGENT.ENABLE_TASK. Una volta disabilitato, il task diventa inattivo e l'agente non lo considera più durante la selezione del task.

Esempio

Nell'esempio seguente viene disabilitato un task esistente.

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

Sintassi

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

Parametri

Esempio

Note sull'uso

Utilizzare force per eliminare un task e ignorare gli errori se il task non esiste.

Gli strumenti possono essere procedure o funzioni PL/SQL personalizzate o tipi di strumenti integrati come RAG, SQL, WEBSEARCH o NOTIFICA.

Sintassi

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

Parametri

Esempio

Nell'esempio seguente viene creato uno strumento per generare un messaggio e-mail per il destinatario.

Attributi

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

Prerequisiti per lo strumento integrato

Procedere come segue prima di utilizzare gli strumenti integrati:

Strumento RAG

Strumento di notifica

Sono supportati i seguenti metodi: SLACK e EMAIL.

Strumento SLACK:

Strumento E-MAIL:

Strumento HTTP:

Concedere l'accesso alla rete utilizzando l'ACL all'endpoint specificato dall'utente per abilitare la richiesta 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;
/

Tipi di strumenti integrati nel package DBMS_CLOUD_AI_AGENT

È possibile registrare gli strumenti integrati utilizzando gli attributi tool_type e tool_params.

Sintassi

DBMS_CLOUD_AI_AGENT.ENABLE_TOOL(
   tool_name           IN  VARCHAR2
);

Parametri

Esempio

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

Sintassi

DBMS_CLOUD_AI_AGENT.DISABLE_TOOL(
   tool_name           IN  VARCHAR2
);

Parametri

Esempio

Nell'esempio seguente viene disabilitato uno strumento esistente.

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

Sintassi

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

Parametri

Esempio

Note sull'uso

Utilizzare force per eliminare uno strumento e ignorare gli errori se lo strumento non esiste.

Sintassi

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

Parametri

Esempio

Nell'esempio seguente viene creato un team agente per elaborare la restituzione del prodotto di un cliente.

Attributi

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

Una volta impostato un team, solo l'azione select ai agent è abilitata, il sistema non supporta altre azioni Seleziona AI.

Sintassi

DBMS_CLOUD_AI_AGENT.SET_TEAM(
    team_name      IN  VARCHAR2,
);

Parametri

Esempio

L'esempio seguente imposta il team dell'agente AI specificato dall'utente nella sessione corrente.

EXEC DBMS_CLOUD_AI_AGENT.SET_TEAM('ReturnAgency');
  

Sintassi

DBMS_CLOUD_AI_AGENT.GET_TEAM RETURN VARCHAR2;

Esempio

Nell'esempio seguente viene restituito il team dell'agente AI nella sessione corrente.

SELECT DBMS_CLOUD_AI_AGENT.GET_TEAM from DUAL;
  

Sintassi

DBMS_CLOUD_AI_AGENT.CLEAR_TEAM;

Esempio

Nell'esempio seguente viene cancellato il team dell'agente AI nella sessione corrente.

BEGIN
  DBMS_CLOUD_AI_AGENT.CLEAR_TEAM;
END;
/
  

Sintassi

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

Parametri

Esempio

Nell'esempio seguente viene eseguito il team dell'agente AI specificato dall'utente nella sessione corrente.

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

  

Sintassi

DBMS_CLOUD_AI_AGENT.ENABLE_TEAM(
   team_name           IN  VARCHAR2
);

Parametri

Esempio

L'esempio seguente abilita un team agente AI specificato dall'utente.

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

Sintassi

DBMS_CLOUD_AI_AGENT.DISABLE_TEAM(
   team_name           IN  VARCHAR2
);

Parametri

Esempio

Nell'esempio seguente viene disabilitato un team agente AI esistente.

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

Sintassi

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

Parametri

Esempio

Note sull'uso

Utilizzare force per eliminare un team e ignorare gli errori se il team non esiste.