> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Descripción general del generador de Flow

> Convierte una llamada en un grafo de agentes, herramientas y decisiones

El generador de Flow es un lienzo visual donde diseñas una llamada como un **grafo**: los nodos hacen el trabajo y los bordes definen a dónde puede ir la conversación. Cada nodo Agente se ocupa de una parte de la conversación; un borde conduce al siguiente paso.

## Nodos y bordes

* Los **nodos** son pasos: saludar, conversar, decidir, llamar a una API, recopilar datos, transferir, finalizar.
* Los **bordes** son caminos posibles. Un nodo de agente con tres bordes de salida puede pasar la conversación a tres pasos siguientes distintos.
* **El asistente elige el camino** según la conversación y, sobre todo, tus **etiquetas de borde**.

## Empezar con una plantilla de caso de uso

Al crear un asistente con Flow conversacional, la galería ofrece planos completos para objetivos habituales, como recibir solicitudes de devolución de llamada, calificar leads, realizar encuestas, ofrecer experiencias de conserjería y atender desde un sitio web. Un plano puede incluir:

* un grafo de Flow listo para editar, un prompt base y un primer mensaje;
* el resultado esperado y las superficies compatibles, como telefonía entrante, telefonía saliente, voz web o avatar de IA;
* una lista de configuración para lo que todavía necesite el caso de uso, por ejemplo una base de conocimientos, un calendario, un destino de transferencia o un widget web.

Las insignias de la galería permiten comparar el tamaño del Flow, las superficies compatibles y la configuración necesaria antes de crear el asistente. Al aplicar una plantilla, el plano se copia al asistente nuevo. Es un punto de partida, no un enlace activo: los cambios posteriores de la plantilla no sobrescriben tu asistente.

<Note>
  Un plano **compatible con avatar** prepara la conversación para un avatar virtual que habla en la web. El avatar forma parte de la capa de presentación de la sesión web; no es un nodo del grafo de Flow. Después de crear el asistente, conéctalo a un widget web y elige allí el avatar virtual. La imagen que se muestra en la tarjeta de una plantilla o un asistente es solo un retrato y no activa un avatar animado.
</Note>

## Por qué importan las etiquetas de borde y de agente

Este es el concepto más importante del generador de Flow:

<Warning>
  **Las etiquetas de borde no son decoración.** El asistente usa cada etiqueta de salida para decidir hacia dónde dirigir la conversación. Las etiquetas vagas producen un enrutamiento impreciso.
</Warning>

Compara:

| Etiqueta débil | Etiqueta fuerte                                   |
| -------------- | ------------------------------------------------- |
| `next`         | `caller wants to book an appointment`             |
| `option 2`     | `caller asks about pricing or invoices`           |
| `transfer`     | `caller explicitly asks for a human, or is angry` |

Lo mismo ocurre con los nodos Condición: la **description** indica qué se está decidiendo y cada etiqueta describe un resultado posible. El asistente debe elegir exactamente un borde, así que las etiquetas deben ser mutuamente excluyentes y cubrir los casos esperados.

Los **nombres** de los nodos de agente también importan: aparecen en los traspasos y en los detalles de la llamada, así que `Qualification agent` es más claro que `Agent 2`.

## Un Flow mínimo y útil

```mermaid theme={null}
flowchart TD
  Start(["Inicio: saludo"]) --> Reception["Agente: Recepción"]
  Reception -->|"quien llama quiere una cita"| CollectName["Recopilar: nombre"]
  CollectName --> CollectPhone["Recopilar: teléfono"]
  CollectPhone --> EndA(["Fin: confirmar y despedida"])
  Reception -->|"quien llama tiene una pregunta de facturación"| Billing["Agente: FAQ de facturación"]
  Billing --> EndB(["Fin"])
  Reception -->|"quien llama pide hablar con una persona"| Warm["Transferencia cálida: +49..."]
  Warm --> EndC(["Fin"])
```

## Variables de Flow

Los nodos Recopilar y DTMF guardan sus resultados en **variables de Flow** (por ejemplo, `customer_phone`). Las variables se incluyen en el webhook público `call.completed` y en los detalles de la llamada, así que los sistemas conectados reciben datos estructurados, no solo una transcripción.

## Comportamiento de fallback

* Un nodo Agente con **instrucciones vacías** usa el Advanced prompt del asistente como base. Las instrucciones propias del nodo se añaden a esa base.
* Un nodo Recopilar que falla tras agotar sus reintentos toma el borde saliente etiquetado **Failed** si existe; si no, toma el borde normal.
* Si un paso del flow no puede ejecutarse, la llamada sigue la ruta alternativa disponible y el problema aparece en los detalles de la llamada.

Continúa con la [referencia de nodos](/es/flow-builder/nodes) y las [mejores prácticas](/es/flow-builder/best-practices). Para saber cuándo conviene un flow en lugar de un simple prompt, consulta [Prompt de sistema frente al generador de Flow](/es/assistants/overview).
