Configuración de Plaid¶

Esta página controla el asistente de chat Plaid: con qué modelo IA habla, si el chat y la API MCP están activados, cuánto tiempo se conservan las conversaciones y qué claves permiten a los clientes MCP externos acceder a sus datos. Es una pantalla centrada en el chat. Los modelos en sí —proveedores, claves, precios— se definen una sola vez en la página Modelos IA, y cada agente IA elige su propio modelo en su pestaña Configuración, así que nada de lo que cambie aquí altera cómo funcionan los agentes.

Dónde encontrarlo¶

Espacio de trabajo: Administración
Ruta: Administración → Inteligencia artificial → Plaid
Ruta URL: /admin/ai
Permiso: ai_settings:admin
Indicador de funcionalidad: requiere que la superficie de configuración de IA esté habilitada. Cuando está desactivada, la página muestra un aviso («La configuración de IA está deshabilitada para esta instancia») y no hay controles disponibles.

Proveedor¶

Modelo utilizado por Plaid¶

Un único selector decide qué modelo responde a las preguntas del chat:

Modelo predeterminado (nombre) — el predeterminado de la organización definido en la página Modelos IA, con su nombre para que vea lo que está usando. Es la primera opción y la respuesta habitual: déjelo aquí y Plaid seguirá al predeterminado allá donde lo mueva.
Modelo incluido de KANAP — se muestra en lugar del anterior cuando no hay ningún predeterminado definido, en el servicio alojado. Plaid funciona entonces con el modelo incluido en su suscripción, dentro de su volumen mensual de mensajes.
Ningún modelo configurado — se muestra cuando no hay predeterminado ni modelo incluido, que es el caso de las instalaciones locales. Tenga en cuenta que esta opción sigue diciendo Ningún modelo configurado hasta que algún modelo se marque con la estrella como predeterminado de la organización, aunque ya haya registrado varios: describe la alternativa por defecto, no su registro de modelos.
Cualquier modelo activo, por su nombre — fije Plaid a un modelo concreto, con independencia del predeterminado. Los modelos archivados no se ofrecen.

Así que hay dos formas de poner el chat en marcha: marcar un predeterminado con la estrella en la página Modelos IA y dejar este selector en la primera opción, o elegir aquí un modelo por su nombre. Fijar uno aquí funciona exista o no un predeterminado.

El texto de ayuda de debajo enlaza directamente con la página Modelos IA, que es de donde sale cada una de las opciones de la lista. Aquí ya no hay ningún proveedor, endpoint ni clave API que rellenar, ni ningún conmutador multimodal aparte: que el modelo pueda leer imágenes es una propiedad del modelo, que se define una sola vez en su editor.

Uso integrado¶

Cuando Plaid funciona con el modelo incluido de KANAP —sin elección explícita y sin predeterminado de la organización— aparece una tarjeta Uso integrado con:

Cuántos mensajes lleva utilizados este mes frente al límite, con una barra de progreso que se vuelve ámbar pasadas tres cuartas partes y roja cerca del tope
La fecha en la que se restablece el volumen
Un recordatorio de que usar sus propias claves API elimina el límite

Como dice la tarjeta, el volumen se comparte entre las solicitudes de chat y de MCP de este espacio de trabajo, y los agentes también lo consumen. Un mensaje es una pregunta de chat, una solicitud de un asistente externo por MCP o un ticket revisado por un agente. Una flota de agentes muy activa lo agota más rápido, así que si está vigilando esta barra, vigile también la página Uso y costes.

Chips de estado¶

El encabezado de la tarjeta Proveedor muestra tres indicadores de un vistazo:

Chat habilitado / Chat deshabilitado — el conmutador maestro para el chat del usuario final
MCP habilitado / MCP deshabilitado — si los clientes MCP externos pueden conectarse
Proveedor listo / Proveedor incompleto — si el modelo al que resuelve Plaid es realmente utilizable

Cuando falta algo, Errores de validación del proveedor actual lo enumera encima del formulario: un modelo incompleto, o directamente ningún modelo. La solución está normalmente en la página Modelos IA y no aquí.

Funcionalidades¶

La sección Funcionalidades activa o desactiva las superficies de IA opcionales:

