← Índice de manuales
Manual funcional · Sistema Plenario v14

Asistente IA - Referencia de herramientas

El Asistente IA no "sabe" los datos de tu sistema: los busca en el momento. Lo hace de dos maneras.

Módulo: Asistente IAVersión: 2.2Actualizado: 2026-10-22

Detalle

Campo Descripción
Tipo de documento Referencia técnica
Módulo Asistente IA
Objetivo Explicar cómo obtiene el Asistente IA los datos del sistema (las capacidades de consulta) y documentar las herramientas que puede ejecutar: qué hacen, qué datos piden, si modifican algo y qué permiso requieren.
A quién sirve Usuarios avanzados, administradores, soporte y el propio Asistente IA, que consulta este manual con buscar_manual.
Versión del Asistente 1.0.115
Total de herramientas Unas 80 fijas (varían según la instalación), más las dinámicas: una por cada informe guardado y una por cada herramienta de los servers MCP conectados.

Introducción

El Asistente IA no "sabe" los datos de tu sistema: los busca en el momento. Lo hace de dos maneras.

1. Capacidades de consulta. Para las preguntas de negocio (saldos, cuentas corrientes, préstamos, cuotas, mora, cheques, proveedores, facturación, contabilidad, riesgo) el asistente arma una consulta de solo lectura sobre la base de datos. No improvisa: se apoya en un diccionario de datos que describe qué significa cada tabla y cada columna, y en conceptos de negocio que ya traen la consulta validada (por ejemplo, qué es la cartera física de cheques o cómo se calculan los punitorios al día). Así responde cualquier variante de la pregunta, no solo las que tenían una herramienta hecha a medida.

2. Herramientas. Para todo lo demás usa herramientas (en inglés tools): funciones acotadas que hacen una cosa concreta. Por ejemplo, buscar un cliente, abrir una pantalla, preparar una liquidación de cheques, programar un recordatorio, consultar NOSIS o crear un ticket.

Este manual describe las dos. Para cada herramienta se indica:

Columna Qué significa
Nombre El identificador exacto de la herramienta.
Escritura Sí = modifica datos o produce un efecto externo (un mail, un WhatsApp, abrir una aplicación). Se valida el permiso y, antes de ejecutarla, se muestra una previsualización para confirmar.
Parámetros Los datos que necesita. Los marcados (req) son obligatorios.
Disponibilidad Si está siempre o solo bajo cierta condición (módulo instalado, configuración del administrador, instalación de Plenario o de cliente).

Importante: no todas las herramientas están en toda instalación. Varias dependen de que el módulo exista en tu Plenario (Factoring, Préstamos, créditos online), de la configuración del administrador (internet, aplicaciones, carpetas, MercadoPago, habilidades) o de si la instalación es la de Plenario o la de un cliente. Si el asistente dice que no tiene una herramienta, es porque no se registró en tu instalación.

Cómo elige el asistente una herramienta

En cada consulta no se le mandan todas las herramientas. Se le ofrece:

  1. Las más relevantes al pedido — hasta 10 por defecto (se configura en Herramientas por consulta). Se eligen por significado si hay embeddings disponibles o, si no, por coincidencia de palabras. La selección mira también los últimos turnos, para que una herramienta no desaparezca a mitad de una tarea.
  2. Un grupo fijo — siempre presentes: buscar_herramienta, buscar_cliente, buscar_manual, preguntar_opciones y siguiente.
  3. Las capacidades de consulta — consulta_sql y schema_db, cuando el pedido es de un dominio de negocio o pide una consulta.
  4. Las de la pantalla abierta — si tenés abierta una pantalla con el panel del asistente (por ejemplo, la liquidación de cheques), sus herramientas viajan en cada turno.
  5. A demanda — si nada encaja, buscar_herramienta busca en el catálogo completo y habilita la que falte.

Acceso al módulo

Las herramientas no se invocan a mano: las ejecuta el asistente cuando interpreta tu pedido. Para ver las disponibles en tu instalación:

  1. Abrí el Asistente IA — desde la barra principal del Back Office.
  2. Escribí /tools — o /herramientas, en el chat.
  3. Leé el listado — muestra las herramientas registradas para tu usuario, agrupadas por tema.

Nota: nueve herramientas son internas y no aparecen en /tools aunque funcionan: consulta_sql, schema_db, preguntar_opciones, ejecutar_codigo y las cinco de pantalla (pantalla_actual, pantalla_accion, grilla_filtrar, grilla_columnas y grilla_senalar).

Pantalla principal

Consultas de negocio (capacidades)

Estas preguntas no tienen una herramienta por pregunta: se responden con una consulta de solo lectura armada a partir del diccionario de datos. Cada dominio está disponible si tu instalación tiene el módulo.

