> ## Documentation Index > Fetch the complete documentation index at: https://docs.shimli.app/llms.txt > Use this file to discover all available pages before exploring further. # Agente de IA en el flujo > El paso que sostiene la conversación por su cuenta — instrucciones, límites, habilidades, acciones y cuándo entrega el chat a un humano. El **Agente de IA** es un paso especial del Flow Builder: en vez de enviar un mensaje y seguir, **se queda sosteniendo la conversación**. Responde, decide, usa herramientas y sabe cuándo entregar el chat a una persona. Mientras el agente está atendiendo, el flujo no avanza a ningún otro paso. Es él quien conversa. Funciona en canales de chat y de voz. ## Identidad: quién es tu agente Lo primero que defines es cómo se comporta: | Campo | Para qué | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | **Nombre** | Cómo se llama | | **Descripción** | Qué hace, en una línea | | **Instrucciones** | El corazón del agente: cómo debe comportarse, qué tono usa, qué hace y qué no | | **Olvidar entrenamiento** | Si lo activas, responde **solo** con tu conocimiento, tus instrucciones y lo que devuelvan sus herramientas — nunca con lo que sabía de antes | **"Olvidar entrenamiento"** ancla al agente exclusivamente en tu información: responde con tus precios, tus políticas y tu disponibilidad reales, y nada más. Es la opción indicada cuando la exactitud manda. ## Conocimiento Súbele los documentos con los que debe responder: PDF, Word e imágenes. Es la diferencia entre un agente que suena bien y uno que responde correcto. Catálogos, políticas de devolución, preguntas frecuentes, listas de precios. ## Habilidades Las **habilidades** son instrucciones específicas para situaciones concretas. Cada una tiene: * **Un título** que dice **cuándo aplica**: "Devoluciones y reembolsos", "Hospedaje", "Reclamos de garantía". * **Un texto** que explica cómo manejar esa situación. El agente elige la habilidad por su título, así que títulos precisos lo hacen más certero. "Política de envíos", "Formas de pago" y "Garantías" funcionan mejor que una sola "Todo sobre la empresa": cuanto más específica es cada habilidad, más exacta es la respuesta. Las habilidades **no ejecutan nada**: son instrucciones que se le dan al agente. Lo que ejecuta cosas son las acciones. ## Acciones: lo que el agente puede hacer Las **acciones** son las herramientas del agente. Sin ellas solo conversa; con ellas trabaja. | Tipo de acción | Qué le permite hacer | | ---------------------------- | --------------------------------------------------------------------------- | | **Entregar la conversación** | Pasar el chat a un humano | | **Base de datos** | Buscar, insertar, actualizar o borrar registros | | **Tienda** | Crear y modificar pedidos, ver categorías y productos, y manejar el carrito | | **API / conector** | Llamar a un sistema externo | | **Ejecutar código** | Correr código Python | | **Código asistido** | Describir qué necesita y que el modelo escriba y ejecute el código | | **Navegar internet** | Buscar y operar en la web | | **Crear tarea** | Agendar algo para después | | **Servidor MCP** | Conectarse a un servidor de herramientas externo | Cada acción tiene un nombre y una descripción. La **descripción es lo que el agente lee para decidir cuándo usarla** — escribe ahí la condición, no solo una etiqueta. El agente decide por sí solo cuándo pasar la conversación al resto del flujo: activa la salida en las acciones que quieras usar como puerta —entregar a un humano, ir a pagar, abrir un ticket— y esas se vuelven los caminos disponibles en el canvas. ## La entrega a un humano Es la acción más importante y la que más se configura mal. El agente lee la descripción para decidir cuándo entregar. No pongas "Hablar con un asesor": pon en qué situaciones debe hacerlo. Es lo que se le dice a la persona justo antes de pasar con un humano. Escríbelo siempre: un *"te comunico con un asesor, un momento"* hace que la transición se sienta atendida y no como una pausa. Los campos que el agente debe completar antes de entregar: el motivo, el número de pedido, lo que necesite quien reciba el chat. Puedes dejarlos libres o limitarlos a una lista de valores. La entrega siempre tiene salida y no se puede desactivar. Conéctala al resto del flujo — normalmente a un paso de **Abrir ticket**. Conecta cada salida que hayas activado al paso que corresponda. Así cada decisión que toma el agente tiene continuidad: la persona pasa al área correcta, al pago o al cierre, sin repetir lo que ya contó. Llenar los datos que viaja la entrega tiene dos beneficios: quien recibe el chat llega con contexto, y las reglas de seguridad pueden verificar condiciones — solo se puede verificar un dato que efectivamente viaja. ## Reglas de seguridad Las **reglas** son los límites del agente. Cada una tiene un nombre, una descripción, qué vigila y qué hacer cuando se incumple: registrarlo, advertir o bloquear. Pueden vigilar tres cosas: | Vigila | Para qué sirve | | -------------------------- | -------------------------------------------------------------------------------- | | **Los mensajes** | Qué cuenta como violación, qué debe decir en su lugar, qué no puede decir nunca | | **La entrega a un humano** | En qué casos **no** puede entregar la conversación, y opcionalmente en cuáles sí | | **Acciones obligatorias** | Qué tiene que hacer sí o sí antes de continuar | Tienes control fino sobre cuándo el agente puede usar cada acción. La forma más práctica de aprovecharlo es definir solo los casos que quieres bloquear —fuera de horario, clientes sin cuenta activa— y dejar el resto abierto: el agente conserva todos sus caminos y tú acotas exactamente lo que te interesa acotar. ## Capacidades Además de las acciones, puedes activarle capacidades generales: * Interpretar código * Buscar en internet * Generar imágenes * Generar video * Operar la computadora * Reconocer y comparar rostros * Gestionar tareas ## Recomendaciones Por las **instrucciones** y el **conocimiento**. Un agente con buenas instrucciones y tus documentos reales ya resuelve la mayor parte de las conversaciones. Las acciones y las reglas las vas sumando después, a medida que ves qué más quieres que haga por su cuenta. Activa **olvidar entrenamiento**, cárgale tu conocimiento real y suma una regla de seguridad para los temas donde la exactitud manda: precios, plazos y disponibilidad. Las instrucciones son cómo se comporta **siempre**. Una habilidad es cómo maneja **una situación concreta**. Si tienes que escribir "cuando el cliente pregunte por X…", eso es una habilidad. El agente sostiene la conversación mientras la esté resolviendo, y la entrega en cuanto se da una de las acciones que configuraste como salida. Deja al menos una de entrega activada y conectada: esa es la señal que usa para pasar la posta.