Habilitar chat — activa o desactiva el espacio de chat dentro de la app para los usuarios finales. No se puede activar mientras el encabezado diga Proveedor incompleto: el guardado se rechaza indicando los motivos, y esos motivos se corrigen antes en la página Modelos IA. La misma comprobación se ejecuta en cada guardado mientras el chat ya está activo, de modo que un modelo que quede incompleto más adelante bloqueará cambios sin ninguna relación en esta página hasta que se resuelva.
Habilitar MCP — activa o desactiva la API MCP para los clientes externos.
Búsqueda web — permite al asistente de chat Plaid buscar en la web. Requiere que la clave de búsqueda web a nivel de instancia esté configurada; sin ella, el conmutador está deshabilitado y un tooltip explica por qué. Al activarlo se ejecuta automáticamente una prueba de conectividad y se informa del resultado. Este conmutador se aplica solo al asistente de chat: los agentes IA tienen su propia configuración de búsqueda web independiente, en la pestaña Configuración de cada agente, que se basa en la misma configuración a nivel de instancia.

Retención¶

Retención de conversaciones (días) — las conversaciones de chat y sus mensajes con una antigüedad superior a este valor pasan a ser elegibles para la limpieza automática. Déjelo vacío para conservarlas indefinidamente.

Los cambios en Proveedor, Funcionalidades, Retención y el campo Vida útil máxima de la clave (días) de más abajo se aplican todos con el único botón Guardar configuración del final de esta tarjeta. Nada de esta página se guarda por sí solo.

Claves API MCP¶

La sección Claves API MCP genera claves de larga duración para que los asistentes externos y los IDE puedan comunicarse con KANAP a través del Model Context Protocol, usando los mismos datos que ve Plaid.

La tarjeta muestra un botón Crear clave, el límite de Vida útil máxima de la clave (días) y una tabla de claves existentes con Etiqueta, Prefijo, Creada, Expira, Último uso y Estado (Activa o Revocada).

Crear una clave¶

Haga clic en Crear clave.
Introduzca una Etiqueta descriptiva (por ejemplo, «Cliente MCP de escritorio»).
Haga clic en Crear. KANAP genera un secreto de un solo uso.
Copie el secreto inmediatamente: se muestra una sola vez y no puede recuperarse más tarde.

El campo Vida útil máxima de la clave (días) limita cuánto tiempo puede vivir cualquier clave recién emitida, independientemente de lo que solicite la petición. Déjelo vacío para no tener límite de expiración. Tenga en cuenta que este campo concreto pertenece a la configuración de arriba y no a esta tarjeta: lo escribe el botón Guardar configuración, no la creación de una clave.

Revocar una clave¶

Haga clic en el icono de papelera de cualquier fila activa para revocar la clave. Las claves revocadas permanecen en la tabla con fines de auditoría, pero ya no pueden autenticarse.

Consejos¶

Deje Plaid en el modelo predeterminado salvo que tenga un motivo para no hacerlo. Fijar el chat a un modelo concreto significa que deja de seguir al predeterminado de la organización: útil cuando el chat y los agentes necesitan realmente modelos distintos, y una molestia el resto del tiempo.
Es fácil subestimar el volumen del chat. La página Uso y costes valora el chat a las tarifas del modelo asignado; un asistente muy usado con un modelo caro aparece allí mucho antes de aparecer en una factura.
Un modelo con visión es un requisito de los agentes, no del chat. Si sus agentes de triaje necesitan leer capturas de pantalla de los tickets, eso corresponde al modelo de ellos: consulte Comprende imágenes en la página Modelos IA.
Rote las claves MCP. Prefiera claves de corta duración para las estaciones de trabajo compartidas y use Vida útil máxima de la clave (días) para imponer un tope que ninguna petición pueda superar.
Establezca una ventana de retención. Conservar las conversaciones para siempre es conveniente hasta que la base de datos crece demasiado o una revisión de conformidad pregunta cuánto tiempo se conserva el contenido del chat: 90 o 180 días es un punto de partida habitual.
GLPI se configura en otro sitio. La conexión de ticketing con la que trabajan sus agentes se configura en Administración → Integraciones, no aquí; consulte Integraciones.