Dominio Ejemplos de lo que podés preguntar Disponible
Clientes Datos del cliente, saldo y movimientos de cuenta corriente, cuánto debe, límite de crédito (usado y disponible), saldos de todos los clientes, cuántos clientes hay, rentabilidad o mejor cliente. Siempre
Préstamos Préstamos de un cliente, detalle y cuotas de un crédito, cuotas impagas, punitorios al día, clientes en mora, resumen de mora por antigüedad, colocación, cobranza proyectada, cartera por estado. Con el módulo de Préstamos
Factoring Cartera de cheques por estado, buscar un cheque por número o importe, cheques rechazados y pendientes de recobro, cuánto se operó en un mes. Con el módulo de Factoring
Proveedores y contabilidad Datos y saldo de un proveedor, facturas de un cliente o de un proveedor, cuánto se facturó, recibos de un cliente, pagos a un proveedor, saldo de una cuenta contable. Con el módulo de Proveedores
Riesgo y PLD Si un cliente es PEP, su valoración de riesgo, ficha de riesgo 360°. Con el módulo de PLD
Tesorería Saldo, movimientos y pendientes de caja. Siempre
Tickets y licencias Tickets reportados, estadísticas, tickets trabajados por un usuario, historial de un ticket, módulos contratados por un cliente. Solo en la instalación de Plenario

Las dos herramientas que hacen posible esto son internas (no aparecen en /tools):

Nombre Escritura Parámetros Qué hace
schema_db No buscar, tabla Consulta el diccionario de datos: el concepto de negocio que corresponde al pedido, con su consulta ya validada, y las tablas y columnas reales con su significado.
consulta_sql No sql (req) Ejecuta la consulta. Solo acepta una sentencia de lectura: si intenta modificar datos, se rechaza. Ves la consulta y el resultado, con los botones Ver en grilla y Descargar XLS.

Importante: en cheques, cartera y pendiente de acreditar son dos cosas distintas y no se suman. La cartera son los cheques que están físicamente en la financiera; pendientes de acreditar son los que ya salieron pero todavía no acreditaron. Si preguntás "¿cuántos cheques tengo?" sin aclarar, el asistente responde la cartera física y te avisa aparte cuántos hay pendientes de acreditar.

Informes guardados y exportación

Una consulta que te sirve seguido se puede guardar como informe. Cada informe guardado se convierte en una herramienta propia: es exacta, no depende de que el asistente vuelva a razonar la consulta y no gasta tokens en armarla.

Nombre Escritura Parámetros Qué hace Disponibilidad
informe_guardar Sí nombre (req), sql (req), descripcion, parametros, compartido Guarda una consulta como informe reutilizable, con parámetros opcionales. Siempre
informe_listar No — Lista los informes guardados, propios y compartidos. Siempre
informe_modificar Sí id (req), nombre, sql, descripcion, parametros, compartido Modifica un informe guardado. Siempre
informe_eliminar Sí id (req) Elimina un informe propio. Siempre
informe_<nombre> No Los que declare el informe Dinámica: cada informe visible se expone como una herramienta con su nombre. Una por informe
exportar_excel No columnas (req), filas (req), titulo Arma un Excel descargable con una tabla que ya está en el chat (por ejemplo, un resumen que armó el asistente). El resultado de una consulta ya trae su propio botón. Siempre

Clientes

Nombre Escritura Parámetros Qué hace
buscar_cliente No texto (req), max Busca clientes por razón social, CUIT o Id. Acepta el nombre compuesto en cualquier orden.
info_cuit No cuit (req), seccion, completo Perfil financiero de un CUIT dentro de Plenario, por secciones: cliente, cheques, préstamos, límite asignado, saldos, firmante y central de deudores del BCRA.
cliente_actualizar_limite Sí idCliente (req), nuevoLimite (req) Actualiza el límite de crédito. La previsualización muestra el valor actual contra el nuevo.
whatsapp_cliente Sí mensaje (req), idCliente, telefono, pais Abre WhatsApp con el mensaje cargado para escribirle a un cliente. No lo envía solo.

Préstamos y cobro por MercadoPago

