La inteligencia artificial es una opción de Portail ZAPP: añade asistentes (resúmenes, sugerencias, ayuda a la redacción, chatbot de las bases de conocimientos públicas) y la búsqueda semántica. Todas las funciones de la aplicación funcionan sin ella. Está desactivada en la instalación: no se envía nada a ningún servicio de IA mientras no elijas un proveedor.
La pantalla Configuración de IA (menú Administración › Instancia y operaciones › IA) está reservada a los Administradores.
Elegir los proveedores
La pestaña General contiene dos elecciones independientes:
- Proveedor de chat activo: el servicio que redacta (asistentes, chatbot). Opciones posibles: OpenAi, Anthropic, AzureOpenAi, Mistral, Ollama, Groq;
- Proveedor de embeddings activo: el servicio que calcula la proximidad de sentido entre textos, para la búsqueda semántica y para que el chatbot encuentre los pasajes de artículos útiles. Opciones posibles: OpenAi, AzureOpenAi, Mistral, Ollama (Anthropic y Groq no lo ofrecen).
Cada uno propone también Ninguno (IA desactivada). Haz clic en Guardar: la elección se aplica sin reiniciar y queda registrada en el historial de la pantalla Configuración.
Si tu suscripción incluye la IA del editor
Cuando la licencia de la instancia incluye la IA del editor, la pestaña General muestra el recuadro IA proporcionada por el editor, y las dos listas proponen en primer lugar la opción IA proporcionada por el editor. Esta opción no requiere clave ni modelo.
- El uso se descuenta de un crédito de tokens. El recuadro indica el Crédito restante (saldo sobre el total de las recargas vigentes) y muestra Crédito agotado cuando ya no queda.
- Crédito agotado: los asistentes de IA dejan de responder. La búsqueda semántica sigue funcionando.
- Para usar tu propia IA, elige otro proveedor y completa su pestaña: el descuento se detiene y el crédito restante se conserva.
Sin esta licencia, por ejemplo en una instancia instalada en tus servidores, no aparecen ni el recuadro ni esta opción. El seguimiento del crédito y sus alertas están en la pantalla Consumo.
Configurar un proveedor
Cada proveedor tiene su pestaña, con su propio botón Guardar. Guardar una pestaña no lo activa: el proveedor activo se elige en General.
- Clave API: la proporciona el servicio. Nunca se vuelve a mostrar; deja el campo vacío para conservar la clave guardada;
- URL base: la dirección de la API, rellenada con la del servicio; cámbiala solo para pasar por un intermediario;
- Modelo de chat y, salvo para Anthropic y Groq, que no calculan embeddings, Modelo de embedding: los nombres de modelos del proveedor, rellenados con un valor habitual;
- Azure OpenAI pide en su lugar el Endpoint de tu recurso, los nombres de tus Despliegue de chat y Despliegue de embeddings (campos marcados con un asterisco, obligatorios), así como la Versión de API;
- Ollama es un servidor que alojas tú: sin clave, solo su URL base y sus modelos. Así los textos no salen de tu infraestructura.
Por seguridad, las direcciones a las que se puede llegar dependen del proveedor:
- OpenAI y Azure OpenAI: una dirección pública o una dirección de tu red privada — por ejemplo una pasarela compatible con OpenAI que alojas tú, o un recurso de Azure OpenAI detrás de un punto de conexión privado (Private Endpoint);
- Anthropic, Mistral y Groq: solo una dirección pública;
- Ollama: la propia máquina (
localhost, valor por defecto) o tu red privada.
Las direcciones reservadas (enlace local, metadatos de un proveedor de nube) se rechazan siempre. Las llamadas no siguen ninguna redirección: la clave nunca se envía a otra dirección que la indicada. Si tu servidor solo sale a Internet por un proxy, decláralo en la instalación (variables HTTPS_PROXY y NO_PROXY): las llamadas pasan entonces por él.
Con los demás proveedores, los textos tratados (contenido de un ticket, de un artículo…) se envían a su servicio en el momento en que un usuario pide una acción de IA.
Si cambias de proveedor o de modelo de embeddings, haz clic después en Reindexar todos los artículos publicados en la ficha de cada base de conocimientos: los artículos ya indexados lo fueron con el modelo anterior.
Lectura de documentos e imagen (pestaña Capacidades)
Además de la conversación y los embeddings, la IA ofrece dos capacidades, cada una con su propio proveedor. Siguen desactivadas mientras no les elijas uno, también en una instancia ya configurada: elegir un proveedor de chat no activa ni la lectura de documentos ni la imagen.
La pestaña Capacidades tiene una sección por capacidad:
- Lectura de documentos: un PDF o la imagen de un documento, también escaneado, se convierte en texto por página con sus tablas y, si se pide, campos extraídos. OpenAI, Anthropic y Mistral (Mistral OCR) leen PDF e imágenes; Azure OpenAI solo lee imágenes (PNG, JPEG);
- Imagen: generación de una imagen a partir de una instrucción, o retoque de una imagen con una máscara opcional. OpenAI y Azure OpenAI.
Cada sección contiene:
- Proveedor: Ninguno (IA desactivada) o uno de los proveedores que ofrecen realmente la capacidad; IA proporcionada por el editor en primer lugar si tu licencia la incluye;
- Modelo: vacío para el modelo predeterminado del proveedor. Con Azure OpenAI, introduce el nombre de tu implementación, obligatorio. Con la IA del editor, el modelo lo elige el editor;
- Tamaño máximo de archivo (MB): de 1 a 20 MB, 10 por defecto. Un archivo más grande se rechaza antes de cualquier envío.
La clave de API no se introduce aquí: la de la pestaña del proveedor, cifrada en reposo, sirve para todas sus capacidades.
Lo que se envía al proveedor y lo que se conserva se describe en «Leer documentos con la IA» y «Producir imágenes con la IA». La transcripción de voz tendrá su sección cuando se entreguen sus proveedores.
Elegir un proveedor o un modelo por función (pestaña Funciones)
De forma predeterminada, cada función que llama a la IA (clasificación de tickets, ayuda a la redacción, lectura de facturas…) usa el proveedor y el modelo de su capacidad. La pestaña Funciones enumera las funciones que han llamado a la IA en los últimos 90 días, con su nombre técnico, y su Proveedor y modelo efectivos. Puedes asignarles otros: por ejemplo un modelo ligero para la clasificación y uno más potente para la redacción.
Para añadir un reemplazo, haz clic en Reemplazar en la fila de la función (su función y su capacidad ya están rellenadas), o en Añadir un reemplazo debajo de la lista e introduce su código. Se abre el formulario Nuevo reemplazo:
- Capacidad: Conversación, Lectura de documentos o Imagen;
- Proveedor: El de la capacidad para cambiar solo el modelo (la función sigue entonces a la capacidad; el modelo solo vale para su proveedor actual: si la capacidad cambia de proveedor, la función usa el modelo predeterminado del nuevo), u otro proveedor;
- Modelo: vacío para el modelo predeterminado del proveedor;
- Límite mensual: en la unidad de la capacidad (tokens para la conversación, páginas para la lectura de documentos, imágenes para la imagen). Una vez alcanzado, la función se rechaza hasta el mes siguiente; vacío, sin límite.
La etiqueta Reemplazado indica una función configurada así. Editar abre el formulario Editar el reemplazo: puedes cambiar cada campo, incluidas la función y la capacidad, y Guardar actualiza ese reemplazo (no crea un segundo). Cancelar la edición cierra el formulario sin cambiar nada. Quitar devuelve a la función el proveedor y el modelo de su capacidad. Una función sin reemplazo se comporta exactamente como antes.
Una función tiene como máximo un reemplazo por capacidad: si la función y la capacidad elegidas ya tienen uno, se rechaza el guardado y el mensaje nombra la función; edita entonces el reemplazo existente.
- Una capacidad en Ninguno desactiva todas sus funciones, también las reemplazadas.
- Si el proveedor elegido para una función ya no está disponible (licencia de la IA del editor vencida, por ejemplo), la función vuelve al de su capacidad.
- Los embeddings no se reemplazan por función (No reemplazable): la indexación y la búsqueda deben usar el mismo modelo.
- El proveedor de una función debe estar configurado en su pestaña (clave, dirección): sin clave, la llamada falla.
Cuando la IA está desactivada («Ninguno»)
Para desactivar toda la IA, pon las dos elecciones en Ninguno (IA desactivada): es la situación de una instancia recién instalada. Entonces no sale ninguna llamada hacia un servicio externo y no se registra nada en el Uso de la IA.
Proveedor de chat activo en Ninguno: aparece la insignia IA desactivada en la parte superior de la pantalla.
- Desaparecen todos los botones de IA: Service Desk, Base de conocimientos, Gestión de cambios, Gestión de problemas, Gestión de despliegues, Gestión de eventos. Las pantallas siguen completas y todo se hace a mano.
- La burbuja del chatbot deja de aparecer en las bases de conocimientos públicas.
Proveedor de embeddings activo en Ninguno: aparece la insignia Búsqueda semántica desactivada. La búsqueda en las bases de conocimientos se hace en texto completo (por palabras), y el chatbot ya no encuentra pasajes de artículos para apoyar sus respuestas.
Las dos elecciones son independientes: con un proveedor de embeddings pero sin proveedor de chat, los asistentes desaparecen pero la búsqueda semántica continúa, y con ella las llamadas al proveedor de embeddings.
En todos los casos, las claves y los ajustes de los proveedores se conservan: volver a seleccionar un proveedor basta para restablecerlo todo.
Ver también
- «Seguir el uso de la IA»: consumo, límites y registro.
- «Leer documentos con la IA» y «Producir imágenes con la IA»: qué hacen estas capacidades y qué se envía al proveedor.