O exemplo a seguir concede o privilégio EXECUTE para o pacote DBMS_CLOUD_PIPELINE necessário para RAG:

GRANT EXECUTE on DBMS_CLOUD_PIPELINE to ADB_USER;

Para verificar os privilégios concedidos a um usuário para os pacotes DBMS_CLOUD_AI e DBMS_CLOUD_PIPELINE, um administrador pode executar o seguinte:

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

Os parâmetros são:

• host: O host, que pode ser o nome ou o endereço IP do host. Você pode usar um curinga para especificar um domínio ou uma sub-rede IP. O nome do host ou do domínio não diferencia maiúsculas de minúsculas.

  Provedor de AI	Host
  OpenAI	api.openai.com
  Cohere	api.cohere.ai
  Serviço OpenAI do Azure	<azure_resource_name>.openai.azure.com Consulte Atributos de Perfil para saber mais sobre azure_resource_name.
  Google	generativelanguage.googleapis.com
  Antrópico	api.anthropic.com
  Abraçando o rosto	api-inference.huggingface.co

• ace: As entradas de controle de acesso (ACE). O tipo XS$ACE_TYPE é fornecido para construir cada entrada ACE para a ACL. Para obter detalhes, consulte Criando ACLs e ACEs.

O exemplo a seguir cria uma credencial para ativar o acesso a OpenAI.

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

Os parâmetros são:

• credential_name: O nome da credencial a ser armazenada O parâmetro credential_name deve estar em conformidade com as convenções de nomenclatura do objeto Oracle.

• username: Os argumentos username e password juntos especificam suas credenciais de provedor de AI.

  username é um nome de usuário especificado pelo usuário.

• password: Os argumentos username e password juntos especificam suas credenciais de provedor de AI.

  O password é a chave de API secreta do provedor de IA e depende do provedor:

  Provedor de AI	Chaves de API
  OpenAI	Consulte Usar OpenAI para obter suas chaves de API.
  Cohere	Consulte Usar a Cohere para obter suas chaves de API.
  Serviço OpenAI do Azure	Consulte Usar o Serviço OpenAI do Azure para obter suas chaves de API e configurar o serviço. Observação Se você estiver usando o controlador de Serviços OpenAI do Azure para autenticação, poderá ignorar o procedimento DBMS_CLOUD.CREATE_CREDENTIAL. Consulte Exemplos de Uso do Select AI para obter um exemplo de autenticação usando o controlador de Serviços OpenAI do Azure.
  IA Generativa do OCI	Consulte Usar o OCI Generative AI para gerar chaves de assinatura de API.
  Google	Consulte Usar o Google para gerar suas chaves de API.
  Antrópico	Consulte Usar Antrópico para gerar suas chaves de API.
  Abraçando o rosto	Consulte Usar Face de Abraço para gerar suas chaves de API.

O exemplo a seguir concede cotas no tablespace para ADB_USER para usar Selecionar AI com RAG:

ALTER USER ADB_USER QUOTA 1T ON <tablespace_name>;

Para verificar a cota de tablespace concedida a um usuário, execute o seguinte:

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

Os parâmetros são:

• TABLESPACE_NAME: O tablespace para o qual a cota está designada. No Autonomous Database, os tablespaces são gerenciados automaticamente e têm DATA como prefixo.
• BYTES: A quantidade de espaço atualmente usada pelo usuário no tablespace.
• MAX_BYTES: A cota máxima designada (em bytes). Se MAX_BYTES for -1, isso significa que o usuário tem cota ilimitada no tablespace. O usuário do banco de dados que cria o índice do vetor deve ter MAX_BYTES suficientemente maior que bytes para acomodar o índice do vetor ou MAX_BYTES deve ser -1 para cota ilimitada.

O exemplo a seguir com o provedor OpenAI cria um perfil AI chamado OPENAI e define o perfil OPENAI para a sessão do usuário atual.

-- 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.