Nombre Escritura Parámetros Qué hace Disponibilidad
calculadora_prestamo No monto (req), cuotas (req), tna (req), iva, gastos Simula un préstamo francés: cuota, TEA, total, intereses, IVA y CFT. No consulta la base. Siempre
convertir_tasa No tasa (req), tipo (TNA, TEM o TEA), capitalizacion Convierte tasas nominales y efectivas entre períodos. Siempre
funnel_creditos_online No desde, hasta, dispositivo, detalle Embudo de onboarding de créditos online: conversión, caídas, motivos de rechazo y motor de decisión. Instalaciones con créditos online
mercadopago_generar_link Sí idCredito (req), nrosCuota, importe Genera un link de pago para cobrar cuotas impagas de un crédito y devuelve la URL para mandarla al cliente. No cobra por sí solo: el cliente paga en ese link. MercadoPago configurado
mercadopago_verificar_cobro Sí idCredito Consulta MercadoPago y concilia: si hay pagos aprobados sin imputar, los imputa (asiento, cuenta corriente y cuota cobrada). Sin idCredito revisa todos los cobros pendientes de imputar. MercadoPago configurado

Importante: la confirmación de MercadoPago avisa siempre si está en modo prueba o producción, para no mandarle un link de prueba a un cliente real. Las cuotas a cobrar tienen que ser consecutivas desde la primera impaga: el asistente lo valida y avisa si la selección tiene huecos o incluye una cuota ya cobrada.

Cheques (Factoring)

Disponibles con el módulo de Factoring. Ninguna graba sola: preparan la operación en el importador y graba el usuario desde la pantalla, con los permisos de esa pantalla.

Nombre Escritura Parámetros Qué hace
leer_cheques_de_archivo No idCliente (req), archivos, accion, tasa, gastos, tipo Lee cheques (físicos o eCheqs) de los archivos adjuntos en el chat —fotos, PDF, Excel o CSV, Word, TXT o JSON— con el mismo proceso que el importador de Factoring. Devuelve un semáforo por cheque: rojo, no se puede liquidar así; amarillo, revisar; verde, OK.
nueva_liquidacion_cheques No idCliente (req), cheques, desdeAdjuntos, archivos, tasa, gastos, tipo, fechaValor, otraLiquidacion Abre una liquidación nueva del cliente con el importador precargado, con cheques dictados en la charla o leídos de los adjuntos. Las condiciones que pidas (tasa, gastos, tipo, fecha valor) se aplican encima de las habituales del cliente.

Nota: si ya tenés una liquidación abierta en pantalla, el asistente trabaja sobre ella con las herramientas de pantalla (ver más abajo) en lugar de abrir otra.

Proveedores, contabilidad y tesorería

Nombre Escritura Parámetros Qué hace
buscar_proveedor No texto (req), max Busca proveedores por nombre o CUIT y devuelve el Id.
plan_cuentas_buscar No texto (req), max Busca cuentas del plan contable por número o nombre.
cargar_comprobantes_compra No archivos, accion Lee facturas, notas de débito y notas de crédito de compra de los adjuntos —PDF, fotos, Excel o CSV (incluida la planilla Mis Comprobantes de ARCA), Word, TXT o JSON— y abre el importador de comprobantes precargado para revisarlos y grabarlos en IVA Compras. No graba nada: graba el usuario en la pantalla. Con accion = resumen devuelve solo el semáforo.
nuevo_asiento_contable Sí asientos (req), modo Crea asientos en partida doble a partir de movimientos (por ejemplo, un extracto bancario). Modos: portapapeles, json, form y directo.
especies_listar No soloActivas Lista especies y monedas con su cotización vigente y la anterior.
especie_cotizacion Sí idEspecie (req), cotizacion (req) Modifica la cotización de una especie y genera el asiento por diferencia de cambio.

Importante: especie_cotizacion no permite modificar el Peso (Id 1). Si el sistema usa Precio Promedio Ponderado (PPP), la cotización se calcula sola y no admite cambios manuales.

Riesgo

Nombre Escritura Parámetros Qué hace
cliente_nosis Sí documento (req), sexo, variable Informe NOSIS por CUIT o DNI. Usa la caché; si no hay uno reciente, pide confirmación porque la consulta en vivo tiene costo.

Pantallas con el panel del Asistente

Algunas pantallas del Back Office —como la liquidación de cheques y los importadores— tienen el panel del asistente integrado. Con una de ellas abierta, el asistente "ve" la pantalla y puede trabajar sobre ella. Estas herramientas son internas y viajan solas mientras la pantalla está abierta.

Nombre Escritura Parámetros Qué hace
pantalla_actual No — Describe la pantalla abierta: título, datos (condiciones, totales), avisos, la tabla que muestra cada grilla, sus columnas y las acciones disponibles.
grilla_filtrar No criterio (req), grilla Filtra una grilla de la pantalla (por ejemplo, los cheques a más de 180 días). Criterio vacío quita el filtro. Lo podés deshacer desde el panel.
grilla_columnas No mostrar, ocultar, grilla Muestra u oculta columnas de una grilla. Lo podés deshacer desde el panel.
grilla_senalar No criterio, grilla Resalta las filas que cumplen un criterio, sin filtrar (por ejemplo, los cheques del firmante que más concentra).
pantalla_accion Sí accion (req), args Ejecuta una acción de la pantalla (por ejemplo, elegir el cliente o agregar cheques a la liquidación). Las que modifican algo muestran primero una previsualización.
abrir_pantalla No pantalla, id, filtro Abre una pantalla del Back Office como si la eligieras en el menú, respetando permisos y licencias. Con filtro la abre ya filtrada en las pantallas que lo soportan. Si hay varias parecidas, te ofrece las opciones.

