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 activar DBMS_CLOUD_AI.
Otorgar privilegios para seleccionar AI
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.
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.
Creación y definición de un perfil de AI
Describe los pasos para crear y activar un perfil de AI.

Consulte también:

Utiliza Select AI para la interacción de lenguaje natural con tu base de datos

Tema principal: Uso de Select AI for Natural Language Interaction con la base de datos

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.

Para configurar DBMS_CLOUD_AI:

Otorgue el privilegio EXECUTE en el paquete DBMS_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 privilegio EXECUTE a otros usuarios.
Otorgue el privilegio EXECUTE en DBMS_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.

En el siguiente ejemplo se otorga el privilegio 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');

En el siguiente ejemplo se otorga a ADB_USER el privilegio para utilizar el punto final api.openai.com.

Nota

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

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.

Vaya a Anthropic Developer Console.
Regístrate para obtener una cuenta si aún no tienes una.
Una vez conectado, vaya a la sección API o al panel de control.
Busque una opción para generar o ver claves de API.
Haga clic para crear una nueva clave de API.
Copie la clave de API generada y guárdela.
La API de Claude es un servicio de pago. Tendrás que agregar créditos a tu cuenta para poder usar la clave de API.

Tema principal: Configurar selección de IA para utilizar proveedores de IA soportados

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:

Regístrese en una cuenta de AWS si aún no tiene una.
Cree las claves de acceso y las claves secretas desde la consola Bedrock de AWS.
Copie las claves generadas y guárdelas.
Solicite acceso a sus modelos básicos. Consulte Acceso a los modelos básicos de Amazon Bedrock.
Obtenga el ID de modelo. Necesita el ID de modelo en el procedimiento DBMS_CLOUD_AI.CREATE_PROFILE. El ID de modelo depende de los recursos que utilice. Si utiliza:
- un modelo base, especifique el ID de modelo o su ARN (nombres de recursos de Amazon). Para obtener una lista de los ID de modelo para los modelos base, consulte ID de modelo base de Amazon Bedrock.
- un perfil de inferencia, especifique el ID de perfil de inferencia o su ARN. Para obtener una lista de los ID de perfil de inferencia, consulte Regiones y modelos admitidos para inferencia entre regiones.
- un modelo aprovisionado, especifique el ARN del rendimiento aprovisionado. Para obtener más información, consulte Ejecución de inferencia mediante un rendimiento aprovisionado.
- un modelo personalizado, adquiera el rendimiento aprovisionado para él. A continuación, especifique el ARN del modelo aprovisionado resultante. Para obtener más información, consulte Uso de un modelo personalizado en Amazon Bedrock.
- un modelo de Amazon Bedrock Marketplace, especifique el ID o la ARN del punto final de mercado que ha creado; consulte Amazon Bedrock Marketplace.
Nota

El modelo importado no está soportado con la API de Bedrock Converse.

Para usar AWS como proveedor, consulte Ejemplo: selección de IA con AWS.

Tema principal: Configurar selección de IA para utilizar proveedores de IA soportados

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.

Para utilizar el servicio OpenAI de Azure, realice los siguientes pasos:

Obtenga sus claves API secretas. Puede encontrar sus claves de API en la sección Resource Management de su portal de Azure. En la página Recurso de servicio OpenAI de Azure, haga clic en Claves y punto final. Puede copiar KEY1 o KEY2.
Cree un recurso de servicio OpenAI de Azure y despliegue un modelo: Cree y despliegue un recurso de servicio OpenAI de Azure.
Consejo:
- Anote el nombre de recurso y el nombre de despliegue, ya que estos parámetros se utilizan para proporcionar permiso de acceso de red y para crear el perfil de servicio OpenAI de Azure mediante el procedimiento DBMS_CLOUD_AI.CREATE_PROFILE.
- Para obtener más información sobre los límites de frecuencia para el token por minuto en un modelo, consulte Cuotas y límites del servicio OpenAI de Azure.
Permitir acceso al servicio OpenAI de Azure:
- Puede utilizar su clave de API secreta para permitir el acceso al servicio OpenAI de Azure. Para obtener más información, consulte el ejemplo en Examples of Using Select AI.
- Permita que la entidad de servicio acceda al servicio OpenAI de Azure y otorgue los permisos necesarios a la entidad de servicio: Uso de una entidad de servicio de Azure para acceder a los recursos de Azure y Control de acceso basado en roles para el servicio OpenAI de Azure. Para obtener más información, consulte el ejemplo en Examples of Using Select AI.

Tema principal: Configurar selección de IA para utilizar proveedores de IA soportados

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.

Tema principal: Configurar selección de IA para utilizar proveedores de IA soportados

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.

Vaya a Google AI Studio.
Haga clic en Iniciar sesión en Google AI Studio.
Haga clic en Obtener clave de API en la pantalla de petición de datos.
Seleccione todas las opciones aplicables en la página siguiente.
Haga clic en Create API key.
Haga clic en Create API key en el nuevo proyecto.
La pantalla muestra el progreso y genera una clave de API. Copie la clave y guárdela.

Tema principal: Configurar selección de IA para utilizar proveedores de IA soportados

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.

Tema principal: Configurar selección de IA para utilizar proveedores de IA soportados

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 la consola o la línea de comandos para generar una clave de firma de API para cualquier instancia de Oracle Database. Consulte Cómo generar la clave de firma de API.

Tema principal: Configurar selección de IA para utilizar proveedores de IA soportados

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.

Tema principal: Configurar selección de IA para utilizar proveedores de IA soportados

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:
1. Seleccione uno de los modelos disponibles haciendo clic en los modelos disponibles.
2. Desplácese hasta el ejemplo de API y obtenga la ruta de URL base compatible con OpenAI.
  Para el modelo Llama 3.2 3B Instruct, la URL de ruta de acceso base es: https://api.fireworks.ai/inference/v1/chat/completions. Para el parámetro provider_endpoint, excluya /v1/chat/completions. El valor provider_endpoint para el modelo mencionado es https://api.fireworks.ai/inference.
  
  Nota
  
  Algunos proveedores pueden necesitar un prefijo para el nombre del modelo. Consulte la documentación del proveedor de AI para obtener el formato correcto.
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.

Para utilizar Firework AI como proveedor compatible con OpenAI, consulte Ejemplo: Seleccionar AI con proveedores compatibles con OpenAI.

Tema principal: Configurar selección de IA para utilizar proveedores de IA soportados

Creación y definición de un perfil de AI

Describe los pasos para crear y activar un perfil de AI.

Utilice DBMS_CLOUD_AI.CREATE_PROFILE para crear un perfil de AI. Ejecute DBMS_CLOUD_AI.SET_PROFILE para activar el perfil AI para que pueda utilizar SELECT AI con una petición de datos de lenguaje natural.

Nota

Debe ejecutar DBMS_CLOUD_AI.SET_PROFILE en cada nueva sesión de base de datos con estado (conexión) antes de utilizar SELECT AI. Si utiliza una conexión sin estado, debe utilizar la función DBMS_CLOUD_AI.GENERATE, que le permite especificar el nombre de perfil en cada llamada.

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.

Tema principal: Gestión de perfiles de IA

Documentación de Oracle Cloud Infrastructure