Asistente IA - Capacidades y configuración

El Asistente IA no es solo un chat: es un conjunto de subsistemas que trabajan juntos. Este manual explica cada uno, qué aporta, cómo se activa y qué límites tiene.

La configuración se abre desde el propio asistente:

1. Abrí el Asistente IA desde la barra principal del Back Office.
2. Abrí el menú lateral y elegí Configuración (grupo Sistema).
3. Navegá las seis solapas: Modelo, Visión, Memoria, Herramientas, Conocimiento y Avanzado.
4. Guardá. Al guardar, el asistente se reinicia internamente para tomar los cambios.

Importante: algunas secciones de la configuración solo las puede modificar un administrador. Si no tenés el permiso, el resto de la configuración se guarda igual y el asistente te avisa qué secciones no se aplicaron.

El ciclo de razonamiento

Cuando escribís un pedido, el asistente no responde de una: razona en rondas.

1. Recibe tu mensaje junto con el contexto (conversación, recuerdos, habilidades).
2. Decide si puede responder directamente o si necesita datos: en ese caso elige una o varias herramientas.
3. Ejecuta las herramientas y recibe los resultados.
4. Con esos resultados decide si ya puede responder o si necesita otra ronda.
5. Arma la respuesta final.

El máximo es de 10 rondas por pedido (configurable). Esto le permite encadenar: buscar el cliente, con ese Id traer el saldo, con el saldo evaluar el límite.

Mientras trabaja, la interfaz te muestra qué herramienta está usando en cada momento.

Memoria persistente

Recuerda información entre conversaciones distintas, no solo dentro del chat en curso.

Límite conocido: la recuperación por significado necesita un proveedor que ofrezca embeddings. Si el proveedor configurado no los soporta, la memoria funciona igual pero recupera por coincidencia de palabras, con menos precisión.

Historial de conversaciones

Cada chat se guarda y aparece en el panel lateral, donde podés cargarlo, renombrarlo o borrarlo.

Además, el asistente puede buscar dentro de tus conversaciones anteriores: preguntale "¿qué me dijiste sobre el cliente X la semana pasada?" o "buscá en chats anteriores lo de la liquidación". Solo accede a tus propias conversaciones.

Habilidades

Una habilidad es un procedimiento que le enseñás una vez y queda disponible para siempre. Si le explicás cómo hacer algo en tu empresa —el circuito de aprobación de un descuento, cómo armar cierto informe— el asistente reconoce que le estás enseñando y ofrece guardarlo.

Base de conocimiento de la empresa

Documentos propios que el asistente puede consultar: circulares, políticas internas, manuales de procedimiento, contratos tipo.

Diferencia con los manuales: la base de conocimiento son tus documentos. Los manuales son la documentación oficial de Plenario, que el asistente consulta con otra herramienta.

Servers MCP (herramientas externas)

MCP (Model Context Protocol) es un estándar para que un asistente use herramientas de sistemas externos. El Asistente IA funciona como cliente MCP y soporta dos transportes:

Las herramientas del server aparecen con el prefijo del server y se usan igual que las nativas. La conexión es perezosa: se establece la primera vez que hace falta. Si un server falla, los demás siguen funcionando.

Seguridad: todo lo que viene de un server MCP se trata como contenido de terceros. Las instrucciones que el server declara se insertan marcadas explícitamente como no autoritativas, y toda herramienta MCP pide confirmación antes de ejecutarse, sin importar qué haga.

Configuración en la solapa Herramientas: alta manual, búsqueda en el registro público, catálogo, importación desde Claude Desktop, edición JSON avanzada y botón de prueba de conexión.

Alertas proactivas

Al abrir el asistente, sin que preguntes nada, puede mostrarte tarjetas de aviso:

Cada alerta tiene su propio permiso: si el usuario no lo tiene, esa alerta no se calcula ni se muestra.

Visión: imágenes y PDF

Podés adjuntar imágenes y PDF y pedirle que los lea. También acepta Excel y CSV para procesar extractos.