Tickets

Disponibles en la instalación de Plenario (soporte interno). Las consultas de tickets (listados, estadísticas, tickets trabajados, historial) se responden con las capacidades de consulta.

Nombre Escritura Parámetros Qué hace
ticket_detalle No idTicket (req) Cliente, asunto, estado, gravedad, asignado, fechas y avance.
ticket_notas No idTicket (req), max Notas del ticket, de la más reciente a la más vieja.
tickets_catalogo No tipo (req), idPadre, texto, max Resuelve los Ids que hacen falta para crear o asignar: proyectos, módulos, gravedades, sectores y usuarios.
ticket_crear Sí idCliente, idClienteUsuario, idProyecto, idProyectoModulo, idSector, idGravedad, idIncidente, idMedioAtencion, idReproducible, asunto, descripcion — todos req Alta de ticket. Conviene resolver los Ids antes con tickets_catalogo.
ticket_agregar_nota Sí idTicket (req), texto (req) Agrega una nota y notifica por mail a los involucrados.
ticket_asignar Sí idTicket (req), idUsuarioAsignado (req) Asigna el ticket y notifica por mail al asignado.
ticket_desasignar Sí idTicket (req) Quita la asignación y vuelve al estado inicial.
ticket_tomar Sí idTicket (req) El usuario logueado toma el ticket.
ticket_soltar Sí idTicket (req), texto Suelta un ticket tomado y registra la nota de trabajo.
ticket_pendiente Sí idTicket (req), motivo Marca o desmarca el ticket como pendiente.
ticket_entregar Sí idTicket (req) Marca el ticket como entregado (resuelto, avance 100%).
ticket_cerrar Sí idTicket (req), notificarCliente, nota Cierra el ticket y, si se indica, manda el mail de cierre al cliente.
analitica_uso No dias Estadística de uso del asistente: las herramientas más usadas y las consultas que no usaron ninguna.

Requerimientos a soporte de Plenario

Disponibles en las instalaciones de cliente. Permiten reportar y seguir pedidos a soporte sin salir del sistema.

Nombre Escritura Parámetros Qué hace
requerimiento_reportar Sí asunto (req), descripcion (req), bloqueante Reporta un error, una mejora o una consulta a soporte de Plenario.
requerimiento_nota Sí idRequerimiento (req), texto (req) Agrega una nota a un requerimiento ya reportado.
requerimiento_listar No soloAbiertos, max Lista los requerimientos reportados.
requerimiento_estado No idRequerimiento (req) Estado, detalle y notas de un requerimiento.
requerimiento_cerrar Sí idRequerimiento (req), conformidad Da por resuelto el requerimiento.

Recordatorios y tareas programadas

Un recordatorio puede ser un aviso ("recordame llamar a X") o una tarea que entrega información sola: corre un informe guardado, una consulta o un pedido en lenguaje natural, y deja el resultado en pantalla, por mail o en una carpeta (Excel, CSV, HTML o TXT).

Nombre Escritura Parámetros Qué hace
recordatorio_crear Sí texto (req), tipo (texto, informe, consulta o pedido), pedido, informe, parametros, sql, periodicidad, fecha, hora, destinos, formatos, nombre, descripcion, compartir y otros Programa un recordatorio o una tarea, puntual o recurrente (al iniciar el sistema, todos los lunes, días hábiles, último día hábil del mes o N-ésimo día hábil). Acepta fechas relativas como "inicio de mes". Con periodicidad = manual guarda un prompt sin horario en Mis prompts.
recordatorios_listar No soloActivos, max Lista los recordatorios y tareas del usuario.
recordatorio_completar Sí id (req) Marca el recordatorio como hecho.
recordatorio_cancelar Sí id (req) Cancela el recordatorio.
recordatorio_posponer Sí id (req), minutos Pospone el aviso los minutos indicados.
tarea_ejecutar_ahora Sí id (req), entregar, reaprender Ejecuta ya una tarea para probarla, sin cambiar su próxima corrida. Con entregar además manda el mail y guarda los archivos como en una corrida real.
tarea_historial No id, max Historial de corridas: cuándo corrieron, si salieron bien, cuántas filas, a dónde se entregaron y los errores.
carpeta_trabajo Sí ruta, restablecer Muestra o cambia la carpeta donde las tareas guardan sus archivos (puede ser una carpeta de red).

