Gestionar perfiles de IA
Puede crear y gestionar sus perfiles de AI mediante el paquete DBMS_CLOUD_AI
.
- Uso de DBMS_CLOUD_AI para configurar perfiles de IA
Autonomous Database utiliza perfiles de IA para facilitar y configurar el acceso a un LLM y para configurarlo para generar, ejecutar y explicar SQL basado en peticiones de datos de lenguaje natural. También facilita la recuperación de la generación aumentada mediante la incrustación de modelos e índices vectoriales y permite chatear con el LLM. - Realización de requisitos para Select AI
Antes de utilizar Select AI, estos son los pasos para activarDBMS_CLOUD_AI
. - Otorgar privilegios para seleccionar AI
Para utilizar Select AI, el administrador debe otorgar el privilegioEXECUTE
en el paqueteDBMS_CLOUD_AI
. Obtenga información sobre los privilegios adicionales necesarios para Select AI y sus funciones. - Ejemplos de privilegios para ejecutar Select AI
Revise ejemplos de privilegios necesarios para utilizar Select AI y sus funciones. - Configure Select AI to Use Supported AI Providers
Descubre cómo permitir que sus proveedores de IA utilicen Select AI.
Uso de DBMS_CLOUD_AI para configurar perfiles de AI
Autonomous Database utiliza perfiles de IA para facilitar y configurar el acceso a un LLM y para configurarlo para generar, ejecutar y explicar SQL basado en peticiones de datos de lenguaje natural. También facilita la recuperación de la generación aumentada mediante la incrustación de modelos e índices vectoriales y permite chatear con el LLM.
Los perfiles de IA incluyen objetos de base de datos que son el destino de las consultas de lenguaje natural. Los metadatos utilizados desde estos destinos pueden incluir nombres de tabla de base de datos, nombres de columna, tipos de dato de columna y comentarios. Puede crear y configurar perfiles AI mediante los procedimientos DBMS_CLOUD_AI.CREATE_PROFILE
y DBMS_CLOUD_AI.SET_PROFILE
.
Además de especificar tablas y vistas en el perfil de AI, también puede especificar tablas asignadas a tablas externas, incluidas las descritas en Consulta de datos externos con Data Catalog. Esto permite consultar datos no solo dentro de la base de datos, sino también datos almacenados en el almacén de objetos de un lago de datos.
Tema principal: Gestión de perfiles de AI
Realización de requisitos para Seleccionar IA
Antes de utilizar Select AI, estos son los pasos para activar DBMS_CLOUD_AI
.
Se necesita lo siguiente para utilizar DBMS_CLOUD_AI
:
- Acceso a una cuenta en la nube de Oracle Cloud Infrastructure y a una instancia de Autonomous Database.
- Cuenta de API de pago de un proveedor de IA compatible, una de las siguientes opciones:
Proveedor de IA Claves de API OpenAI
Consulte Uso de OpenAI para obtener las claves de API.
Proveedores compatibles con OpenAI
Consulte Uso de proveedores compatibles con OpenAI para obtener las claves de API y
provider_endpoint
.Cohere
Consulte Uso de Cohere para obtener sus claves API secretas.
Servicio OpenAI de Azure
Consulte Uso del servicio OpenAI de Azure para obtener más información sobre cómo configurar el servicio OpenAI de Azure. OCI Generative AI
Consulte Uso de OCI Generative AI.
Google
Consulte Uso de Google para obtener sus claves de API.
Antrópico
Consulte Uso de Anthropic para obtener sus claves de API.
Cara abrazada
Consulte Uso de Hugging Face para obtener sus claves de API.
AWS
Consulte Uso de AWS para obtener las claves de API y el ID de modelo.
- Privilegios de ACL de red para acceder al proveedor de AI externo.
Nota
Los privilegios de ACL de red no son necesarios para OCI Generative AI. - Credencial que proporciona acceso al proveedor de AI.
Tema principal: Gestión de perfiles de AI
Otorgar privilegios para seleccionar IA
Para utilizar Select AI, el administrador debe otorgar el privilegio EXECUTE
en el paquete DBMS_CLOUD_AI
. Obtenga información sobre los privilegios adicionales necesarios para Select AI y sus funciones.
DBMS_CLOUD_AI
:
-
Otorgue el privilegio
EXECUTE
en el paqueteDBMS_CLOUD_AI
al usuario que desea utilizar Select AI.De forma predeterminada, solo el administrador del sistema tiene el privilegio
EXECUTE
. El administrador puede otorgar el privilegioEXECUTE
a otros usuarios. -
Otorgue el privilegio
EXECUTE
enDBMS_CLOUD_PIPELINE
al usuario que desea utilizar Select AI con RAG. -
Otorgue acceso de ACL de red al usuario que desea utilizar Select AI y para el punto final del proveedor de AI.
El administrador del sistema puede otorgar acceso de ACL de red. Consulte procedimiento APPEND_HOST_ACE para obtener más información.
- Cree una credencial para permitir el acceso a su proveedor de AI.
Consulte Procedimiento CREATE_CREDENTIAL para obtener más información.
-
Otorgue cuotas en el tablespace para gestionar la cantidad de espacio en un tablespace específico al usuario que desea utilizar Select AI con RAG.
Tema principal: Gestión de perfiles de AI
Ejemplos de privilegios para ejecutar Select AI
Revise los ejemplos de privilegios necesarios para utilizar Select AI y sus funciones.
EXECUTE
a ADB_USER
:GRANT execute on DBMS_CLOUD_AI to ADB_USER;
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');
ADB_USER
el privilegio para utilizar el punto final api.openai.com.
Este procedimiento no se aplica a OCI Generative 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
Proveedores compatibles con OpenAI
Por ejemplo, para Fireworks AI, utilice api.fireworks.ai
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
AWS
bedrock-runtime.us-east-1.amazonaws.com
-
ace
: entradas de control de acceso (ACE). Se proporciona el tipoXS$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ámetrocredential_name
debe cumplir las convenciones de nomenclatura de objetos de Oracle. -
username
: los argumentosusername
ypassword
especifican conjuntamente las credenciales del proveedor de AI.username
es un nombre de usuario especificado por el usuario. -
password
: los argumentosusername
ypassword
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.
Proveedores compatibles con OpenAI
Consulte Uso de proveedores compatibles con OpenAI para obtener las claves de API y
provider_endpoint
.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 procedimientoDBMS_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.
AWS
Consulte Uso de AWS para obtener las claves de API y el ID de modelo.
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 tienenDATA
como prefijo.BYTES
: cantidad de espacio que utiliza actualmente el usuario en el tablespace.MAX_BYTES
: cuota máxima asignada (en bytes). SiMAX_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 tenerMAX_BYTES
suficientemente grande que los bytes para acomodar el índice vectorial, oMAX_BYTES
debe ser -1 para una cuota ilimitada.
Tema principal: Gestión de perfiles de IA
Configurar Select AI para utilizar proveedores de AI soportados
Descubre cómo permitir que tus proveedores de IA utilicen Select AI.
- Uso de Anthropic
Para permitir que la consola de desarrollador de Anthropic genere respuestas de texto y SQL a sus peticiones de datos en lenguaje natural, obtenga claves de API de su cuenta de pago de la consola de desarrollador de Anthropic. - Utilice AWS
Para activar AWS, obtenga su clave de API y su ID de modelo. - Uso del servicio OpenAI de Azure
Para permitir que el servicio OpenAI de Azure genere respuestas de texto y SQL a las peticiones de datos en lenguaje natural, configure y proporcione acceso al proveedor de IA. - Utilice Cohere
Para permitir que Cohere genere respuestas SQL y de texto a sus peticiones de datos en lenguaje natural, obtenga claves de API de su cuenta de pago de Cohere. - Uso de Google
Para permitir que Google AI Studio genere respuestas de texto y SQL a sus peticiones de datos en lenguaje natural, obtenga claves de API de su cuenta de pago de Google AI Studio. - Uso de Hugging Face
Para permitir que Hugging Face como proveedor de IA genere respuestas de texto y SQL a sus peticiones de datos en lenguaje natural, obtenga claves de API de su cuenta de pago de Hugging Face. - Uso de OCI Generative AI
Para permitir que OCI Generative AI genere respuestas de texto y SQL a sus peticiones de datos en lenguaje natural, genere una clave de firma de API. - Utilice OpenAI
Para activar OpenAI para generar respuestas de texto y SQL a las peticiones de datos de lenguaje natural, obtenga las claves de API de su cuenta de pago OpenAI. - Uso de proveedores compatibles con OpenAI
Para activar proveedores compatibles con OpenAI, obtenga su clave de API.
Tema principal: Gestión de perfiles de IA
Usar antrópico
Para permitir que Anthropic Developer Console genere respuestas de texto y SQL a sus peticiones de datos en lenguaje natural, obtenga claves de API de su cuenta de pago de Anthropic Developer Console.
Usar AWS
Para activar AWS, obtenga su clave de API y su ID de modelo.
Obtenga su clave de API y úsela para crear credenciales a través de DBMS_CLOUD.CREATE_CREDENTIAL
.
Siga este proceso para obtener la clave de API y el nombre del modelo:
Uso del servicio OpenAI de Azure
Para permitir que el servicio OpenAI de Azure genere respuestas de texto y SQL a sus peticiones de datos en lenguaje natural, configure y proporcione acceso al proveedor de IA.
Usar Cohere
Para permitir que Cohere genere respuestas de texto y SQL a sus peticiones de datos en lenguaje natural, obtenga claves de API de su cuenta de pago de Cohere.
-
Inicie sesión en el sitio web de Cohere con sus credenciales. El panel de control de Cohere aparece por defecto.
-
También puede hacer clic en Panel de control.
-
Haga clic en Claves de API en la navegación izquierda. Copie la clave de API por defecto o cree otra. Consulte API-Keys para obtener más información.
Usar Google
Para permitir que Google AI Studio genere respuestas de texto y SQL a sus peticiones de datos en lenguaje natural, obtenga claves de API de su cuenta de pago de Google AI Studio.
Usar cara abrazada
Para permitir que Hugging Face como proveedor de IA genere respuestas de texto y SQL a sus peticiones de datos en lenguaje natural, obtenga claves de API de su cuenta de pago de Hugging Face.
- Vaya a Hugging Face.
- Regístrate para obtener una cuenta si aún no tienes una.
- Vaya a la configuración de la cuenta.
- En el menú de navegación, busque los tokens de acceso.
- Haga clic para crear una nueva clave de API.
- Copie la clave de API generada y guárdela.
Uso de OCI Generative AI
Para permitir que OCI Generative AI genere respuestas de texto y SQL a sus peticiones de datos en lenguaje natural, genere una clave de firma de API.
Utilice OpenAI
Para permitir que OpenAI genere respuestas de texto y SQL a sus peticiones de datos en lenguaje natural, obtenga las claves de API de su cuenta de pago OpenAI.
Puede encontrar su clave de API secreta en el panel de control de perfil, en Claves de API.
Utilizar proveedores compatibles con OpenAI
Para activar proveedores compatibles con OpenAI, obtenga su clave de API.
Los proveedores compatibles con OpenAI utilizan autenticación de portador. Obtenga su clave de API y úsela para crear credenciales a través de DBMS_CLOUD.CREATE_CREDENTIAL
. Por ejemplo, Fireworks AI es un proveedor compatible con OpenAI.
Siga el proceso para obtener la clave de API de Fireworks AI, la URL de la ruta base del modelo y el nombre del modelo:
- Regístrate para obtener una cuenta de Fireworks AI si aún no tienes una.
- Cree una clave de API desde la consola de Fireworks AI.
- Copie la clave de API generada y guárdela.
- Obtenga el punto final del proveedor que necesita en el procedimiento
DBMS_CLOUD_AI.CREATE_PROFILE
: - En el mismo ejemplo de API, copie el nombre del modelo. Necesita el nombre de modelo en el procedimiento
DBMS_CLOUD_AI.CREATE_PROFILE
. Por ejemplo,accounts/fireworks/models/llama-v3p2-3b-instruct
.