Directrices de Oracle Database de la herramienta RAG para agentes de IA generativa

Antes de utilizar un almacén de vectores de Oracle Database versión 23ai como opción de datos para agentes de IA generativa, asegúrese de comprender lo que está soportado y de realizar las tareas necesarias.

Tipos de base de datos

Generative AI Agents soporta incrustaciones de vectores BYO desde:

• Oracle Base Database 23ai: la base de datos se puede configurar en una red privada. Consulte Creación de un sistema de base de datos.

• Oracle Autonomous Database 23ai solo de los siguientes tipos de acceso de red:

  • Solo acceso de punto final privado: la autenticación TLS mutua (mTLS) se puede activar para autenticar conexiones a la base de datos. Seleccione la casilla de control Requerir autenticación TLS mutua (mTLS) para activar la autenticación mTLS.

  • Acceso seguro desde cualquier lugar: la autenticación mTLS está activada por defecto y es necesaria.

  Consulte Creación de una instancia de Autonomous Database.

Bases de datos autónomas activadas para autenticación mTLS

Si la base de datos autónoma está activada para la autenticación mTLS, debe descargar la cartera, crear una contraseña de cartera y extraer un archivo de la cartera. Consulte Requisitos de seguridad de cartera en el paso 3. Configurar los requisitos de red y seguridad.

Soporte de base de datos entre regiones y entre arrendamientos

El soporte de base de datos entre regiones y entre arrendamientos solo está disponible para Oracle Database 23ai con acceso de red privada. Esto incluye Oracle Base Database y Oracle Autonomous Database configuradas por el tipo de acceso de red Solo acceso de punto final privado. Las bases de datos autónomas con acceso público no están soportadas.

Al utilizar agentes de IA generativa en una región alojada, puede conectarse a una base de datos de acceso privado que resida en:

• Otra región dentro del mismo arrendamiento. Active la conectividad creando una conexión de herramientas de base de datos en la región en la que está disponible el servicio de agente.
• Otro arrendamiento. Active la conectividad creando una conexión de herramientas de base de datos en el arrendamiento donde esté disponible el servicio de agente.

Para configurar la configuración de red, consulte Networking Requirements (Cross-region and Cross-tenancy database) en el paso 3. Configurar los requisitos de red y seguridad.

Para crear una conexión, introduzca la cadena de conexión manualmente como se describe en el Step 5. Crear conexiones de Database Tools.

Además de proporcionar al usuario acceso a todos los recursos de agentes de IA generativa, como se describe en Adding Policies Before You Can Use the Service, debe crear un grupo dinámico con acceso a secretos de almacén y herramientas de base de datos.

1. Crear un grupo dinámico y agregar las siguientes reglas de coincidencia.

   ALL {resource.type='genaiagent'}

   Si necesita ayuda, consulte Creación de un grupo dinámico.

2. Conceda permisos al grupo dinámico.

   • Escriba las siguientes políticas, que se pueden utilizar con el dominio de identidad por defecto:

     allow dynamic-group <dynamic-group-name> 
     to read database-tools-family in compartment <compartment-name>
     
     allow dynamic-group <dynamic-group-name> 
     to read secret-bundle in compartment <compartment-name>
     

   • Utilice las siguientes políticas con un dominio de identidad no por defecto, proporcionando el nombre de dominio de Oracle Identity Cloud Service (IDCS) y el nombre de grupo dinámico:

     allow dynamic-group '<idcs-domain-name>/<dynamic-group-name>' 
     to read database-tools-family in compartment <compartment-name>
     
     allow dynamic-group '<idcs-domain-name>/<dynamic-group-name>' 
     to read secret-bundle in compartment <compartment-name>
     

allow any-user to read database-tools-family in compartment <compartment-name> where any {request.principal.type='genaiagent'}

allow any-user to read secret-bundle in compartment <compartment-name> where any {request.principal.type='genaiagent'}

Realice estas tareas si aún no configuró ni creó los recursos necesarios.

Requisitos de Red

• Agregue la base de datos a la subred privada de una VCN.
• Configure las siguientes propiedades para la regla de entrada de la subred:
  • Tipo de origen: CIDR
  • CIDR de origen: bloque IPv4 CIDR de la VCN (como 10.0.0.0/16)
  • Protocolo IP: TCP
  • Rango de puertos de origen: Todo
  • Rango de puertos de destino: 1521-1522

Requisitos de red (base de datos entre regiones y entre arrendamientos)

Los siguientes requisitos solo son aplicables a Oracle Database 23ai con acceso de red privada. Esto incluye Oracle Base Database y Oracle Autonomous Database configuradas por el tipo de acceso de red Solo acceso de punto final privado. Las bases de datos autónomas con acceso público no están soportadas.

Configuración de Red

• Configure dos redes virtuales en la nube con CIDR no superpuestos. Para configurar los valores de red, consulte Intercambio de tráfico remoto de VCN.
• En la VCN de la base de datos, asegúrese de agregar la regla de entrada para que el CIDR de la VCN de la conexión de herramientas de base de datos acceda a los puertos de base de datos 1521-1522.

Ejemplo de base de datos entre regiones: puede conectarse a una base de datos que se encuentre en una región diferente a la que se está ejecutando el servicio Generative AI Agents. Por ejemplo:

• El servicio de agente se está ejecutando en el arrendamiento A de la región ORD.

