> For the complete documentation index, see [llms.txt](https://docs.neuron-ai.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neuron-ai.dev/neuron-v3-es/flujo-de-trabajo/getting-started.md).

# Primeros pasos

Guía, modera y controla tu sistema multiagente con intervención humana.

{% hint style="warning" %}

#### Habilidad del agente de programación

Usa **`/neuron-workflow`** para enseñarle a tu agente de programación cómo implementar Workflow agéntico en tu aplicación. Desde procesos lineales simples hasta bucles complejos con interrupción y funciones duraderas.

[Desarrollo asistido por IA](https://docs.neuron-ai.dev/neuron-v3-es/resumen/agentic-development.md)
{% endhint %}

### Qué es un Workflow

Un workflow es una forma basada en eventos y nodos de controlar el flujo de ejecución de una aplicación.

Tu aplicación se divide en secciones llamadas nodos, que son activados por eventos y, a su vez, devuelven eventos que activan más nodos. Al combinar nodos y eventos, puedes crear flujos arbitrariamente complejos que encapsulan la lógica y hacen que tu aplicación sea más mantenible y fácil de entender.

Un nodo puede ser cualquier cosa, desde una sola línea de código hasta un agente complejo. Puede tener entradas y salidas arbitrarias, que se transmiten mediante eventos. Es como n8n a nivel de código.

<figure><img src="https://4076695836-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGHx4l2LknIex7vFIUg1R%2Fuploads%2FX8gk7EUo9yJ3bglyhSqr%2Fworkflow-single-step.png?alt=media&amp;token=fc287a43-a099-4f1f-ab66-77f6150d779d" alt=""><figcaption></figcaption></figure>

Workflow te permite usar todos los componentes de Neuron, como proveedores de IA, embeddings, cargadores de datos, historial de chat, almacén vectorial, etc., como componentes independientes para crear entidades agénticas totalmente personalizadas.

Las clases Agent y RAG son workflows en sí mismas. Representan implementaciones listas para usar de los patrones más comunes cuando se trata de llamadas a herramientas, recuperación, salida estructurada, etc. Workflow te permite programar tu sistema agéntico completamente desde cero. Agent y RAG pueden usarse dentro de un Workflow para completar tareas como cualquier otro componente si necesitas realizar operaciones de IA durante la ejecución.

Lo que hace especial a Neuron Workflow es su **transmisión** y **interrupción** capacidades. Esto significa que tu sistema multiagente puede transmitir actualizaciones directamente a los clientes, pausar a mitad del proceso, pedir entrada humana, esperar retroalimentación y luego continuar exactamente donde lo dejó, incluso si eso ocurre horas o días después.

### ¿Por qué usar workflows en lugar de scripts normales?

Quizá estés pensando: "Suena genial, pero ¿por qué no puedo simplemente escribir un script PHP normal con algunos if y funciones?" Es una buena pregunta, y una que escuché mucho mientras construía Neuron. La respuesta se vuelve clara cuando consideras lo que ocurre cuando tu proceso necesita atravesar múltiples ramas, ejecutarlas en paralelo, implementar varios bucles y puntos de control intermedios, transmitir actualizaciones en tiempo real al cliente, o incluso pausar, esperar y reanudar.

Cuando estás empezando y tu caso de uso todavía es bastante simple, quizá no veas el verdadero potencial de Workflow, y es normal. Ten en cuenta que, si las cosas se ponen feas, Neuron ya cuenta con la arquitectura adecuada para ayudarte a escalar a cualquier nivel.

### Beneficios para el desarrollo

Desde la perspectiva de un desarrollador, los workflows resuelven varios problemas dolorosos:

**Modelar y mantener escenarios complejos**: Con estos bloques de construcción simples podrás crear procesos sencillos con unos pocos pasos, hasta flujos de trabajo complejos con bucles iterativos y puntos de control intermedios.

**Humano en el circuito**: Incorpora sin problemas la supervisión humana. Puedes desplegar IA en áreas sensibles porque los humanos siempre están en el circuito para las decisiones críticas.

**Transmisión**: Puedes enviar actualizaciones en tiempo real al cliente durante la ejecución del flujo de trabajo.

**Depuración con inspector**: En lugar de preguntarte por qué tu flujo de trabajo tomó una decisión particular, puedes ver exactamente qué está ocurriendo en cualquier nodo.

### Monitoreo y depuración

Muchas de las aplicaciones que construyas con Neuron contendrán múltiples pasos con múltiples invocaciones de llamadas a LLM. A medida que estas aplicaciones se vuelven cada vez más complejas, resulta crucial poder inspeccionar exactamente qué está ocurriendo dentro de tu sistema agéntico. La mejor manera de hacerlo es con [Inspector](https://inspector.dev/).

{% embed url="<https://docs.inspector.dev/guides/neuron-ai>" %}