Conocimiento, manuales y memoria

Nombre Escritura Parámetros Qué hace Disponibilidad
buscar_manual No tema, manual Consulta los manuales oficiales de Plenario para explicar cómo funciona algo. Sin parámetros lista los manuales. Siempre
conversaciones_buscar No texto (req), dias, max Busca en las conversaciones anteriores del propio usuario. Siempre
memorizar Sí texto (req), tipo, global Guarda un recuerdo que persiste entre chats. Con global lo comparte con la empresa. Siempre
base_conocimiento No consulta (req) Busca en los documentos que cargó la empresa y devuelve los fragmentos con su fuente. Base de conocimiento activa
documento_indexar Sí titulo (req), texto (req) Indexa un texto en la base de conocimiento de la empresa. Base de conocimiento activa
skill_view No nombre (req) Carga una habilidad aprendida para seguir su procedimiento. Habilidades activas
skills_list No — Lista las habilidades aprendidas. Habilidades activas
skill_guardar Sí nombre (req), descripcion (req), cuerpo (req), tags Guarda o actualiza una habilidad cuando le enseñás un procedimiento. Habilidades activas
skill_archivar Sí nombre (req) Archiva una habilidad. No la borra: se puede recuperar. Habilidades activas
diagrama_estados No idFlujo, subflujo, clasico Dibuja los estados de las solicitudes de préstamo y los caminos permitidos, con la configuración real del workflow (o el circuito clásico del Back Office con clasico). Siempre
diagrama_tablas No tablas (req), columnas Dibuja cómo se relacionan tablas de la base, con sus claves reales y las relaciones del diccionario. Con una tabla muestra sus vecinas. Siempre

Internet y cotizaciones

Nombre Escritura Parámetros Qué hace Disponibilidad
cotizacion_dolar No tipo Cotización del dólar en vivo: oficial, blue, MEP, CCL, tarjeta, mayorista y cripto. Siempre
web_buscar No consulta (req), max Busca en internet y devuelve título y URL. Internet habilitado
web_extraer No url (req), modo, buscar, max Descarga y lee una página web en modo texto, links o título. Internet habilitado
abrir_navegador Sí url (req) Abre el navegador del usuario en una URL. Internet habilitado

Importante: cotizacion_dolar devuelve el dólar de mercado. La cotización que tiene cargada tu ERP para una moneda se consulta con especies_listar y se modifica con especie_cotizacion. No son lo mismo.

Seguridad: el contenido de una página web es información externa y no confiable. El asistente lo trata como datos, nunca como instrucciones, y cita la URL de donde sacó el dato.

Mails

Nombre Escritura Parámetros Qué hace Disponibilidad
mail_enviar Sí para (req), asunto (req), cuerpo (req), adjuntarTabla Envía un mail desde la cuenta de correo del sistema (parámetros Mails.*), con el usuario en copia. Hasta 10 destinatarios, solo direcciones internas o mails cargados en la ficha de un cliente, contacto, proveedor o proveedor financiero. Con adjuntarTabla adjunta en Excel la última tabla del chat. Queda en el log de operaciones. Permiso AsistenteIA.Escritura.Mail

Archivos y aplicaciones

Nombre Escritura Parámetros Qué hace Disponibilidad
extracto_leer No desde, cantidad Lee por tramos el último Excel o CSV adjunto, para procesar extractos grandes por partes. Siempre
validar_archivos No carpeta (req), patron, recursivo, layout, campos Lee archivos de texto de una carpeta y valida su formato contra un diseño de registro (ancho fijo, Libro IVA Digital). Siempre
buscar_archivos No patron (req), carpeta, max Busca archivos por nombre (acepta comodines) en las carpetas habilitadas. Carpetas configuradas
buscar_en_archivos No texto (req), patron, carpeta, max Busca un texto dentro de archivos de texto y devuelve el archivo y la línea. Carpetas configuradas
abrir_app Sí app (req), argumentos Abre una aplicación del catálogo autorizado en la PC del usuario. Catálogo cargado
ejecutar_codigo Sí lenguaje (req), codigo (req), clave (req) Ejecuta o previsualiza código (HTML o JavaScript local, Python en línea). Requiere la clave de operaciones además de la confirmación. Siempre (interna)

Utilidades del propio asistente