• La base de datos base de Oracle u Oracle Autonomous Database con acceso de red privada se despliega en la región PHX.

• Para acceder a la base de datos privada, configure gateways de enrutamiento dinámico (DRG) en ambas regiones y configure una conexión de herramientas de base de datos en ORD para conectarse a la base de datos en PHX.

Ejemplo de base de datos entre arrendamientos: puede conectarse a una base de datos que esté ubicada en un arrendamiento diferente del servicio Generative AI Agents. Por ejemplo:

• El servicio de agente se está ejecutando en el arrendamiento A de la región ORD.

• La base de datos base de Oracle u Oracle Autonomous Database con acceso de red privada se despliega en el arrendamiento B de la región PHX.

• Para acceder a la base de datos privada, configure gateways de enrutamiento dinámico (DRG) en ambos arrendamientos y configure una conexión de herramientas de base de datos en el arrendamiento A (región ORD) para conectarse a la base de datos en el arrendamiento B (región PHX).

La configuración de red entre arrendamientos se aplica independientemente de si el servicio de base de datos y el servicio de agente están en la misma región o en diferentes regiones.

Requisitos de seguridad de Vault

Se necesita un almacén en OCI Vault para almacenar secretos para la base de datos, como la contraseña de la base de datos.

Cree el almacén en el mismo compartimento que la conexión de herramientas de base de datos. Esto se aplica a las bases de datos de la misma región que el servicio Agentes de IA generativa y a las bases de datos entre regiones o entre arrendamientos.

1. Crear un almacén.
2. Cree una clave de cifrado maestra.
3. En el almacén, cree un secreto para la contraseña de la base de datos.

Requisitos de seguridad de cartera

Si la base de datos autónoma está activada para la autenticación mTLS, realice las siguientes tareas:

1. Descargue la cartera y cree una contraseña de cartera. Consulte Descarga de credenciales de cliente (carteras).
2. Desde el zip de cartera descargado, extraiga el archivo ewallet.p12 y déjelo a un lado. Necesita la cartera PKCS#12 para crear la conexión de herramientas de base de datos.

En la base de datos que ha creado para utilizarla con agentes de IA generativa, cree una tabla de base de datos con determinados campos necesarios y configure una función de base de datos que devuelva resultados de búsqueda vectorial de consultas.

Tabla de la Base de Datos

Cree una tabla de Oracle Database 23ai con los siguientes campos:

Campos necesarios

• DOCID: ID asignado a cada registro o documento
• BODY: contenido real que desea que busque el agente
• VECTOR: vector generado a partir de un modelo de embebido basado en el contenido body

Campos Opcionales

• CHUNKID: ID del documento fragmentado, en caso de que el documento tenga más de 512 tokens.
• URL: referencia de URL para el contenido, si está disponible.
• TITLE: título del contenido de body
• PAGE_NUMBERS: números de página para el contenido, si están disponibles.

Consejo

Puede crear incrustaciones de texto en OCI Generative AI.

Función de Base de Datos

Una función es un subprograma que puede tener parámetros y devolver un valor. Debe configurar una función de base de datos que pueda devolver resultados de búsqueda vectorial de cada consulta. Estos son los requisitos:

Parámetros de Entrada

• p_query: cadena de consulta
• top_k: número de resultados principales

Tipo de Retorno

• SYS_REFCURSOR

Requisitos

• El modelo de embebido que utilice para el campo de consulta de la función debe ser el mismo que el modelo de embebido que transforma el contenido BODY de la tabla en embebidas vectoriales.

• Los campos devueltos de la función deben coincidir con los campos obligatorios de la tabla (DOCID, BODY y SCORE) y opcionales (CHUNKID, TITLE y URL).

  El contenido BODY se procesa mediante un modelo de embebido para producir un VECTOR para cada contenido. La función calcula las distancias entre el vector de consulta y cada VECTOR, devolviendo las filas top_k. El campo SCORE representa las distancias entre el vector de consulta y VECTOR de BODY.

• Si los nombres de campo de retorno de la función no coinciden con los nombres de campo de tabla, debe utilizar alias en la función.

Ejemplo

A continuación se muestra un ejemplo de una función de base de datos:

create or replace FUNCTION RETRIEVAL_FUNC (p_query IN VARCHAR2,top_k IN NUMBER) RETURN SYS_REFCURSOR IS
    v_results SYS_REFCURSOR;
    query_vec VECTOR;
BEGIN
    query_vec := dbms_vector.utl_to_embedding(
        p_query,
        json('{
            "provider": "OCIGenAI",
            "credential_name": "OCI_VECTOR_CREDENTIAL",
            "url": "https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/20231130/actions/embedText",
            "model": "cohere.embed-english-v3.0"
        }')
    );

    OPEN v_results FOR
        select l.id as DOCID, lv.chunk_id as CHUNKID, l.file_name as TITLE, 
        'https://objectstorage.us-chicago-1.oraclecloud.com/n/{namespace}/b/{bucket_name}/o/' || l.file_name as URL,
        lv.chunk_txt as BODY, vector_distance(embed_vector, query_vec) AS SCORE
        from legislation_vector lv, legislation l
        where l.id = lv.id
        order by SCORE 
        fetch first top_k rows only;

    RETURN v_results;
END;

Puede crear conexiones reutilizables a una base de datos Oracle en OCI mediante el servicio Database Tools.

Siga estas directrices para crear una conexión para la base de datos.