Gestionar perfiles de IA

Puede crear y gestionar sus perfiles de AI mediante el paquete DBMS_CLOUD_AI.

Utilice 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 configurar la generación, ejecución y explicación de SQL en función de peticiones de datos en lenguaje natural. También facilita la recuperación de la generación aumentada utilizando modelos de incrustación e índices vectoriales y permite chatear con el LLM.
Realización de requisitos previos 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 configuración de un perfil de IA
Describe los pasos para crear y activar un perfil de IA.

Consulte también:

Utilice Select AI para la interacción de lenguaje natural con su base de datos

Tema principal: Uso de Seleccionar IA para la interacción de lenguaje natural 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 configurar la generación, ejecución y explicación de SQL en función de peticiones de datos en lenguaje natural. También facilita la recuperación de la generación aumentada utilizando modelos de incrustación e índices vectoriales y permite chatear con el LLM.

Los perfiles de AI incluyen objetos de base de datos que son el destino de las consultas en 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. Los perfiles AI se crean y configuran mediante los procedimientos DBMS_CLOUD_AI.CREATE_PROFILE y DBMS_CLOUD_AI.SET_PROFILE.

Además de especificar tablas y vistas en el perfil AI, también puede especificar tablas asignadas con tablas externas, incluidas las descritas en Consulta de datos externos con Data Catalog. Esto le permite consultar datos no solo dentro de la base de datos, sino también los datos almacenados en el almacén de objetos de un lago de datos.

Tema principal: Gestión de perfiles de IA

Realizar requisitos previos para seleccionar IA

Antes de utilizar Select AI, estos son los pasos para activar DBMS_CLOUD_AI.

Para utilizar DBMS_CLOUD_AI es necesario lo siguiente:

Acceso a una cuenta en la nube de Oracle Cloud Infrastructure y a una instancia de Autonomous Database.

Una cuenta de API de pago de un proveedor de IA compatible, una de las siguientes:

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 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 API.
Antropología	Consulte Uso de Anthropic para obtener sus claves de API.
Hugging Face	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 a su 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 IA.

Tema principal: Gestión de perfiles de IA

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.

Por defecto, 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 Seleccionar 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 a la ACL de red. Consulte APPEND_HOST_ACE Procedure para obtener más información.
Cree una credencial para permitir el acceso a su proveedor de IA.
Consulte CREATE_CREDENTIAL Procedure 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 with RAG.

Tema principal: Gestión de perfiles de IA

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 nombre de host o dominio no distingue entre mayúsculas y minúsculas.

Proveedor de IA	Anfitrión
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
Antropología	api.anthropic.com
Hugging Face	api-inference.huggingface.co
AWS	bedrock-runtime.us-east-1.amazonaws.com

ace: entradas de control de acceso (ACE). El tipo XS$ACE_TYPE se proporciona para crear cada entrada 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 juntos especifican las credenciales del proveedor de AI.

username es un nombre de usuario especificado por el usuario.

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

password es su clave de API secreta de 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 el principal de servicio OpenAI de Azure para autenticarse, puede omitir el procedimiento `DBMS_CLOUD.CREATE_CREDENTIAL`. Consulte Ejemplos de uso de Select AI para obtener un ejemplo de autenticación con el principal 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 sus claves de API.
Antropología	Consulte Uso de Anthropic para generar sus claves de API.
Hugging Face	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 with 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 la base de datos que crea el índice vectorial debe tener MAX_BYTES suficientemente mayor 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.

Utiliza Anthropic
Para permitir que Anthropic Developer Console genere respuestas SQL y de texto a tus peticiones de datos en lenguaje natural, obtén claves de API de tu cuenta de pago de Anthropic Developer Console.
Utilice AWS
Para activar AWS, obtenga su clave de API y su ID de modelo.
Utilice el servicio OpenAI de Azure
Para permitir que el servicio OpenAI de Azure genere respuestas SQL y de texto a las peticiones de datos en lenguaje natural, configure y proporcione acceso al proveedor de IA.
Utiliza Cohere
Para permitir que Cohere genere respuestas SQL y de texto a tus peticiones de datos en lenguaje natural, obtén claves de API de tu cuenta de pago Cohere.
Utiliza Google
Para permitir que Google AI Studio genere respuestas SQL y de texto a tus peticiones de datos en lenguaje natural, obtén claves de API de tu cuenta de pago de Google AI Studio.
Utiliza Hugging Face
Para permitir que Hugging Face sea tu proveedor de IA para generar respuestas SQL y de texto a tus peticiones de datos en lenguaje natural, obtén claves de API de tu cuenta de pago Hugging Face.
Utiliza OCI Generative AI
Para permitir que OCI Generative AI genere respuestas SQL y de texto a tus peticiones de datos en lenguaje natural, genera una clave de firma de API.
Utilice OpenAI
Para permitir que OpenAI genere respuestas SQL y de texto a las peticiones de datos en lenguaje natural, obtenga 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 Antropic

Para permitir que Anthropic Developer Console genere respuestas SQL y de texto 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á que agregar créditos a su 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 Azure OpenAI Service genere respuestas SQL y de texto 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 de 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 del 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 información sobre los límites de frecuencia para el token por minuto en un modelo, consulte Límites y cuotas 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 de Examples of Using Select AI.
- Permita que el principal de servicio acceda al servicio OpenAI de Azure y otorgue los permisos necesarios al principal de servicio: Utilice el principal de servicio de Azure para acceder a 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 de 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 SQL y de texto a sus peticiones de datos en lenguaje natural, obtenga claves de API de su cuenta de pago Cohere.

Inicie sesión en el sitio web de Cohere con sus credenciales. El panel de control de Cohere aparece por defecto.
Como alternativa, haga 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 clave. 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 SQL y de texto 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.
Haz 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 Crear clave de API.
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 de abrazo

Para permitir que Hugging Face sea tu proveedor de IA para generar respuestas SQL y de texto a tus peticiones de datos en lenguaje natural, obtén claves API de tu cuenta de pago Hugging Face.

Vaya a Hugging Face.
Regístrate para obtener una cuenta si aún no tienes una.
Vaya a la configuración de su cuenta.
En el menú de navegación, localice 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 SQL y de texto 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 una 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 SQL y de texto a las peticiones de datos en lenguaje natural, obtenga claves de API de su cuenta de pago OpenAI.

Puede encontrar su clave de API secreta en su 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

Crear y establecer 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 de modo que pueda utilizar SELECT AI con un indicador 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