Guía del usuario de Diamond: Introducción
Bienvenido a la Guía del usuario de Teemant.
Esta guía está diseñada para ayudarte a configurar y operar un espacio de trabajo de Teemant, desde la configuración general hasta el uso diario. Ofrece una descripción general estructurada de cada sección de la plataforma y explica la función de cada función, sin entrar en detalles de implementación básicos.
🎯 Propósito de esta guía
El objetivo de esta documentación es:
- Te daré un modelo mental claro de cómo funciona Teemant,
- explicar el papel de cada componente del espacio de trabajo,
- Ayudar a los administradores, gerentes y desarrolladores a navegar por la plataforma con confianza.
Este no es un tutorial paso a paso. Se centra en conceptos, responsabilidades y mejores prácticas, para que la documentación sea fácil de mantener y evolucione fluidamente con el producto.
- Inicio (Panel de control)
- Contextos de IA
- Guías de IA
- Mensajes
- Eventos
- Identificadores
- Herramientas
- Visión
- Salidas
- Documentos
- Modelos de objetos
- Configuración del espacio de trabajo
- Miembros del espacio de trabajo
- Usuarios del agente del espacio de trabajo
- Canales del espacio de trabajo
- Transportes del espacio de trabajo
- Tareas del espacio de trabajo
- Constructor de agentes de diamantes
- Llamadas del agente de Teemant
👥 ¿A quién va dirigida esta guía?
Esta guía está dirigida a:
- Administradores del espacio de trabajo que gestionan la configuración y el acceso,
- Gerentes que supervisan usuarios, canales y operaciones,
- Creadores de bots que diseñan agentes, flujos y automatizaciones.
Dependiendo de su rol, algunas secciones pueden ser más relevantes que otras.
🧭 Cómo leer esta guía
La guía sigue la estructura del espacio de trabajo de Teemant:
- Cada sección corresponde a una entrada del menú de la plataforma.
- Puede leerlo linealmente o saltar directamente a un tema específico utilizando la tabla de contenidos a continuación.
- Se utilizan capturas de pantalla e íconos para ayudarlo a reconocer rápidamente las funciones de la interfaz.
Para casos de uso avanzados (integraciones personalizadas, API o flujos de trabajo complejos), es posible que se requiera documentación o soporte adicional.
🏠 Inicio (Panel de control)
La pestaña Inicio es el panel del espacio de trabajo.
Proporciona una vista de alto nivel de la actividad y el uso, como:
- número de usuarios,
- número de bots o agentes activos,
- indicadores de conversión o finalización,
- Tendencias de actividad a lo largo del tiempo.
El panel de inicio se utiliza para:
- Monitoreo del uso de la plataforma,
- comprender los niveles de adopción y actividad,
- Obtener una descripción general rápida del estado sin ingresar a las pantallas de configuración.
No contiene funciones de configuración ni de gestión de datos.
🗃️ Entidades
Las entidades representan las bases de datos reales de datos externos sincronizados dentro de Teemant.
Se utilizan normalmente para:
- datos de referencia (por ejemplo, tiendas, ubicaciones, unidades organizativas),
- objetos de negocio procedentes de sistemas externos,
- conjuntos de datos compartidos entre agentes y procesos.
Características principales:
- Las entidades son conjuntos de datos estructurados, no elementos conversacionales.
- A menudo se sincronizan desde o hacia sistemas externos a través de importaciones o tareas.
- Los agentes y guías pueden leer las entidades para validar o enriquecer las entradas de los usuarios.
En breve:
👉Las entidades son donde residen los datos comerciales estructurados dentro de Teemant.
🛠️ Constructor
El Constructor es donde se diseña la inteligencia de procesos.
Se utiliza para:
- Guías de construcción (lógica, preguntas, validaciones, flujos),
- Reunir agentes basándose en esas guías,
- definir cómo funcionan juntos los diferentes elementos.
Dentro del Constructor, usted define:
- cómo se comporta un agente,
- qué datos espera,
- qué documentos puede manejar (correos electrónicos, archivos, cargas JSON, archivos adjuntos),
- Cómo se recopila, valida y prepara la información.
El Constructor es el área de diseño principal de Teemant:
- Los guías definen qué recolectar y cómo,
- Los agentes combinan guías con datos, documentos y lógica para ejecutar procesos reales.
⚙️ Espacio de trabajo
La sección Espacio de trabajo contiene configuraciones globales y administrativas.
Se utiliza para gestionar:
- configuración general del espacio de trabajo,
- administradores y usuarios agentes registrados,
- canales de comunicación (por ejemplo, WhatsApp, correo electrónico, otros canales),
- configuraciones a nivel de entorno (desarrollo, prueba, producción).
La configuración del espacio de trabajo controla quién puede acceder a la plataforma, a través de qué canales y con qué permisos.
Aquí no se define ninguna lógica empresarial: es puramente operativa y administrativa.
🔗 Transportes
Los transportes definen los medios técnicos de transferencia de datos entre Teemant y sistemas externos.
Los ejemplos incluyen:
- SFTP push o pull,
- intercambios basados en archivos,
- transferencias basadas en correo electrónico.
Un transporte responde a la pregunta:
👉 “¿Cómo se mueven físicamente los datos entre sistemas?”
No define:
- ¿Qué datos se intercambian?
- cuando se intercambia,
- o cómo se interpreta.
🔄 Tareas
Las tareas se utilizan para escanear, importar o sincronizar fuentes de datos externas.
Por lo general:
- supervisar bases de datos externas o ubicaciones de archivos,
- desencadenar importaciones,
- Actualizar entidades con datos nuevos o modificados.
Las tareas se centran en la ingesta y sincronización de datos, no en la interacción del usuario.
Volver arriba
Contextos de IA
Los contextos de IA definen el entorno conductual y semántico en el que opera la IA.
Proporcionan a la IA información de fondo, intención y reglas de comunicación, lo que garantiza que las interacciones se mantengan consistentes, relevantes y alineadas con las expectativas del negocio.
Los contextos de IA son utilizados por ambos:
- agentes conversacionales (chatbots),
- y procesos de automatización de correo electrónico.
Contextos globales
Los contextos globales describen información general y transversal que se aplica a toda la organización o espacio de trabajo.
Por lo general incluyen:
- Descripción de la empresa u organización,
- reglas o terminología comercial general,
- tono general y estilo de comunicación,
- restricciones o suposiciones comunes.
Los contextos globales actúan como una base compartida que puede reutilizarse entre múltiples agentes y procesos, lo que garantiza la coherencia a nivel de plataforma.
Contextos del agente
Los contextos de agente son específicos de un agente o caso de uso determinado.
Definen:
- lo que se espera que haga el agente (por ejemplo, recopilar datos de declaración de incidentes),
- quiénes son los usuarios (empleados, clientes, socios, equipos internos),
- cómo debe comunicarse el agente (tono, nivel de formalidad, requisitos de claridad),
- cualquier restricción específica del rol o del proceso.
Los contextos de agente permiten que la IA adapte su comportamiento dependiendo del proceso de negocio que respalde.
🧩 El papel de los contextos de IA en las guías
Al crear guías de IA, el creador debe seleccionar el contexto del agente apropiado.
Este contexto seleccionado es entonces:
- aplicado durante cada conversación, o
- Se utiliza durante los flujos de trabajo de procesamiento de correo electrónico.
El contexto asegura que
:
- La IA entiende su papel,
- Las interacciones permanecen alineadas con el proceso previsto,
- Las respuestas son consistentes en todos los canales.
En breve:
👉 Los contextos de IA definen cómo piensa y se comunica la IA, mientras que las guías definen lo que hace la IA.
Volver arriba
🧩 Guías de IA
Las guías de IA definen las instrucciones que utiliza la IA durante:
- conversaciones en vivo (chatbots),
- y procesamiento de correo electrónico (automatización de correo electrónico).
Una guía describe qué información debe recopilarse o procesarse, cómo debe comportarse la IA y cómo se estructuran los datos, pero no define el transporte ni la lógica de integración.
- Las guías de IA son ejecutadas por agentes y siempre operan dentro de un contexto de IA definido.
Tipos de guías
Teemant ofrece varios tipos de guías de IA, cada una de las cuales cumple una finalidad específica dentro de un proceso.
📥 Guías de recopilación de datos
Las guías de recopilación de datos se utilizan para recopilar información estructurada basada en un modelo de datos predefinido.
Una vez definido un modelo de datos (campos, formatos, restricciones), se puede construir una guía con asistencia de IA.
Cada paso de una Guía de Recopilación de Datos normalmente define:
- un nombre para mostrar (legible para humanos),
- un nombre de campo técnico,
- un tipo de campo (cadena, número, dirección, fecha, etc.),
- instrucciones del bot que explican cómo la IA debe recopilar o validar la información,
- instrucciones de usuario opcionales cuando se requiere una acción específica.
Las instrucciones del bot pueden incluir:
- validaciones,
- dependencias de valores recopilados previamente,
- comportamiento condicional
- Las guías de recopilación de datos se utilizan tanto en los flujos conversacionales como en la automatización del correo electrónico.
✅ Guías de listas de verificación
Las guías de listas de verificación son similares a las guías de recopilación de datos, pero están diseñadas para preguntas cerradas.
Generalmente definen:
- la pregunta mostrada,
- opciones disponibles (Sí / No, o similar),
- instrucciones del bot,
- instrucciones de usuario opcionales,
- si es necesario un comentario (verdadero / falso).
Las guías de listas de verificación se utilizan comúnmente para:
- controles de cumplimiento,
- pasos de validación,
- confirmaciones procesales.
Guías de campos calculados
Guías de campos calculados Las guías definen campos que se calculan automáticamente en función de valores recopilados previamente.
Ellos:
- Confíe únicamente en las instrucciones del bot,
- nunca requieren la entrada del usuario,
- No se muestran a los usuarios.
Los campos calculados se pueden utilizar en diferentes etapas de un proceso para:
- valores agregados,
- calcular totales,
- derivar resultados intermedios.
- Estos campos son internos al proceso pero pueden usarse posteriormente para salidas o integraciones.
Estructura de la interfaz de la guía
Cada Guía de IA está organizada en tres pestañas principales:
📄 Detalles
La pestaña Detalles contiene las configuraciones generales de la guía, como:
- nombre para mostrar,
- tipo de guía,
- contexto de IA asociado,
- agente vinculado,
- descripción.
Esta pestaña define qué es la guía.
🛠️ Construir
La pestaña Construir es donde se define la lógica de la guía.
Se muestra:
- la lista de campos o preguntas de la izquierda,
- El mensaje asistido por IA y las instrucciones generadas a la derecha.
- Esta pestaña define cómo se comporta la guía.
✉️ Respuesta (solo automatización de correo electrónico)
La pestaña Respuesta se utiliza solo para la automatización del correo electrónico.
Permite la configuración de:
- una plantilla de respuesta por correo electrónico,
- archivos de plantilla adjuntos,
- firma de correo electrónico.
- Esta pestaña define cómo responde la IA por correo electrónico una vez que se completa el procesamiento o se requiere información adicional.
Resumen
En breve:
- Los contextos de IA definen cómo piensa y se comunica la IA,
- Las guías de IA definen lo que la IA debe recopilar, calcular o validar,
- Los agentes ejecutan guías dentro de un proceso,
- Las plantillas de respuesta se aplican únicamente a interacciones basadas en correo electrónico.
Si quieres, a continuación podemos:
- Acortar esto para una versión de “descripción general rápida”,
- o alinear el texto exactamente con las etiquetas del menú para mantener la coherencia en las páginas de ayuda.
Volver arriba
💬 Mensajes
Los mensajes son mensajes predefinidos, no relacionados con IA, que se pueden enviar durante una conversación.
Son mensajes codificados, es decir:
- no son generados por la IA,
- No utilizan el razonamiento ni el contexto de la IA,
- No se traducen automáticamente.
Los mensajes normalmente se utilizan para puntos de comunicación fijos en un proceso.
Propósito de los mensajes
Los mensajes están diseñados para:
- enviar confirmaciones (por ejemplo, confirmación de fin de conversación),
- mostrar información estandarizada,
- Asegúrese de que la redacción sea exacta cuando no se desee variabilidad.
Proporcionan una forma de transmitir mensajes controlados y deterministas junto con interacciones impulsadas por IA.
Cómo se utilizan los mensajes
Los mensajes se pueden activar:
- en pasos específicos de una conversación,
- al final de un proceso,
- como notificaciones del sistema durante una interacción.
Se utilizan comúnmente junto con:
- Guías de IA (que manejan la lógica dinámica),
- Agentes (que orquestan el flujo).
Características clave
- Los mensajes son estáticos.
- Son específicos del idioma y deben crearse por separado para cada idioma si es necesario.
- Garantizan un control total sobre la redacción, el tono y el texto legal o sensible al cumplimiento.
En breve:
👉 Los mensajes complementan las interacciones de IA al proporcionar bloques de comunicación fijos y confiables donde la variabilidad no es aceptable.
Volver arriba
⚡ Eventos
Los eventos representan ocurrencias internas del sistema generadas durante la ejecución de procesos.
Su objetivo es capturar momentos significativos del ciclo de vida de una conversación, la ejecución de un agente o el flujo de procesamiento de datos. La plataforma puede activar eventos automáticamente según condiciones predefinidas o la actividad del sistema.
Esta sección se utilizará más adelante para describir cómo se definen, registran y aprovechan los eventos dentro de Teemant para respaldar escenarios de monitoreo, automatización o integración.
En esta etapa, los Eventos deben considerarse como marcadores técnicos que reflejan lo que sucede dentro de la plataforma durante la ejecución del proceso.
Volver arriba
🔑 Identificadores
Los identificadores son números de referencia cronológicos únicos generados por Teemant para identificar cada interacción procesada.
Se utilizan para rastrear:
- conversaciones,
- flujos de procesamiento de correo electrónico,
- y los registros comerciales resultantes se intercambian con sistemas externos.
Un identificador actúa como referencia técnica de una instancia de proceso de principio a fin.
Propósito de los identificadores
Los identificadores se utilizan para:
- identificar de forma única una conversación o instancia de procesamiento de correo electrónico,
- garantizar la trazabilidad a lo largo de todo el ciclo de vida del proceso,
- hacer referencia al mismo caso en sistemas de información externos,
- Facilitar auditorías, seguimiento y resolución de problemas.
Proporcionan una clave de referencia estable compartida entre Teemant, los usuarios y los sistemas externos.
Estructura del identificador
Un identificador se define mediante una máscara, que puede incluir:
- un contador incremental,
- elementos de fecha o marca de tiempo,
- un prefijo fijo que identifica el proceso o entorno.
Ejemplo de estructura:
- prefijo (por ejemplo, DEMO),
- número incremental,
- año o marca de tiempo.
Esto permite que los identificadores sean:
- legible,
- ordenable,
- y único a lo largo del tiempo.
Cuando se generan identificadores
Los identificadores se generan al final de un proceso, justo antes:
- Se envían notificaciones por correo electrónico,
- Los datos se exportan a sistemas de información externos,
- Se envían mensajes de confirmación finales.
Esto garantiza que:
- Todos los datos recopilados o calculados están finalizados,
- El identificador refleja un proceso completado,
- El mismo identificador se puede reutilizar de forma consistente en todas las salidas, notificaciones e integraciones.
Rol en el seguimiento de procesos
Una vez generado, el identificador puede ser:
- incluido en correos electrónicos o notificaciones,
- incrustado en archivos exportados o cargas útiles,
- almacenados en sistemas externos como clave de referencia.
En breve:
👉Los identificadores hacen que cada interacción sea rastreable, auditable y vinculable entre sistemas.
Volver arriba
🧰 Herramientas
Las herramientas son aplicaciones externas que pueden activarse desde Teemant durante un proceso.
Permiten a Teemant ampliar sus capacidades al delegar acciones específicas a aplicaciones especializadas de terceros, mientras mantienen el proceso general orquestado por Teemant.
Propósito de las herramientas
Las herramientas se utilizan cuando un proceso requiere una acción que:
- no puede ser realizada directamente por la IA,
- debe ser manejado por un sistema externo certificado o especializado,
- requiere interacción del usuario fuera de la interfaz conversacional.
Los casos de uso típicos incluyen:
- capturando fotos certificadas y encriptadas,
- Recopilar una firma digital en un teléfono inteligente,
- ejecutar acciones reguladas o sensibles al cumplimiento.
Cómo se utilizan las herramientas en los procesos
Una herramienta puede ser:
- se activa en un paso específico durante una conversación,
- invocado como parte de un proceso impulsado por correo electrónico,
- incrustado en un flujo de trabajo del agente.
Cuando se activa, el usuario es redirigido o guiado a la aplicación externa y el resultado luego se devuelve a Teemant para continuar el proceso.
Integración y socios
Todas las herramientas requieren:
- una integración técnica con Teemant,
- y son proporcionados por socios certificados por Teemant.
Esto garantiza:
- seguridad e integridad de los datos,
- cumplimiento de los requisitos reglamentarios,
- intercambio confiable de información entre sistemas.
Se pueden integrar múltiples aplicaciones externas a lo largo del tiempo, dependiendo de las necesidades comerciales y las soluciones de socios disponibles.
Resumen
En breve:
👉 Las herramientas permiten a Teemant interactuar con aplicaciones externas para realizar acciones especializadas que van más allá de la IA conversacional, sin dejar de estar totalmente integradas en el flujo general del proceso.
Volver arriba
👁️ Visión
Visión – Inteligencia de documentos e imágenes
El módulo Visión gestiona la extracción de información de documentos e imágenes dentro de Teemant.
Vision es un agente de IA independiente, especializado en leer, analizar e interpretar documentos o imágenes para producir datos estructurados y utilizables.
Vision va más allá del OCR básico: combina la extracción visual con la comprensión y validación impulsadas por IA.
Visión como agente de IA especializado
Cada Visión está configurada como un agente de IA dedicado con su propio:
- Objetivo,
- Contexto del documento,
- Modelo de extracción,
- Lógica de procesamiento de IA.
El agente de Visión es responsable de:
- Lectura de documentos o imágenes (PDF, escaneos, fotos),
- Extracción de información sin procesar mediante OCR o análisis de imágenes,
- Aplicar la lógica de IA de Teemant sobre los datos extraídos para interpretarlos, normalizarlos y estructurarlos.
Esta capa de procesamiento de IA adicional permite a Vision gestionar diseños complejos, contenido escrito a mano e información ambigua.
Contexto del documento
Cada Visión está asociada a un Contexto Documental.
El contexto del documento define:
- El tipo de documento que se está procesando (por ejemplo, informe de accidente, certificado, factura, formulario escrito a mano),
- El significado semántico del documento,
- La estructura esperada y la lógica de negocio.
Este contexto guía al agente de Visión para que sepa:
- Qué información buscar,
- Cómo interpretar los valores extraídos,
- Cómo aplicar reglas específicas del dominio durante el procesamiento.
Flujo de extracción, procesamiento y validación
El flujo de trabajo de Visión siempre sigue el mismo principio:
- Extraer El texto sin procesar y la información visual se extraen del documento o la imagen mediante un motor de visión o OCR.
- Proceso Teemant AI procesa el contenido extraído campo por campo:
- Asigna datos a campos estructurados,
- Aplica formato y normalización,
- Interpreta valores ambiguos o parciales.
- Validar (opcional) Durante una conversación, el agente de Vision puede interactuar con el usuario para:
- Confirmar los valores extraídos,
- Solicitar información faltante,
- Corregir o refinar datos.
Este paso de validación es especialmente útil para documentos escritos a mano o escaneos de baja calidad.
Proveedores de visión
Teemant admite múltiples backends de Vision según el caso de uso:
- Microsoft Document Intelligence Generalmente se utiliza para documentos complejos, estructurados o escritos a mano, con modelos entrenados a medida.
- Mistral OCR OCR directo a través de API, más fácil de integrar pero generalmente menos confiable para documentos complejos.
En el futuro se podrán integrar plataformas Vision adicionales.
Independientemente del proveedor, la lógica de Vision sigue siendo la misma: extraer → procesar con IA → validar opcionalmente con el usuario.
Visión en procesos de extremo a extremo
Los agentes de visión están diseñados para integrarse en flujos de trabajo de Teemant más amplios, incluidos:
- Guías de recopilación de datos,
- Declaraciones de incidentes o reclamaciones,
- Automatización del correo electrónico,
- Exportaciones estructuradas a sistemas de información.
Al transformar documentos no estructurados en datos estructurados y validados, Vision juega un papel clave en la automatización de procesos con gran cantidad de documentos dentro de Teemant.
Volver arriba
📤 Salidas
El módulo de Salidas gestiona todos los flujos de salida de Teemant. Define cómo se entregan los datos, documentos y notificaciones generados por los agentes de IA a sistemas, aplicaciones y usuarios externos.
Los resultados pueden incluir:
- Notificaciones por correo electrónico con contenido estructurado o no estructurado
- Exportaciones de archivos (JSON, archivos multimedia, archivos ZIP, documentos generados)
- Transferencias SFTP
- API, webhooks y otros conectores salientes utilizados para integrar Teemant con sistemas de información empresarial
Cada configuración de salida le permite definir:
- El mecanismo de transporte (servidor de correo electrónico, SFTP, punto final de API, webhook, etc.)
- Los documentos y formatos de datos a enviar
- El contenido y la estructura de las notificaciones o cargas útiles exportadas
- Si se utiliza el servidor de correo Teemant predeterminado o un transporte dedicado
Los resultados suelen activarse al final de un proceso, una vez finalizada la recopilación de datos, el procesamiento de IA, las validaciones y la generación de identificadores. Garantizan que los resultados se entreguen de forma fiable, trazable y lista para la integración.
Este módulo representa la capa de entrega final de Teemant, lo que permite una comunicación fluida entre los flujos de trabajo impulsados por IA y los sistemas externos.
Volver arriba
📄 Documentos
La sección Documentos centraliza todo el contenido producido, enviado o gestionado por Teemant durante un proceso. Abarca correos electrónicos, documentos técnicos (como JSON) y archivos multimedia (fotos, archivos adjuntos, documentos generados).
Los documentos suelen ser utilizados por las salidas (notificaciones por correo electrónico, exportaciones SFTP, API, webhooks, conectores salientes) y pueden incluir variables dinámicas provenientes de conversaciones, procesamiento de IA y lógica empresarial.
✉️ Correos electrónicos
Los correos electrónicos son el tipo de documento más común en Teemant.
Se utilizan para:
- notificar a los usuarios finales,
- confirmar una declaración o acción,
- comunicarse con los equipos internos,
- o transmitir información a los socios.
Cada documento de correo electrónico define:
- destinatarios (Para / Cc / Cco),
- un tema dinámico (por ejemplo, usando {app.identifier}),
- un cuerpo de contenido personalizable,
- y un motor de plantillas.
Motores de plantillas disponibles
- Freemarker Un motor de plantillas estándar y potente, ideal para correos electrónicos complejos con condiciones, bucles y formato HTML avanzado.
- Motor de plantillas Teemant Un motor interno más simple, diseñado para crear rápidamente correos electrónicos claros y fáciles de mantener con una inserción de variables sencilla.
Las variables (por ejemplo, {app.accidentDate}, {user.email}…) se resuelven automáticamente en el momento del envío, en función de los datos recopilados y procesados por Teemant.
🧾 JSON y contenidos técnicos
Los documentos no se limitan a los correos electrónicos.
Teemant también administra documentos JSON utilizados para:
- inyección de datos en sistemas de información,
- exportaciones estructuradas,
- Integraciones a través de API, webhooks y conectores de salida.
Estos documentos estructurados garantizan intercambios de datos confiables, consistentes y estándar con sistemas externos.
📎 Medios y archivos
La categoría Medios agrupa todos los archivos manejados durante un proceso:
- fotos,
- documentos cargados por el usuario,
- archivos generados automáticamente,
- resultados de Vision (OCR, análisis de imágenes),
- archivos adjuntos enviados por correo electrónico o exportados.
Los archivos multimedia pueden ser:
- almacenado,
- analizado,
- exportados a través de salidas (correo electrónico, SFTP, API, webhooks, etc.),
- o vinculado a una conversación, un identificador o un proceso comercial.
🎯 Resumen
La sección Documentos es la base de todo el contenido saliente y técnico en Teemant.
Le permite:
- centralizar correos electrónicos y documentos,
- estandarizar formatos,
- Inyectar dinámicamente datos conversacionales y generados por IA.
- y garantizar una integración perfecta con sistemas externos.
Volver arriba
🧱 Modelos de objetos
Los modelos de objetos definen la capa de datos estructurados de Teemant. Se utilizan para modelar datos de referencia, datos operativos y objetos de configuración específicos del espacio de trabajo que se comparten entre agentes, procesos e integraciones.
Cumplen dos propósitos principales:
1️⃣ Modelos de datos de referencia y de negocio (sincronización de datos)
Los modelos de objetos se utilizan para construir bases de datos estructuradas que representan datos de referencia o comerciales requeridos por los procesos de Teemant, por ejemplo:
- Tiendas, agencias, filiales
- Vehículos, productos, contratos, pólizas
- Cualquier conjunto de datos de referencia externa utilizado durante conversaciones, procesamiento de documentos o enrutamiento
Estos modelos pueden ser entonces:
- Sincronizado con sistemas de información externos
- Mantenlo actualizado usando:
- Transportes → cómo se intercambian los datos (SFTP, API, conectores, etc.)
- Tareas → cuándo y con qué frecuencia se ejecuta la sincronización (a pedido, programada, incremental, etc.)
Esto permite a Teemant trabajar con datos empresariales confiables y en vivo y garantiza que los agentes de IA siempre confíen en información consistente y actualizada.
2️⃣ Objetos de configuración del espacio de trabajo (Propiedades dinámicas del espacio de trabajo)
Los modelos de objetos también pueden definir propiedades personalizadas a nivel de espacio de trabajo.
Estos no son conjuntos de datos de referencia, sino objetos de configuración adjuntos a un espacio de trabajo, como:
- Destinatarios de correo electrónico especiales (por ejemplo, correo electrónico de RC, correo electrónico de escalada, correo electrónico de socio)
- Identificadores, códigos o parámetros comerciales específicos de un espacio de trabajo
- Cualquier propiedad personalizada que deba aparecer en la configuración del espacio de trabajo
Una vez definido:
- Estos campos estarán disponibles automáticamente en la configuración del espacio de trabajo.
- Se pueden reutilizar en:
- Documentos y notificaciones
- Salidas
- Guías de IA
- Automatizaciones y lógica de enrutamiento
Esto hace que los modelos de objetos sean una forma poderosa de ampliar Teemant sin código personalizado, simplemente modelando nuevas propiedades estructuradas.
Tipos de campos admitidos
Los modelos de objetos admiten un conjunto controlado de tipos de campos para garantizar la coherencia y la interoperabilidad, incluidos:
- cadena
- entero
- número
- correo electrónico
- fecha
- ubicación
- contenido
Estos tipos están diseñados para ser totalmente compatibles con el procesamiento de IA, la creación de plantillas de documentos, las exportaciones y las integraciones.
Por qué son importantes los modelos de objetos
Los modelos de objetos son la base de la arquitectura de datos de Teemant:
- Estructuran cómo se almacenan, comparten y sincronizan los datos.
- Conectan agentes de IA con sistemas empresariales
- Permiten personalizar los espacios de trabajo de forma limpia y escalable
En resumen, los modelos de objetos convierten a Teemant en una plataforma de IA consciente de los datos, no solo en una conversacional.
Volver arriba
🧱 Configuración del espacio de trabajo
Un espacio de trabajo representa un inquilino lógico en Teemant. Define los límites funcionales, técnicos y organizativos dentro de los cuales operan los agentes, los datos, las integraciones y los usuarios. En la práctica, un espacio de trabajo suele corresponder a un entorno (desarrollo, pruebas, producción) o a una unidad de negocio o cliente específico.
Medio ambiente y gobernanza (Principal)
La pestaña Principal centraliza la configuración principal del espacio de trabajo:
- Nombre, configuración regional y zona horaria
Estas configuraciones definen cómo se localiza el contenido (idioma, formatos de fecha) y cómo se evalúa la lógica basada en el tiempo (eventos, tareas, notificaciones).
- Mejores prácticas: Múltiples espacios de trabajo
Se recomienda encarecidamente crear espacios de trabajo separados para:
- Desarrollo (experimentación y configuración),
- Pruebas / UAT (validación y aprobación comercial),
- Producción (operaciones en vivo, usuarios finales). Esto garantiza el aislamiento, la seguridad y las implementaciones controladas.
- Espacio de trabajo público
Cuando un espacio de trabajo está marcado como Público, se vuelve accesible para los usuarios finales según el canal:
- WhatsApp: cualquier usuario con una cuenta Meta WhatsApp,
- Microsoft Teams/Google Chat: usuarios autorizados para instalar la app Teemant. Esto es especialmente útil para escenarios de usuarios a gran escala o abiertos.
- Correos electrónicos de contacto predeterminados Las direcciones de correo electrónico de contacto definidas aquí actúan como destinatarios de respaldo global para notificaciones y salidas (correos electrónicos, alertas, exportaciones) cuando no se configura ningún destino más específico.
Proveedores y servicios de IA
La pestaña Proveedores es donde el espacio de trabajo se conecta a su ecosistema tecnológico:
- Aquí se configuran las claves API para LLM, motores de OCR, Vision/Document AI y otros servicios de IA.
- Los clientes pueden:
- traer sus propias claves API, o
- Confíe en las claves proporcionadas por Teemant, según la configuración y el acuerdo.
- Esta configuración se aplica a todo el espacio de trabajo y la reutilizan agentes, Vision, procesamiento de documentos y funciones de automatización.
Configuraciones empresariales específicas del espacio de trabajo (modelos de objetos)
La tercera pestaña (por ejemplo, “Auchan Gestionnaires” en las capturas de pantalla) ilustra cómo se utilizan los modelos de objetos a nivel del espacio de trabajo:
- Estos objetos definen propiedades personalizadas del propio espacio de trabajo, como:
- direcciones de correo electrónico de destinatarios especiales (por ejemplo, correo electrónico RC, correo electrónico DAB),
- campos de configuración específicos del negocio,
- cualquier metadato específico del dominio requerido por los flujos de trabajo o las salidas.
- Una vez definidos, estos campos aparecen directamente en la configuración del espacio de trabajo y se puede hacer referencia a ellos mediante:
- agentes,
- documentos y plantillas,
- salidas (correos electrónicos, API, exportaciones),
- integraciones.
En resumen, el espacio de trabajo no es solo un contenedor: es la capa de configuración central que une entornos, usuarios, proveedores de IA, reglas comerciales e integraciones, lo que garantiza la consistencia y el control en toda la plataforma Teemant.
Volver arriba
👥 Miembros del espacio de trabajo
Los miembros del espacio de trabajo son los administradores de un espacio de trabajo (inquilino). Son responsables de configurar, gestionar y controlar el uso de Teemant en un entorno determinado.
Los miembros son usuarios internos (sus equipos, socios o integradores), no usuarios finales que interactúan con chatbots o correos electrónicos.
Roles y permisos
Cada miembro del espacio de trabajo puede tener uno o más de los siguientes roles:
- Administrador
- Acceso completo a la configuración del espacio de trabajo
- Puede gestionar configuraciones, proveedores, usuarios, canales, salidas, documentos, etc.
- No se pueden construir agentes de IA
- Gerente
- Puede administrar usuarios, canales, configuraciones y configuraciones operativas.
- No se pueden construir agentes de IA
- Constructor de bots
- Solo se pueden crear y configurar agentes de IA (guías de IA, contextos, flujos)
- Sin acceso a la administración a nivel de espacio de trabajo
Esta separación de roles garantiza una gobernanza clara, seguridad e implementaciones controladas.
Mejores prácticas
- Espacio de trabajo de desarrollo
- Otorgar todos los roles (Administrador, Gerente, Creador de bots)
- Este es el único lugar donde se diseñan y configuran los agentes de IA.
- Espacios de trabajo de prueba y producción
- Solo roles de administrador y/o gerente de subvenciones
- No se permite la construcción de ningún agente.
- Los agentes se implementan aquí, no se crean.
- Un espacio de trabajo por aplicación de cliente
- Se recomienda encarecidamente mantener las configuraciones aisladas
- Mejora la seguridad, la capacidad de mantenimiento y la claridad de la implementación.
Por qué esto importa
Este enfoque:
- Previene cambios accidentales en la producción
- Aplica un ciclo de vida limpio de compilación → prueba → implementación
- Hace que las auditorías, el soporte y la resolución de problemas sean mucho más fáciles.
- Se alinea con las prácticas de TI y DevOps de nivel empresarial
Los miembros del espacio de trabajo definen quién puede hacer qué, mientras que los agentes de IA definen lo que hace el sistema.
Volver arriba
👥 Usuarios del agente del espacio de trabajo (usuarios finales)
Los usuarios agentes son los usuarios finales que pueden acceder e interactuar con los agentes de Teemant (chatbots, automatización de correo electrónico, etc.) dentro de un espacio de trabajo.
No son administradores ni configuran la plataforma. Su función es únicamente usar los agentes a través de los canales de interacción habilitados.
🔐 Reglas de acceso
El acceso a los agentes depende de la visibilidad del espacio de trabajo:
- Espacio de trabajo privado (predeterminado) Solo los usuarios definidos explícitamente como Usuarios de agente pueden ver e interactuar con los agentes.
- Espacio de trabajo público Todos los usuarios que puedan acceder al canal pueden interactuar con los agentes:
- WhatsApp: cualquier usuario autenticado en Meta WhatsApp
- Microsoft Teams: usuarios autorizados para instalar/usar la aplicación Teemant
- Google Chat: usuarios autorizados dentro de Google Workspace
Cada usuario agente puede ser:
- Habilitado o deshabilitado
- Asociado a uno o más canales
- Configurado con configuración regional y detalles de contacto
📱 Mejores prácticas específicas para cada canal
El control de acceso debe seguir la lógica de cada canal:
- La gestión del acceso a Microsoft Teams/Google Chat/Correo electrónico generalmente la gestiona el departamento de TI o el proveedor de identidad del cliente (Azure AD, Google Workspace, sistemas de correo, etc.).
- WhatsApp Dado que WhatsApp generalmente está abierto al público, la autenticación debe gestionarse dentro del proceso, por ejemplo:
- Identificación de empleado o agente
- Número de matrícula del vehículo
- Número de póliza o contrato
- Verificación basada en documentos (identificación, formulario, foto, etc.)
Esta lógica de autenticación normalmente se implementa dentro de la Guía de IA y el flujo de conversación, no a nivel de canal.
✅ Prácticas recomendadas
- Mantenga a los usuarios del agente estrictamente separados de los miembros del espacio de trabajo (administradores, gerentes, constructores).
- Utilice espacios de trabajo privados para implementaciones controladas.
- Delegar el control de identidad y acceso a los sistemas del cliente siempre que sea posible.
- Diseñe pasos de autenticación explícitos en los flujos conversacionales, especialmente para canales públicos como WhatsApp.
En resumen, los usuarios del agente definen quién puede hablar con la IA, mientras que los miembros del espacio de trabajo definen quién puede configurarla.
Volver arriba
🔌 Canales del espacio de trabajo
Los canales definen cómo los usuarios interactúan con los agentes de Teemant y dónde se reciben y envían mensajes, correos electrónicos o conversaciones.
Cada canal representa una integración concreta con una plataforma de comunicación externa como WhatsApp, Microsoft Teams, Google Chat, sistemas de correo electrónico o herramientas de chat en vivo.
Un espacio de trabajo puede tener múltiples canales habilitados al mismo tiempo, lo que permite que los mismos agentes de IA operen de manera consistente en diferentes puntos de contacto.
💬 Canales de chat (conversacionales)
Los canales de WhatsApp conectan Teemant con las cuentas Meta de WhatsApp Business mediante un número de teléfono dedicado.
Cómo funciona:
- Cualquier usuario autenticado en WhatsApp puede contactar con el bot a través del número configurado.
- La visibilidad del espacio de trabajo (público o privado) determina si se requiere control de acceso adicional.
- En la mayoría de los casos de uso de la vida real, la autenticación se maneja dentro del flujo de IA, no por WhatsApp en sí (por ejemplo, identificación del empleado, número de placa, matrícula, identificación del documento, etc.).
- WhatsApp se utiliza normalmente para usuarios externos o audiencias a gran escala.
Mejores prácticas:
Utilice la autenticación conversacional dentro de la lógica del agente cuando haya datos confidenciales involucrados.
💼 Equipos de Microsoft
Los canales de Microsoft Teams permiten que los agentes de Teemant operen dentro de un inquilino de Microsoft.
Cómo funciona:
- El acceso está restringido a los usuarios autenticados en el inquilino de Teams configurado.
- El ID de inquilino de Teams define el alcance de los usuarios autorizados.
- Ideal para casos de uso interno (soporte de TI, RRHH, operaciones, asistentes internos).
Mejores prácticas:
Permita que los equipos administren la identidad y el acceso; evite duplicar la lógica de autenticación dentro del bot a menos que sea necesario.
💬 Chat de Google
Los canales de Google Chat conectan a Teemant con un dominio de Google Workspace.
Cómo funciona:
- Solo los usuarios autenticados dentro del dominio de Google configurado pueden acceder al bot.
- El control de acceso se gestiona naturalmente mediante los permisos de Google Workspace.
- Muy adecuado para asistentes corporativos internos.
🧑💻 Chat en vivo (Chatwoot)
Los canales de LiveChat conectan a Teemant con plataformas de chat de terceros, como Chatwoot.
Cómo funciona:
- Teemant actúa como una capa de IA detrás del sistema de chat en vivo.
- La IA puede automatizar respuestas de primer nivel, recopilación de datos y clasificación.
- Los agentes humanos pueden hacerse cargo de las conversaciones cuando sea necesario.
Mejores prácticas:
Utilice las integraciones de LiveChat para flujos de trabajo híbridos de IA soporte humano.
📧 Canales de correo electrónico
📩 Correo de Google
Los canales de Google Mail permiten a Teemant leer, clasificar y responder correos electrónicos de un buzón de destino.
Conceptos clave:
- Se requieren credenciales de OAuth (ID de cliente, secreto, token de actualización).
- Los agentes de IA procesan los correos electrónicos para clasificarlos, extraer datos y redactar respuestas.
- La gestión del consentimiento garantiza el cumplimiento de la autorización del usuario.
📬 Microsoft Mail
Los canales de Microsoft Mail se integran con los buzones de correo de Microsoft 365.
Cómo funciona:
- Los correos electrónicos se ingieren, analizan y envían al agente de IA apropiado.
- Los agentes pueden extraer datos estructurados, actualizar el sistema de información y generar respuestas.
- Se requiere el consentimiento explícito del usuario antes de activar el procesamiento de IA.
Casos de uso típicos:
- Automatización del correo electrónico
- Declaraciones de incidentes
- Solicitudes de clientes o socios
- Automatización de procesos de back-office
⚙️ Principios de configuración del canal
- Cada canal tiene:
- Un estado (habilitado/deshabilitado)
- Una descripción para documentación y claridad.
- Un modo borrador para configurar de forma segura antes de publicar
- Los canales se pueden agregar de forma independiente y activar progresivamente.
- La misma lógica del agente se puede reutilizar en múltiples canales.
✅ Mejores prácticas
- Cada entorno separado (desarrollo, pruebas y producción) debería tener sus propios canales.
- Prefiera la autenticación de plataforma nativa (Teams, Google Chat, Mail).
- Para canales abiertos como WhatsApp, implemente la autenticación dentro de la conversación de IA.
- Mantenga la configuración del canal mínima; la complejidad debe residir en las guías de IA y la lógica del agente, no en el canal en sí.
Volver arriba
🔁 Transportes del espacio de trabajo
Los transportes definen cómo se exportan los datos y documentos desde Teemant a sistemas externos.
Son el puente técnico entre Teemant y sus sistemas de información, data lakes, ERPs, CRMs o herramientas operativas.
Las tareas suelen utilizar un transporte para determinar cuándo, cómo y dónde se envían los datos.
📦 Para qué se utilizan los transportes
Los transportes te permiten:
- Exportar datos estructurados (JSON, metadatos, modelos de objetos)
- Exportar documentos (PDF, imágenes, archivos ZIP)
- Sincronizar bases de datos de referencia con sistemas externos
- Enviar datos automáticamente o según un cronograma
Se utilizan más comúnmente para:
- Integraciones de sistemas
- Sincronización de datos
- Informes y archivos
- Automatización operativa
📁 Transferencia de archivos (SFTP / FTP) 📤
Los transportes de transferencia de archivos se utilizan para enviar archivos a servidores externos, generalmente backends empresariales.
Características principales:
- Admite SFTP/FTP
- Los datos se pueden exportar como:
- JSON
- Documentos
- Archivos ZIP (recomendados para exportaciones por lotes)
- Autenticación segura mediante cuenta y contraseña
- Ruta de destino configurable
Casos de uso típicos:
- Exportar conjuntos de datos diarios u horarios a un ERP
- Sincronizar bases de datos de referencia
- Enviar datos estructurados a sistemas heredados
- Tuberías de procesamiento por lotes
Ejemplo:
Exporte todos los documentos procesados y metadatos como un archivo ZIP a un servidor SFTP todas las noches.
✉️ Transporte de correo electrónico
Los transportes de correo electrónico permiten a Teemant enviar datos o documentos por correo electrónico.
Características principales:
- Configuración SMTP (host, puerto, cifrado)
- Autenticación mediante cuenta de correo electrónico
- Admite archivos adjuntos
- Se puede utilizar para notificaciones o envío de datos.
Casos de uso típicos:
- Enviar informes o exportaciones a usuarios comerciales
- Notificar a los equipos cuando se actualizan los datos
- Integraciones ligeras sin sistema backend
🌐 Webhooks 🔔
Los webhooks permiten enviar notificaciones push en tiempo real a sistemas externos.
Características principales:
- Puntos finales HTTP(S)
- Entrega basada en eventos
- Cargas útiles enviadas en JSON
- Autenticación segura (encabezados, tokens)
Casos de uso típicos:
- Activar flujos de trabajo en plataformas externas
- Notificar instantáneamente a los sistemas posteriores
- Integración con herramientas de automatización (Zapier, Make, API personalizadas)
Ejemplo:
Cuando se procesa un documento, notifica inmediatamente a un sistema externo con sus metadatos.
🔌 API REST 🧩
Los transportes API REST permiten que los sistemas externos extraigan o reciban datos mediante programación.
Características principales:
- Puntos finales REST estándar
- Autenticación segura (claves API, OAuth, tokens)
- Admite el intercambio de datos estructurados
- Diseñado para integraciones escalables
Casos de uso típicos:
- Integración de sistema a sistema en tiempo real
- Aplicaciones externas que consultan datos de Teemant
- Orquestación y automatización avanzadas
🧠 Cómo funcionan los transportes con modelos de objetos y tareas
Los transportes no se utilizan solos:
- Los modelos de objetos definen qué datos existen
- Los transportes definen cómo y dónde se envían los datos
- Las tareas definen cuándo y con qué frecuencia se sincronizan los datos
Juntos forman un canal de sincronización de datos completo.
✅ Mejores prácticas
✔ Use SFTP ZIP para exportaciones de datos grandes o por lotes✔ Use Webhooks para integraciones en tiempo real✔ Use API REST para sistemas avanzados o interactivos✔ Transportes separados por entorno (Desarrollo/Prueba/Producción)✔ Siempre pruebe los transportes antes de publicarlos en producción
🧭 Resumen
Los transportes son la columna vertebral de las integraciones de Teemant.
Garantizan que los datos producidos dentro de Teemant fluyan de manera confiable, segura y automática hacia su ecosistema empresarial.
Están diseñados para ser:
- Flexible
- Escalable
- Listo para la empresa
Volver arriba
⏱️ Tareas del espacio de trabajo
Las tareas del espacio de trabajo se utilizan para configurar operaciones automatizadas o bajo demanda que se ejecutan a nivel del espacio de trabajo. Se suelen usar para importar o exportar datos, sincronizar datos de referencia o ejecutar procesos técnicos recurrentes vinculados al sistema de información.
🔁¿Qué es una Tarea?
Una tarea representa una acción repetible ejecutada por Teemant, generalmente basada en:
- un ámbito de datos (entidad, modelo de objeto, documentos, etc.)
- un transporte (SFTP, correo electrónico, API, webhook, …)
- un horario o un disparador
Ejemplo que se muestra en la captura de pantalla:
- Tienda de importación
- Entidad: Tienda
- Transporte: Importación SFTP
- Programador: HABILITADO
Esto significa que Teemant importará periódicamente datos de la tienda desde un sistema externo mediante SFTP.
🧩 Casos de uso típicos
Las tareas se utilizan comúnmente para:
- 📥 Importaciones de datos
- Datos de referencia (tiendas, productos, usuarios, contratos, etc.)
- Datos de configuración o maestros procedentes de sistemas externos
- 📤 Exportaciones de datos
- Salidas estructuradas (JSON, ZIP, documentos)
- Envío de datos recopilados o procesados por IA al SI
- 🔄 Trabajos de sincronización
- Mantenga los modelos de objetos de Teemant alineados con bases de datos externas
- Actualización periódica de datos compartidos
- ⚙️ Otras operaciones programadas
- Procesamiento por lotes
- Limpieza, consolidación o futuros trabajos automatizados
El sistema está diseñado para ser extensible, por lo que se pueden agregar tipos adicionales de tareas recurrentes o activadas con el tiempo.
🧠 Cómo funcionan las tareas con los transportes
Las tareas no mueven datos por sí solas, sino que dependen de los transportes:
- Un transporte define cómo se intercambian los datos (SFTP, correo electrónico, API, webhook, etc.)
- Una tarea define cuándo y qué se intercambia
Esta separación permite:
- Reutilizar el mismo transporte en múltiples tareas
- Cambiar horarios sin tocar la configuración de conectividad
▶️ Ejecución manual vs. ejecución programada
- Las tareas pueden ser:
- Programado (ejecución regular, según configuración)
- Activado manualmente (usando la acción Ejecutar)
Esto es especialmente útil para:
- Pruebas de importaciones/exportaciones
- Sincronizaciones únicas
- Solución de problemas de producción
Mejores prácticas
- 🔧 Configurar tareas principalmente en espacios de trabajo de desarrollo
- 🧪 Validar el comportamiento en espacios de trabajo de prueba
- 🚀 Mantenga las tareas de producción limitadas, estables y monitoreadas
- 📦 Utilice un espacio de trabajo por aplicación cliente para aislar tareas y flujos de datos
Volver arriba
🧠 Constructor de agentes Teemant: descripción general
El Constructor de Agentes de Teemant es el entorno de diseño principal de la plataforma. Es donde se crean, estructuran, orquestan y publican los agentes de IA.
Un agente de Teemant no es solo un chatbot.
👉Es un proceso de IA de nivel empresarial, capaz de guiar a los usuarios, aplicar lógica empresarial, interactuar con sistemas y producir resultados estructurados.
🧩 Tipos de agentes: Procesos vs. Navegadores
⚙️ Procesos (Procesos de Negocio)
Los procesos son agentes completos y autónomos diseñados para:
- Recopilar información estructurada
- Guía a los usuarios paso a paso
- Aplicar reglas y cálculos de negocio
- Generar salidas (JSON, documentos, exportaciones, correos electrónicos, etc.)
Casos de uso típicos
- Declaración de incidente o siniestro
- Informe de daños
- Declaración de responsabilidad o responsabilidad
Los procesos representan flujos de negocio de extremo a extremo.
🧭 Navegantes (Otros)
Los navegantes son agentes de orquestación.
No finalizan un proceso de negocio sino que se utilizan para:
- Calificar la situación del usuario
- Autenticar o identificar usuarios
- Dirigir a los usuarios al subproceso correcto
- Dividir flujos según condiciones o elecciones
Casos de uso típicos
- Verificación de la póliza de seguro
- Elegir el tipo de incidente
- Enrutamiento entre escenarios “con terceros / sin terceros”
💡 En una aplicación completa, los Navegadores actúan como bloques de construcción que conectan y organizan múltiples procesos.
Pestaña principal: Configuración del agente
La pestaña Principal define la identidad y el comportamiento de un agente.
📛 Identificación
- Nombre: identificador técnico (único, estable)
- Nombre para mostrar: nombre legible para humanos que se muestra en los canales y la interfaz de usuario
✅ Mejores prácticas:
Utilice convenciones de nomenclatura estrictas que incluyan alcance, versión y propósito.
Contextos de IA
- Contexto global Define el entorno general:
- empresa u organización
- vocabulario y terminología
- reglas globales
- tono general
- Contexto del agente Define la misión específica del agente:
- lo que el agente debe lograr
- quiénes son los usuarios
- tono de comunicación
- datos a recopilar
👉Estos contextos determinan directamente el comportamiento de la IA durante las conversaciones y el procesamiento del correo electrónico.
🚀 Modo de lanzamiento
- FLOW_ONLY El agente se utiliza solo dentro de otro proceso → no es directamente visible para los usuarios finales
- DIRECTO Se puede acceder al agente directamente desde un canal → visible como punto de entrada para los usuarios
💡 Esta configuración determina si el agente es:
- un componente interno
- o un punto de entrada orientado al usuario
Pestaña Flujo: Orquestación de procesos
La pestaña Flujo proporciona una representación visual de la lógica del agente.
Cada bloque representa:
- otro agente
- un navegante
- un paso de cálculo
- un identificador
- un mensaje final
- una acción de exportación o correo electrónico
🔗 Lógica de flujo
- Pasos secuenciales
- Ramas condicionales
- Árboles de decisión complejos
👉Aquí es donde se implementan realmente la inteligencia empresarial y la orquestación.
📡 Publicación y disponibilidad
📤 Publicar / Dejar de publicar
- Publicar: activa el agente
- Anular publicación: lo desactiva instantáneamente
Una vez publicado, el agente se vuelve accesible:
- a través de los canales configurados
- según su modo de lanzamiento
- Respetar las reglas de acceso al espacio de trabajo
📦 Exportar / Importar (archivos .tee)
Los agentes pueden ser:
- exportados como archivos .tee
- importados a otros espacios de trabajo
Esto permite:
- plantillas y reutilización
- control de versiones
- estandarización entre proyectos
- implementaciones más rápidas
Los archivos .tee son un activo fundamental del ecosistema Teemant.
🧠 Mejores prácticas
Convenciones de nomenclatura estrictas
Incluya siempre:
- alcance funcional
- versión
- rol de agente
Esto es fundamental para:
- mantenimiento
- escalabilidad
- legibilidad de flujos complejos
🧩 Arquitectura modular
- Mantenga a los agentes pequeños y especializados
- Navegadores de reutilización
- Centralizar la lógica compartida
👉Cuanto más simple sea cada agente, más robusto será el sistema general.
🧩 Resumen
El constructor de agentes de Teemant le permite:
- Diseñar procesos de negocio complejos impulsados por IA
- orquestar recorridos de usuario inteligentes
- conectar la IA a los sistemas empresariales
- Implementar en múltiples canales
- Industrializar y replicar casos de uso de IA
👉 Es una plataforma de diseño de procesos de negocios impulsada por IA, no solo un creador de chatbots.
Volver arriba
Llamadas de agentes de Teemant (procesos reutilizables)
🔍 Descripción general
Las llamadas de agente de Teemant son procesos invocables, diseñados para ser reutilizados por uno o varios agentes. Representan bloques de proceso independientes que pueden invocarse desde diferentes flujos en lugar de duplicarse.
Piense en ellos como una lógica empresarial compartida a la que se puede llamar cuando sea necesario.
🧩 Por qué son importantes las llamadas de los agentes
Las llamadas de agente son particularmente útiles cuando:
- 🔁El mismo proceso debe ejecutarse varias veces
- 🧠 La lógica es compleja y debería residir en un solo lugar.
- 🧱 Quieres arquitecturas de agentes limpias y fáciles de mantener
- 🔄 Múltiples agentes o flujos dependen de la misma regla de negocio
Ejemplos típicos:
- Pasos de autenticación o identificación
- Verificación de la póliza de seguro
- Lógica de calificación de daños
- Verificaciones de elegibilidad
- Circunstancias (amistoso vs responsabilidad, etc.)
🏗️ Cómo funcionan las llamadas de los agentes
Una llamada de agente es:
- Un proceso, no un agente conversacional completo
- No expuesto directamente a los usuarios
- Activado desde otro agente o flujo
- Ejecutado con el contexto actual
📌 Se comporta como una llamada de función dentro de un flujo de trabajo conversacional más amplio.
🧠 Modelo de ejecución
- Un agente principal llega a un punto donde se requiere una lógica compartida
- Llama a una llamada de agente
- La llamada del agente:
- Utiliza el contexto actual
- Ejecuta su proceso interno
- El control se devuelve al agente que llama.
➡️ Sin interrupciones para el usuario, sin lógica duplicada.
🧭 Casos de uso típicos
Caso de uso ¿Por qué usar una llamada de agente? 🔐 Autenticación La misma verificación se usa en muchos flujos 🧾 Búsqueda de pólizas Compartido entre múltiples tipos de reclamos 🚗 Circunstancias Lógica amistosa vs. de terceros 📄 Validación de documentos Reglas de validación reutilizables 🔁 Verificaciones de varios pasos Lógica de decisión centralizada
🧱 Mejores prácticas de arquitectura
✅ Una llamada de agente = una responsabilidad
- Mantenga las llamadas del agente enfocadas
- Evite mezclar la navegación de la interfaz de usuario y la lógica central
- Nombrarlos muy explícitamente
📌 Ejemplo de convención de nomenclatura:
- FLOT6x-LLAMADA-AMIGABLE
- FLOT6x-CIRCUNSTANCIA-LLAMADA
- IDENTIFICADOR DE POLÍTICA FLOT1.0
Una denominación clara es fundamental cuando los flujos se vuelven grandes.
🔄 Relación con los agentes de Teemant
Rol de componente 🤖 Agente Teemant Agente orientado al usuario u orquestador 🧭 Navegador Guía a los usuarios a subprocesos 📞 Llamada de agente Proceso invocable reutilizable
➡️ Los navegadores deciden a dónde ir ➡️ Las llamadas de los agentes ejecutan una lógica compartida
🚀 Implementación y disponibilidad
- Las llamadas del agente son:
- 📦 Publicado como agentes regulares
- 🔌 Disponible para cualquier agente en el espacio de trabajo
- Una vez publicados, se pueden reutilizar inmediatamente.
- Las actualizaciones se aplican automáticamente en todos los lugares donde se utilizan
🧠 Conclusiones clave
- 📞 Llamadas de agente = Bloques de procesos reutilizables
- 🔁Evita la duplicación, mejora la consistencia
- 🧩 Esencial para sistemas de agentes complejos y de gran escala
- 🏗️ Una piedra angular de las arquitecturas limpias de Teemant
Volver arriba
