Doc. Ref. 29105 Título: Como confiurar la Inteligencia Artificial (IA) en Hexa Autor: Soltec Última actualización: 01/04/2026 #inteligencia #artificial #copnfiguracion

---

Como configurar la Inteligencia Artificial (IA) en Hexa

Hexa puede usar dos proveedores de IA: OpenAI o Claude (Anthropic). A continuación se explica cómo dar de alta la clave API de cada proveedor y qué parámetros controlan qué proveedor y qué modelo usa cada funcionalidad de IA de Hexa.

1. Configurar OpenAI

1. Crear una cuenta en OpenAI: https://platform.openai.com/login
2. Generar una api key para proyecto por defecto y ponerle un nombre, por ejemplo "Hexa".
3. Introducir un metodo de pago y crear un plan de pago, por ejemplo $10, añadir $5 si bajamos de $5 de saldo y no gastar más de $10 al mes.
4. Configurar la clave API en el parámetro "OpenAIAPIKey" especificando usuario y equipo en el caso en que se quiera limitar el uso de cada ApiKey a un usuario o equipo concreto.

2. Configurar Claude (Anthropic)

1. Crear una cuenta en Anthropic: https://console.anthropic.com/login
2. Generar una api key y ponerle un nombre, por ejemplo "Hexa".
3. Introducir un metodo de pago y configurar un límite de gasto mensual.
4. Configurar la clave API en el parámetro "ClaudeAPIKey" especificando usuario y equipo en el caso en que se quiera limitar el uso de cada ApiKey a un usuario o equipo concreto.

3. Elegir el proveedor de IA (OpenAI o Claude) en cada funcionalidad

Hexa tiene varias funcionalidades de IA independientes entre si, cada una con su propio parámetro para elegir el proveedor. El valor admitido es "openai" o "claude"; si no se configura, se usa "openai" por defecto.

• "Preguntar a la IA": parámetro "IAProveedor".
• "Consulta SQL con IA": parámetro "IATextToSQLProveedor".
• "Extraer datos de factura con IA": parámetro "IAFacturaProveedor".

4. Elegir el modelo de IA en cada funcionalidad

Cada funcionalidad tiene su propio parámetro de modelo según el proveedor elegido:

• "Preguntar a la IA": parámetro "OpenAIModelo" (OpenAI) o "ClaudeModelo" (Claude).
• "Consulta SQL con IA": parámetro "OpenAITextToSQLModelo" (OpenAI) o "ClaudeTextToSQLModelo" (Claude).
• "Extraer datos de factura con IA": parámetro "OpenAIFacturaModelo" (OpenAI) o "ClaudeFacturaModelo" (Claude).

5. Otros parámetros generales de la IA

• "IAMaxTokens": número máximo de tokens de respuesta en "Preguntar a la IA" (por defecto 2000).
• "IAFacturaMaxTokens": número máximo de tokens de respuesta en "Extraer datos de factura con IA" (por defecto 4000).
• "IATimeoutSeconds": tiempo máximo de espera, en segundos, para "Preguntar a la IA" y para "Consulta SQL con IA" (por defecto 60).
• "IAFacturaTimeoutSeconds": tiempo máximo de espera, en segundos, para "Extraer datos de factura con IA" (por defecto 120).
• "IAMaxRows": número máximo de filas que puede devolver una consulta generada por "Consulta SQL con IA" (por defecto 100).

6. Parámetros propios de "Consulta SQL con IA"

Además de la clave API, el proveedor y el modelo, esta funcionalidad necesita estos parámetros obligatorios:

• "OpenAITextToSQLTablas": lista de tablas de negocio que la IA puede consultar.
• "OpenAITextToSQLReglasNegocio": reglas de negocio que se incluyen en la consulta a la IA.

Y estos parámetros opcionales:

• "OpenAITextToSQLColumnas": restringe las columnas permitidas por tabla; si está vacío, se usan las columnas definidas en la ficha de Campos.
• "OpenAITextToSQLDebug": activa un modo de diagnóstico para pruebas controladas (por defecto "No").

Todos los parámetros anteriores admiten especificar usuario y equipo, para poder limitar o personalizar la configuración de la IA a un usuario o equipo concreto.

Volver a la búsqueda anterior