Los nodos de Inteligencia Artificial permiten que tus flujos piensen, tomen decisiones y respondan con naturalidad a tus usuarios, sin necesidad de programar respuestas rígidas para cada posible pregunta.

Mermaid

graph TD
    U[Pregunta del Cliente] --> A[Nodo: Agent]
    A -->|Decide usar una herramienta| T[Subflujo: Start Tool]
    T -->|Ejecuta consulta en CRM o API| R[Return Tool Result]
    R -->|Devuelve los datos al Agente| A
    A -->|Responde con precision| F[Mensaje Claro al Usuario]

---

1. Agent Node (Asistente Autónomo)

El Agent Node es el cerebro más potente de Convoflow. A diferencia de un chatbot tradicional que sigue un guion fijo, este agente comprende el objetivo de la conversación, planifica sus acciones y puede consultar herramientas (como buscar citas, consultar inventario o calcular cotizaciones) de forma autónoma antes de responder.

¿Qué puedes modificar?

goalPromptstringrequerido

El objetivo principal e instrucciones de comportamiento para tu asistente:

• Quién es (rol y tono: formal, empático, directo).
• Qué información debe solicitar al usuario.
• Reglas de negocio que debe respetar en todo momento.
• Admite variables como {user_name} o {contexto_empresa}.

modelProviderstringdefecto: openrouter

El proveedor del modelo de IA (openrouter, openai, deepseek o groq). Consulta nuestra guía de Proveedores de inteligencia artificial para consultar la lista completa.

modelIdstringdefecto: openrouter/z-ai/glm-5.2

El modelo específico que procesará los mensajes (por ejemplo: claude-sonnet-4, gpt-5.4-mini, deepseek-v4-flash, gpt-oss-120b).

maxStepsnumberdefecto: 8

Número máximo de turnos o razonamientos que el agente puede dar antes de concluir su respuesta.

sendToUserbooleandefecto: true

Envía automáticamente el mensaje final producido por el asistente al chat del cliente.

outputVariablestringdefecto: agent_output

Variable donde se almacena el texto final de la respuesta generada.

---

2. Start Tool y Return Tool Result (herramientas visuales del agente)

Una de las mayores ventajas del Designer es que puedes darle "superpoderes" a tu Agente conectándole subflujos visuales:

¿Cómo se conectan en el lienzo?

1. En el nodo Agent, arrastra una línea desde el conector llamado tools hacia un nodo Start Tool.
2. Diseña los pasos que realiza la herramienta (por ejemplo: consultar una hoja de cálculo o una API).
3. Finaliza el subflujo conectándolo a un nodo Return Tool Result, que le entrega los datos de vuelta al Agente.

Mermaid

graph LR
    Agente((Agent)) -->|Conector 'tools'| ST[Start Tool]
    ST --> Accion[Consultar Pedido en Sistema]
    Accion --> RT[Return Tool Result]
    RT -->|Datos listos| Agente

Start Tool Node

Define el nombre y los datos que el Agente debe proporcionar para usar la herramienta:

toolNamestringrequerido

Identificador de la herramienta (por ejemplo: consultar_estado_pedido o calcular_envio).

toolDescriptionstringrequerido

Explicación breve de para qué sirve esta herramienta, para que la IA sepa exactamente cuándo debe llamarla.

---

Return Tool Result Node

Devuelve el resultado del subflujo al Agente para que formule su respuesta final:

resultExpressionstringopcional

El texto o variable que se enviará a la IA (por ejemplo: {resultado_pedido}).

---

3. Generate Node (generación rápida de texto)

Si solo necesitas una tarea rápida de Inteligencia Artificial (por ejemplo: resumir una conversación larga, traducir un texto o redactar una felicitación) sin la complejidad de un agente completo, usa el Generate Node.

promptstringrequerido

La instrucción directa a realizar (por ejemplo: Resume los siguientes puntos clave de la reunión: {notas_reunion}).

responseFormatenumdefecto: text

Formato de salida: text (texto normal) o json (datos estructurados).

outputVariablestringdefecto: ai_resultado

Variable donde se almacena el texto producido.