Gerenciar Perfis de IA

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 faz distinção entre maiúsculas e minúsculas.

  Provedor de IA	Host
  OpenAI	api.openai.com
  Provedores compatíveis com OpenAI	Por exemplo, para o Fireworks AI, use api.fireworks.ai
  Cohere	api.cohere.ai
  Serviço Azure OpenAI	<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
  Hugging Face	api-inference.huggingface.co
  AWS	bedrock-runtime.us-east-1.amazonaws.com

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

O exemplo a seguir cria uma credencial para permitir o acesso ao 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 de acordo com as convenções de nomeação de objetos da Oracle.

• username: Os argumentos username e password juntos especificam as credenciais do provedor de IA.

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

• password: Os argumentos username e password juntos especificam as credenciais do provedor de IA.

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

  Provedor de IA	Chaves de API
  OpenAI	Consulte Usar OpenAI para obter suas chaves de API.
  Provedores compatíveis com OpenAI	Consulte Usar Provedores Compatíveis com OpenAI para obter suas chaves de API e provider_endpoint.
  Cohere	Consulte Use o Cohere para obter suas chaves de API.
  Serviço Azure OpenAI	Consulte Usar o Azure OpenAI Service para obter suas chaves de API e configurar o serviço. Observação Se você estiver usando o controlador do Serviço 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 do Serviço 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.
  Hugging Face	Consulte Usar Face de Abraço para gerar suas chaves de API.
  AWS	Consulte Usar AWS para obter suas chaves de API e o ID do modelo.

O exemplo a seguir concede cotas no tablespace ao 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: O volume de espaço usado no momento 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 está criando 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.