• Adjuntar: botón de clip, arrastrar y soltar sobre el chat, o pegar una imagen del portapapeles.
• Modelo aparte: en la solapa Visión se puede configurar un modelo distinto solo para imágenes y PDF, con su propio proveedor, endpoint y clave. Útil cuando el modelo principal no interpreta imágenes.
• Archivos grandes: un Excel o CSV extenso se lee por tramos, para no saturar el contexto.

Dictado por voz (transcripción)

Si el administrador lo habilita, se puede dictar la consulta: grabar con el micrófono (botón 🎙 del cuadro de escritura) o adjuntar un archivo de audio. El asistente lo transcribe con Whisper y deja el texto en el cuadro para que lo revises antes de enviar (no lo manda solo).

Respuesta en vivo, cancelación y control de gasto

Límites conocidos: la cancelación es cooperativa, así que una consulta pesada ya lanzada puede tardar en cortar. El tope de gasto se evalúa antes de cada pedido, no en el medio: un pedido que arranca justo debajo del tope puede superarlo.

Cómo se eligen las herramientas

Con más de cien herramientas disponibles, mandarlas todas en cada consulta sería caro y confundiría al modelo. Se combinan tres mecanismos:

1. Selección por relevancia — se eligen las más pertinentes al pedido (14 por defecto). Puede funcionar por significado (si hay embeddings disponibles) o por coincidencia de palabras.
2. Grupo fijo — un conjunto de herramientas básicas siempre está presente, aunque la selección no las elija: búsqueda de clientes, manuales, memoria, habilidades, sugerencias, continuación de listados y búsqueda de herramientas.
3. Búsqueda a demanda — si nada encaja, buscar_herramienta busca en el catálogo completo y habilita la que falte.

La selección considera además los últimos turnos de la conversación, no solo el mensaje actual: así una herramienta no desaparece a mitad de una tarea porque el mensaje siguiente no repitió la palabra clave.

Comandos del chat

Al escribir / aparece un menú de autocompletado que se navega con las flechas y se ejecuta con Enter.

Atajos de teclado

Panel de Configuración

Otras funciones de la interfaz

• Calificar respuestas con 👍 / 👎, una vez por respuesta.
• Copiar cualquier mensaje.
• Ver en grilla y Descargar XLS cuando una consulta devuelve filas.
• Gráfico de barras, línea o torta sobre cualquier tabla con columnas numéricas, generado localmente.
• Tema claro/oscuro, que se recuerda por usuario.
• Historial de prompts con sugerencia en gris de consultas que ya hiciste, que se acepta con la flecha derecha. Es local y no consume tokens.
• Notificaciones de Windows cuando la respuesta está lista.

Caso: dejar el asistente listo para una instalación nueva.

1. Elegí proveedor y modelo. Configuración → Modelo. De fábrica viene con un proveedor de nivel gratuito: alcanza con crear la cuenta y pegar la clave.
2. Probá una consulta simple: "Buscá al cliente Pérez". Si responde, el circuito funciona.
3. Activá la memoria si querés que recuerde entre chats. Para que funcione por significado necesita un proveedor con embeddings; si no lo tenés, dejala igual: funciona en modo básico.
4. Cargá la base de conocimiento (Configuración → Conocimiento) con las circulares y procedimientos de la empresa.
5. Definí los permisos en el módulo de seguridad: primero los de consulta, después los de escritura según qué quieras habilitar.
6. Configurá las alertas que quieras que aparezcan al abrir, dando los permisos correspondientes.
7. Revisá el tope de gasto (Configuración → Avanzado) si usás un proveedor pago.
8. Mirá /metricas a la semana para dimensionar el consumo real.

