En el siguiente ejemplo se otorga el privilegio EXECUTE para el paquete DBMS_CLOUD_PIPELINE necesario para RAG:

GRANT EXECUTE on DBMS_CLOUD_PIPELINE to ADB_USER;

Para comprobar los privilegios otorgados a un usuario para los paquetes DBMS_CLOUD_AI y DBMS_CLOUD_PIPELINE, un administrador puede ejecutar lo siguiente:

SELECT table_name AS package_name, privilege 
 FROM DBA_TAB_PRIVS 
 WHERE grantee = '<username>'
 AND   (table_name = 'DBMS_CLOUD_PIPELINE'
        OR table_name = 'DBMS_CLOUD_AI');

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

Los parámetros son:

• host: host, que puede ser el nombre o la dirección IP del host. Puede utilizar un comodín para especificar un dominio o una subred IP. El host o el nombre de dominio no son sensibles a mayúsculas/minúsculas.

  Proveedor de IA	Host
  OpenAI	api.openai.com
  Cohere	api.cohere.ai
  Servicio OpenAI de Azure	<azure_resource_name>.openai.azure.com Consulte Atributos de perfil para obtener más información sobre azure_resource_name.
  Google	generativelanguage.googleapis.com
  Antrópico	api.anthropic.com
  Cara abrazada	api-inference.huggingface.co

• ace: entradas de control de acceso (ACE). Se proporciona el tipo XS$ACE_TYPE para construir cada entrada de ACE para la ACL. Para obtener más información, consulte Creating ACLs and ACE.

En el siguiente ejemplo se crea una credencial para activar el acceso a OpenAI.

EXEC 
DBMS_CLOUD.CREATE_CREDENTIAL(
credential_name   => 'OPENAI_CRED', 
username          =>  'OPENAI', 
password          =>  '<your_api_token>');

Los parámetros son:

• credential_name: nombre de la credencial que se va a almacenar. El parámetro credential_name debe cumplir las convenciones de nomenclatura de objetos de Oracle.

• username: los argumentos username y password especifican conjuntamente las credenciales del proveedor de AI.

  username es un nombre de usuario especificado por el usuario.

• password: los argumentos username y password especifican conjuntamente las credenciales del proveedor de AI.

  password es la clave de API secreta del proveedor de IA y depende del proveedor:

  Proveedor de IA	Claves de API
  OpenAI	Consulte Uso de OpenAI para obtener las claves de API.
  Cohere	Consulte Uso de Cohere para obtener sus claves de API.
  Servicio OpenAI de Azure	Consulte Uso del servicio OpenAI de Azure para obtener sus claves de API y configurar el servicio. Nota Si utiliza la entidad de servicio OpenAI de Azure para autenticarse, puede omitir el procedimiento DBMS_CLOUD.CREATE_CREDENTIAL. Consulte Examples of Using Select AI para obtener un ejemplo de autenticación mediante la entidad de servicio OpenAI de Azure.
  OCI Generative AI	Consulte Uso de OCI Generative AI para generar claves de firma de API.
  Google	Consulte Uso de Google para generar las claves de API.
  Antrópico	Consulte Uso de Anthropic para generar sus claves de API.
  Cara abrazada	Consulte Uso de Hugging Face para generar sus claves de API.

En el siguiente ejemplo se otorgan cuotas en el tablespace a ADB_USER para utilizar Select AI con RAG:

ALTER USER ADB_USER QUOTA 1T ON <tablespace_name>;

Para comprobar la cuota de tablespace otorgada a un usuario, ejecute lo siguiente:

SELECT TABLESPACE_NAME, BYTES, MAX_BYTES 
FROM DBA_TS_QUOTAS 
WHERE USERNAME = '<username>' AND
      TABLESPACE_NAME LIKE 'DATA%';

Los parámetros son:

• TABLESPACE_NAME: tablespace para el que se asigna la cuota. En Autonomous Database, los tablespaces se gestionan automáticamente y tienen DATA como prefijo.
• BYTES: cantidad de espacio que utiliza actualmente el usuario en el tablespace.
• MAX_BYTES: cuota máxima asignada (en bytes). Si MAX_BYTES es -1, significa que el usuario tiene una cuota ilimitada en el tablespace. El usuario de base de datos que crea el índice vectorial debe tener MAX_BYTES suficientemente grande que los bytes para acomodar el índice vectorial, o MAX_BYTES debe ser -1 para una cuota ilimitada.

En el siguiente ejemplo con el proveedor OpenAI se crea un perfil AI denominado OPENAI y se define el perfil OPENAI para la sesión de usuario actual.

-- Create AI profile
--BEGIN
  DBMS_CLOUD_AI.CREATE_PROFILE(
  profile_name   => 'OPENAI',
  attributes     =>'{"provider": "openai",
			"credential_name": "OPENAI_CRED",
			"object_list": [{"owner": "SH", "name": "customers"},
					  {"owner": "SH", "name": "sales"},
					  {"owner": "SH", "name": "products"},
					  {"owner": "SH", "name": "countries"}]
       }');
END;
/
 
PL/SQL procedure successfully completed.
 
--
-- Enable AI profile in current session
--
EXEC DBMS_CLOUD_AI.set_profile('OPENAI');
 
PL/SQL procedure successfully completed.