Nombre Escritura Parámetros Qué hace
buscar_herramienta No intencion (req) Busca entre todas las herramientas por intención y habilita la que corresponda. El asistente la usa antes de decir "no puedo".
siguiente No cantidad Continúa un listado que quedó cortado. Se dispara cuando pedís "siguiente", "mostrame más" o "el resto".
preguntar_opciones No preguntas (req) Te muestra botones de opción cuando necesita que decidas algo para seguir.
nueva_conversacion No conResumen Abre un chat nuevo. El actual queda guardado en Chats anteriores; con conResumen el nuevo arranca con un resumen de lo hablado.
sugerir Sí sugerencia (req) Registra una sugerencia o una queja sobre el asistente y la envía al equipo de Plenario con el contexto del chat.
usuario_actual No — Datos del usuario logueado que está usando el asistente.
buscar_usuario No texto (req), max Busca usuarios del sistema por nombre, login o email (por ejemplo, para asignar un ticket).

Herramientas de servers MCP

Si el administrador conectó servers MCP (Model Context Protocol), cada herramienta que exponga ese server aparece con el nombre <server>__<herramienta> y se usa igual que las nativas.

Como provienen de un tercero, todas piden confirmación antes de ejecutarse, sin importar lo que hagan.

Acciones disponibles

Unas 35 herramientas son de escritura: modifican datos o producen un efecto hacia afuera (un mail, un WhatsApp, abrir una aplicación). Todas siguen el mismo circuito:

  1. El asistente decide usarla — y arma los parámetros.
  2. Se valida el permiso — si la herramienta tiene un objeto de seguridad propio y tu usuario no lo tiene, no se ejecuta ni se te ofrece confirmar. El asistente te dice qué permiso pedirle al administrador.
  3. Previsualización — la herramienta muestra lo que va a hacer, sin hacer nada todavía.
  4. Confirmación — ves la previsualización en el chat con los botones ✓ Confirmar y Cancelar.
  5. Ejecución — recién al confirmar se ejecuta de verdad.

Las consultas de negocio no pasan por este circuito porque son de solo lectura: ves la consulta y el resultado, pero no modifican nada.

Importante: el modelo de IA no puede autoconfirmarse. La confirmación se aplica fuera del ciclo de conversación, y cualquier intento del modelo de marcar una operación como ya confirmada se descarta antes de ejecutar. Esto protege contra instrucciones maliciosas escondidas en un dato que el asistente haya leído: una nota de cliente, una página web, un documento.

Ejemplo práctico

Caso: averiguar por qué un cliente quedó sin margen de crédito.

  1. Buscá al cliente — escribí "Buscá al cliente Pérez". Se ejecuta buscar_cliente; si hay varias coincidencias, preguntar_opciones te muestra los botones para elegir.
  2. Preguntá por el límite — "¿Cuál es su límite y cuánto tiene usado?". El asistente toma del diccionario el concepto de límite de crédito y ejecuta la consulta: ves el límite vigente, lo usado en cartera de cheques y el disponible.
  3. Mirá la cartera — "¿Qué cheques tiene en cartera?". Otra consulta, con el cliente ya en contexto: no hace falta repetir el Id. El resultado trae Ver en grilla y Descargar XLS.
  4. Seguí el listado — si sale cortado, escribí "seguí": siguiente continúa desde donde iba, sin repetir filas ni volver a consultar.
  5. Guardalo para la próxima — "Guardá esta consulta como informe 'Cartera por cliente'". informe_guardar te pide confirmar y desde ahí es una herramienta más.
  6. Ajustá el límite — "Subile el límite a 5.000.000". cliente_actualizar_limite muestra "actual 3.000.000 → nuevo 5.000.000" y espera tu confirmación.

Consejos útiles

  • Pedí en tus palabras. No hace falta nombrar tablas ni herramientas: describí el dato que querés ("saldo de cuenta corriente", "cheques rechazados de este mes").
  • Con una pantalla abierta, hablale de la pantalla. En la liquidación o en los importadores podés decir "filtrá los cheques a más de 180 días" o "¿qué firmante concentra más?".
  • Lo que pedís seguido, guardalo como informe. Es exacto, no gasta tokens en armar la consulta y después lo podés programar como tarea.
  • Las tareas programadas entregan solas. "Todos los lunes mandame por mail en Excel los vencimientos de la semana" queda programado con recordatorio_crear.
  • Si dice que no puede, pedile que busque. "Fijate si tenés alguna herramienta para eso" dispara buscar_herramienta sobre el catálogo completo.
  • Los Ids se resuelven solos. Pedí por nombre: el asistente busca el Id con la herramienta que corresponda.
  • Revisá siempre la previsualización de una acción de escritura antes de confirmar. Es el único punto donde podés frenarla.

Preguntas frecuentes