• Empezá por lo básico. Proveedor, modelo y permisos de consulta. Memoria, base de conocimiento y MCP se suman después.
• El proveedor define el techo. Un modelo con buen manejo de herramientas cambia la experiencia más que cualquier ajuste. Si notás respuestas imprecisas de forma sistemática, probá otro modelo antes de tocar el resto.
• Los embeddings son el detalle que se pasa por alto. Memoria semántica, base de conocimiento y selección de herramientas por significado dependen de ellos. Si el proveedor no los ofrece, esas tres funciones caen a modo básico sin avisar.
• /compact en conversaciones largas. Cuando el indicador de contexto pasa el 60%, compactar reduce el gasto sin perder el hilo.
• Cargá la base de conocimiento con lo que más se pregunta. Es lo que más rápido se nota.
• Revisá /metricas el primer mes y recién ahí fijá el tope de gasto, con un número basado en el uso real.
• Las habilidades se enseñan trabajando. No hace falta una sesión aparte: cuando le expliques un procedimiento, ofrecerá guardarlo.

El Asistente IA respeta los permisos del usuario en dos niveles: los del módulo que consulta y los propios del asistente.

Cómo se protege la configuración

La mayoría de la configuración la puede ajustar cualquier usuario que use el asistente. Dos secciones son la excepción, porque derivan en ejecución de procesos o acceso al disco:

Si un usuario sin permiso guarda la configuración, esas secciones se conservan como estaban y el asistente le avisa cuáles no se aplicaron. El resto de sus cambios sí se guarda.

Cómo se protegen las aplicaciones externas y los archivos

Este subsistema es fail-closed: sin configuración explícita del administrador no hace nada, y las herramientas ni siquiera se registran.

Se configura desde Configuración → Herramientas → Aplicaciones externas y búsqueda de archivos: una casilla para habilitar, el catálogo de aplicaciones (nombre, ruta al ejecutable, descripción y si admite argumentos) y la lista de carpetas de búsqueda. Editar esta sección requiere el permiso AsistenteIA.ConfigurarApps; sin él, los cambios no se guardan.

Protección contra instrucciones maliciosas

El asistente lee datos de muchas fuentes: notas de clientes, tickets, páginas web, documentos, resultados de servers MCP. Cualquiera de esas fuentes podría contener texto que intente hacerse pasar por una orden.

Toda la configuración vive en un único parámetro del sistema: IA.Asistente.Config, en la tabla Parametros, con el contenido en formato JSON. Las claves de API se guardan cifradas y nunca se devuelven en claro a la interfaz.

Arquitectura en cuatro capas

Subsistemas en carpetas propias: Memoria\, Rag\, Mcp\, Recordatorios\, Novedades\, Tools\.

Proveedores de IA soportados

Hay tres clientes técnicos —OpenAI-compatible, Claude y Ollama— y un catálogo de dieciséis proveedores que se apoyan en ellos cambiando solo el endpoint:

Parámetros de generación por defecto: temperatura 0.2, máximo de 1024 tokens de respuesta y hasta 10 rondas de razonamiento.

Consideración de embeddings: la memoria semántica, la base de conocimiento y la selección de herramientas por significado requieren un endpoint de embeddings. Varios proveedores del catálogo, incluido el default de fábrica, no lo ofrecen. En esas instalaciones conviene apuntar los embeddings a un Ollama local.

Tablas de base de datos

Nota para soporte: varias de estas tablas se crean automáticamente si no existen, pero recrearse implica perder los datos. Toda tabla o columna IA_* debe estar registrada en el proyecto de base de datos, o el proceso nocturno de sincronización la elimina.

Relación con otros módulos / manuales

Notas para soporte

• La versión del asistente está embebida en el código de la interfaz y se consulta con /changelog. Verificar siempre contra el binario instalado, no contra el repositorio.
• /diag muestra las últimas advertencias internas: es el primer lugar donde mirar ante un comportamiento raro.
• Si la memoria semántica, la base de conocimiento o la selección por significado "no parecen funcionar", verificar primero si el proveedor configurado ofrece embeddings.
• El consumo medido corresponde a las llamadas de conversación. Los procesos auxiliares (extracción de memoria, revisión de habilidades, embeddings) no se contabilizan, así que el gasto real del proveedor es algo mayor que el que muestra el panel.
• Las herramientas de tickets son exclusivas de la instalación de Plenario; en instalaciones de cliente se reemplazan por las de requerimientos a soporte.