azure_ai extensión en Azure Database for PostgreSQL

La extensión azure_ai en Azure Database for PostgreSQL permite el uso en base de datos de modelos de lenguaje grandes (LLM) para crear aplicaciones de IA generativas. Permite que la base de datos llame a Azure OpenAI en modelos Microsoft Foundry, Azure OpenAI Service, Azure Cognitive Services (Azure Language in Foundry Tools) y Azure Machine Learning Services, simplificando el desarrollo a través de una integración perfecta con estos servicios.

Habilitación de la extensión azure_ai

Para poder usar la extensión azure_ai, debe incluirla en la lista de permitidos y, a continuación, instalarla en la instancia de Azure Database for PostgreSQL. Siga los pasos que se indican a continuación para empezar.

Lista de permitidos de la extensión

Agregue azure_ai a la lista de permisos del servidor flexible de Azure Database para PostgreSQL tal como se describe en cómo usar las extensiones de PostgreSQL. Compruebe que se ha agregado correctamente mediante la ejecución de la SHOW azure.extensions; consulta.

Instalación de la extensión

Conéctese a la base de datos y ejecute el CREATE EXTENSION comando :

CREATE EXTENSION IF NOT EXISTS azure_ai;

Repita este comando para cada base de datos donde se requiera la extensión.

Al instalar azure_ai, crea los esquemas siguientes:

• azure_ai: esquema principal para la configuración y las funciones relacionadas
• azure_openai: funciones y tipos para Azure OpenAI en Modelos Foundry y Modelos OpenAI en Microsoft Foundry
• azure_cognitive: funciones y tipos para Azure Cognitive Services (Azure Language in Foundry Tools)
• azure_ml: funciones y tipos para Azure Machine Learning Services

Configuración de la extensión azure_ai

Para configurar la extensión, proporcione puntos de conexión y detalles de autenticación (clave de API o identidad administrada) para los servicios de inteligencia artificial y aprendizaje automático Azure que quiera usar. Use la azure_ai.set_setting función de configuración con varias claves de configuración para almacenar estos valores.

Permissions

La extensión define un rol azure_ai_settings_manager que concede permiso para leer y escribir valores de configuración mediante las azure_ai.set_getting funciones y azure_ai.set_setting . Solo los superusuarios y los miembros de este rol pueden usar estas funciones. En Azure Database for PostgreSQL Flexible Server, el rol azure_pg_admin asigna automáticamente este rol.

Funciones de configuración

azure_ai_set_setting

Establece la configuración de IA y aprendizaje automático.

Uso:

-- Syntax
azure_ai.set_setting(key TEXT, value TEXT)

-- Usage example: Set the Endpoint and an API Key for Azure OpenAI
select azure_ai.set_setting('azure_openai.endpoint','https://<endpoint>.openai.azure.com');
select azure_ai.set_setting('azure_openai.subscription_key', '<API Key>');

Lista de claves y valores de configuración admitidos:

azure_ai.get_setting

Obtiene los valores de configuración actuales de un determinado key (consulte las claves admitidas en la lista anterior). Devuelve TEXT que representa el valor actual de la configuración seleccionada.

Uso:

-- Syntax
azure_ai.get_setting(key TEXT)

-- Usage example: Get the Endpoint and API Key for Azure OpenAI
select azure_ai.get_setting('azure_openai.endpoint');
select azure_ai.get_setting('azure_openai.subscription_key');

azure_ai.version

Devuelve TEXT que representa la versión actual de la azure_ai extensión.

Uso:

SELECT azure_ai.version()

Habilitación de la autenticación de identidad administrada

La extensión azure_ai para Azure Database for PostgreSQL admite la identidad administrada asignada por el sistema (SAMI), que ofrece ventajas de seguridad mejoradas. Mediante el uso de Microsoft Entra ID, puede autenticarse sin claves de acceso, lo que reduce el riesgo de acceso no autorizado y simplifica la administración de credenciales.

Para habilitar la autenticación de identidad administrada, consulte esta guía paso a paso.

Funcionalidades de la azure_ai extensión

Funciones de IA

La extensión azure_ai habilita llamadas desde la base de datos a modelos hospedados en Foundry y Azure OpenAI a través de las siguientes funciones AI (versión preliminar):

• Generar incrustaciones de vectores con Azure OpenAI en Azure Database for PostgreSQL: crea incrustaciones vectoriales para un texto de entrada determinado.
• azure_ai.generate(): genera texto o salida estructurada mediante modelos de lenguaje grande (LLM).
• azure_ai.is_true(): evalúa la probabilidad de que una declaración determinada sea verdadera.
• azure_ai.extract(): extrae características estructuradas o entidades del texto.
• azure_ai.rank(): reorganiza una lista de documentos según la relevancia de una consulta dada.

Capacidades adicionales

La extensión también admite la invocación

• Integra Azure Database para PostgreSQL con Azure Cognitive Services: facilita tareas como el análisis de sentimiento directamente en la base de datos.
• Integrar Azure Database for PostgreSQL con Azure Machine Learning Services: Permitir la llamada a modelos desde el catálogo de Machine Learning o a implementaciones entrenadas personalizadas.

Actualización de la extensión ai + machine learning

Para comprobar la versión instalada y las actualizaciones disponibles, ejecute:

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

Para actualizar la extensión a la versión compatible más reciente, ejecute:

ALTER EXTENSION azure_ai UPDATE;

Contenido relacionado

• Funciones de IA en la extensión azure_ai (versión preliminar)
• Generación de incrustaciones de vectores con Azure OpenAI en Azure Database for PostgreSQL
• Habilitación y uso de pgvector en Azure Database for PostgreSQL
• Tutorial: Creación de una búsqueda semántica con Azure Database for PostgreSQL y Azure OpenAI
• Integración de Azure Database for PostgreSQL con Azure Machine Learning Services