¿Por qué ya no están herramientas como cliente_saldo_cta_cte o cheques_cartera? Porque se reemplazaron por las capacidades de consulta (versiones 1.0.102 a 1.0.104, septiembre de 2026). Cada una de esas herramientas respondía una sola pregunta; ahora el asistente arma la consulta con el diccionario de datos, así que responde las mismas preguntas y también sus variantes ("saldo en dólares", "solo los del último mes", "agrupado por oficial").
¿El asistente puede modificar datos con una consulta? No. Las consultas de negocio aceptan una sola sentencia de lectura y se rechazan si intentan modificar algo. Todo lo que modifica datos pasa por una herramienta de escritura, con permiso y confirmación.
¿Por qué el asistente no encuentra una herramienta que sé que existe? Por dos motivos posibles. Primero, en cada consulta se le ofrece un subconjunto de herramientas, no todas: pedile que busque ("fijate si tenés una herramienta para esto") y usará buscar_herramienta sobre el catálogo completo. Segundo, puede no estar registrada en tu instalación porque el módulo no está instalado o el administrador no la habilitó.
¿Puedo invocar una herramienta directamente por su nombre? No hay una sintaxis de invocación directa, pero nombrarla en el pedido ("usá info_cuit con la sección del BCRA") es una pista muy fuerte y en general el asistente la respeta.
¿Las herramientas de escritura pueden ejecutarse sin que yo confirme? No. La confirmación se aplica fuera del ciclo del modelo: el asistente no tiene forma de saltearla. Además, si la herramienta tiene un permiso propio y tu usuario no lo tiene, la operación ni siquiera llega a ofrecerse.
¿Qué son las herramientas de pantalla? Son las que usa el asistente cuando tenés abierta una pantalla con su panel integrado, como la liquidación de cheques o los importadores. Le permiten leer lo que muestra la pantalla, filtrar, resaltar u ocultar columnas de sus grillas y ejecutar las acciones de la pantalla. Las acciones que modifican algo piden confirmación, y los cambios de grilla se deshacen desde el panel.
¿Por qué algunas herramientas no aparecen en /tools? Nueve son internas y se ocultan del listado: consulta_sql, schema_db, preguntar_opciones, ejecutar_codigo y las cinco de pantalla. Siguen funcionando normalmente.
¿Los informes guardados son herramientas? Sí. Cada informe guardado y visible se expone como una herramienta propia llamada informe_<nombre>, con los parámetros que hayas definido. Por eso podés pedir "corré el informe de cobranzas de marzo" y funciona.
¿Qué pasa si un listado es muy largo? El asistente muestra el primer tramo y te avisa cuántos registros quedan. Con "siguiente" continúa desde donde iba, sin repetir filas ni volver a consultar la base. El resultado completo está siempre en Ver en grilla y Descargar XLS.

Permisos

Las herramientas de escritura con un objeto de seguridad propio se validan antes de ejecutarse y antes de ofrecer la confirmación: sin el permiso, la operación no se ofrece.

Permiso Habilita
AsistenteIA.Escritura.Tickets Todas las operaciones sobre tickets: crear, notas, asignar, tomar, soltar, pendiente, entregar y cerrar.
AsistenteIA.Escritura.Informes Guardar, modificar y eliminar informes.
AsistenteIA.Escritura.Requerimientos Reportar, comentar y cerrar requerimientos a soporte de Plenario.
AsistenteIA.Escritura.MercadoPago Generar links de pago y conciliar cobros de MercadoPago.
AsistenteIA.Cliente.ActualizarLimite Modificar el límite de crédito de un cliente.
AsistenteIA.Escritura.WhatsApp Abrir WhatsApp con un mensaje al cliente.
AsistenteIA.Escritura.Mail Enviar mails desde la cuenta de correo del sistema.
AsistenteIA.Escritura.Codigo Ejecutar o previsualizar código.
AsistenteIA.Escritura.LanzarApp Abrir aplicaciones del catálogo autorizado.
AsistenteIA.ConfigurarMCP Editar y probar los servers MCP en Configuración.
AsistenteIA.ConfigurarApps Editar el catálogo de aplicaciones y las carpetas de búsqueda de archivos.
AsistenteIA.Alertas.Mora Alerta proactiva de mora al abrir el asistente.
AsistenteIA.Alertas.CuotasAVencer Alerta de cuotas próximas a vencer.
AsistenteIA.Alertas.ChequesRechazados Alerta de cheques rechazados pendientes.
AsistenteIA.Alertas.ClientesPEP Alerta de clientes marcados como PEP.

Además:

  • abrir_pantalla respeta los permisos y las licencias del menú: abre solo las pantallas que el usuario ya puede abrir.
  • leer_cheques_de_archivo, nueva_liquidacion_cheques y cargar_comprobantes_compra no graban: preparan la operación en el importador y graba el usuario desde la pantalla, con los permisos de esa pantalla.

Nota para administradores: la validación de permisos es fail-closed. Si el subsistema de seguridad no puede responder, se deniega. Las herramientas de escritura que no tienen un objeto de seguridad propio en la tabla anterior quedan protegidas por la confirmación interactiva del usuario.

Información técnica

Sección de referencia para soporte y desarrollo. El catálogo se arma en tiempo de ejecución: la cantidad exacta de herramientas depende de la instalación, los módulos presentes, la configuración, los informes guardados y los servers MCP conectados.

Dónde vive cada grupo

Componente Detalle
VPNET_DataModel\Manager\Agente\Tools\ Herramientas nativas en C#, por dominio: ClienteTools, PrestamosTools, FactoringTools, ProveedoresContabilidadTools, TicketsTools, RequerimientosTools, RiesgoTools, KpisTools, ConocimientoTools (capacidades de consulta, informes, habilidades y manuales), WebTools, AppsExternasTools y AgenteBaseTools.
VPNET_DataModel\Manager\Agente\Conocimiento\diccionario.json El diccionario de las capacidades: más de 400 tablas (unas 300 descriptas, con columnas y sinónimos), 43 conceptos de negocio con su consulta validada y las convenciones de la base.
VPNET_DataModel\Manager\Agente\Tools\ToolsInfra.cs Dominios de las capacidades y sus palabras clave (CapacidadesDominio) y el validador de solo lectura de las consultas.
VPNET_DataModel\Manager\Agente\Tools\ToolRegistry.cs Registro del catálogo, selección por relevancia (palabras o embeddings) y grupo fijo.
VPNET_DataModel\Manager\Agente\AgenteService.cs → BuildRegistry Arma el catálogo por sesión con las condiciones de registro y decide qué dominios tiene la instalación (DominioDisponible).
VPNET_DataModel\Manager\Agente\Core\AgentLoop.cs Selección por turno (más las que fuerza el pedido o la pantalla abierta) y PermisoDeTool, que asigna a cada herramienta de escritura su objeto de seguridad.
VPNET_DataModel\Manager\Agente\Pantallas\PantallaTools.cs Herramientas de las pantallas con panel del asistente.
VPNET_DataModel\Manager\Agente\Recordatorios\, \Rag\, \Mcp\ Recordatorios y tareas programadas, base de conocimiento y adaptador de servers MCP.
VisualPlenarioNET\VisualPlenarioNET\Asistente\AsistenteIA_TicketsBLTools.vb Herramientas que necesitan la lógica viva del Back Office: tickets con notificación por mail, abrir_pantalla, especies y asientos contables.

Por qué algunas herramientas están en VB

El orden de dependencias entre proyectos impide que VPNET_DataModel referencie a VisualPlenarioNET. Las herramientas que necesitan la conexión viva del proceso, la lógica de negocio real (TicketsBL) o abrir formularios del shell solo pueden vivir en el proyecto VB. Se registran al inicio y el catálogo las trata igual que a las nativas. Cuando comparten nombre con una versión en C#, gana la de VB, porque es la que ejecuta la lógica completa (por ejemplo, la que además manda las notificaciones por mail).

Contrato de una herramienta

Cada herramienta implementa ITool y declara un ToolSchema con: nombre, descripción, firma de parámetros, si es de escritura, el JSON Schema de sus argumentos, el módulo al que pertenece y si es interna. El resultado es un ToolResult, que puede ser una respuesta, un error o un pedido de confirmación.

Relación con otros módulos / manuales

Manual relacionado Vínculo operativo
Asistente IA Guía de uso: cómo pedirle cosas al asistente, comandos y configuración básica.
Asistente IA - Capacidades y configuración Subsistemas (memoria, habilidades, base de conocimiento, MCP, alertas) y el panel de Configuración.

Notas para soporte

  • Si un cliente reporta que "el asistente no puede hacer X", verificar en este orden: si es una consulta de negocio (se responde con las capacidades, no con una herramienta), si la herramienta se registró (/tools), si el módulo existe en esa instalación y si el usuario tiene el permiso.
  • Si una consulta de negocio sale mal, revisar primero si la tabla y el concepto están en el diccionario: el asistente arma la consulta a partir de ahí.
  • Las herramientas de tickets son de la instalación de Plenario; en las instalaciones de cliente se usan las de requerimientos a soporte.
  • Al agregar una herramienta de escritura hay que declararla como tal en su ToolSchema y agregar su objeto de seguridad en PermisoDeTool: son dos lugares distintos.
  • Las herramientas de aplicaciones externas y búsqueda de archivos son fail-closed: si el administrador no cargó el catálogo o las carpetas, no se registran y el asistente ni siquiera las ofrece.
¿Te resultó útil este manual?