> 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/recursos/examples.md).

# Consejos y trucos

Supera cuellos de botella y aprende sobre las funciones del flujo de trabajo mediante ejemplos de código reales

### ¿Demasiados nodos?

Cuando trabajas con muchos nodos, bucles o ramas, los nodos siempre se registran en el flujo de trabajo como una lista plana. Tener demasiados nodos puede dificultar seguir visualmente el flujo de ejecución y concentrarse en una parte concreta del flujo de trabajo para realizar cambios o desarrollar algo nuevo.

En lugar de un array plano de 20 nodos, divídelo en secciones lógicas:

```php
 class MyWorkflow extends Workflow
 {
     ... 
    protected function nodes(): array
    {
        return [
            ...$this->classificationProcess(),
            ...$this->analysis(),
            ...$this->postProcessing(),
        ];
    }
    
    /**
     * Proceso inicial de clasificación
     */
    protected function classificationProcess(): array
    {
        return [
            // Nodes here...
        ];
    }
}
```

El operador de expansión (...) mantiene idéntico el comportamiento en tiempo de ejecución. Sigue siendo un array plano. Pero ahora el\
`nodes()` método se lee como un índice, y cada grupo se explica por sí mismo.

## Proyectos de ejemplo

### AIForm - Recopilación conversacional de datos

AIForm es un componente para recopilar datos estructurados mediante conversaciones en lenguaje natural de múltiples turnos. Utiliza un agente de IA para reunir progresivamente la información definida por una clase de salida estructurada, validando cada dato a lo largo del proceso.

El formulario mantiene el historial de la conversación, rastrea los campos recopilados, los campos faltantes y los errores de validación a lo largo de múltiples turnos.

<a href="https://github.com/neuron-core/ai-form" class="button secondary" data-icon="github">Consulta el repositorio de GitHub</a>

### Agente de investigación profunda

Este proyecto está inspirado en Open Deep Research, que utiliza LangGraph para su implementación. También existen otras implementaciones para llamaindex y otras. Nuestra versión aprovecha Neuron para crear un flujo de trabajo potente y modular para investigación y análisis.

Neuron Open Deep Research ofrece un enfoque estructurado para generar informes de investigación completos sobre cualquier tema utilizando modelos de lenguaje grandes, con un enfoque en la modularidad, la extensibilidad y los resultados en tiempo real.

#### Arquitectura

**DeepResearchAgent**: Orquesta el proceso general de generación del informe

* **Planificación**: Crea la estructura del informe
* **GenerateSectionContent**: Genera contenido para cada sección usando resultados de búsqueda
* **Formato**: Compila el informe final

**SearchWorkflow**: Gestiona las operaciones de búsqueda como un flujo de trabajo anidado

* **GenerateQueries**: Crea consultas de búsqueda basadas en los temas de la sección
* **SearchTheWeb**: Ejecuta búsquedas en paralelo y procesa los resultados

<a href="https://github.com/neuron-core/deep-research-agent" class="button secondary" data-icon="github">Consulta el repositorio de GitHub</a>

### Agente planificador de viajes

Este proyecto demuestra cómo crear un planificador de viajes usando el framework Neuron PHP para aplicaciones agénticas.

Tecnologías utilizadas:

* Neuron Workflow para la orquestación multiagente.
* [SerpAPI](https://serpapi.com/) para encontrar hoteles, vuelos y lugares para visitar informes de investigación exhaustivos sobre cualquier tema utilizando modelos de lenguaje grandes, con un enfoque en la modularidad, la extensibilidad y los resultados en tiempo real.

#### Arquitectura

**TravelPlannerAgent**: Orquesta el proceso general de generación del itinerario

#### Nodos

* **Recepcionista**: Recopila toda la información del usuario
* **Delegador**: Genera informes individuales sobre vuelos, hoteles y lugares para visitar
  * *Vuelos*
  * *Hoteles*
  * *Lugares*
* **GenerateItinerary**: Genera el informe final

<a href="https://github.com/neuron-core/travel-planner-agent" class="button secondary" data-icon="github">Consulta el repositorio de GitHub</a>

### Agente de viajes para Laravel

Este proyecto demuestra cómo integrar flujos de trabajo multiagente en una aplicación Laravel usando el framework de IA Neuron PHP.

Tecnologías utilizadas:

* [Laravel](https://laravel.com/) y [Livewire](https://livewire.laravel.com/) para la aplicación.
* [Neuron Workflow](https://docs.neuron-ai.dev/workflow/getting-started) para la orquestación multiagente.
* [SerpAPI](https://serpapi.com/) para encontrar hoteles, vuelos y lugares para visitar informes de investigación exhaustivos sobre cualquier tema utilizando modelos de lenguaje grandes, con un enfoque en la modularidad, la extensibilidad y los resultados en tiempo real.

<figure><img src="https://content.gitbook.com/content/GHx4l2LknIex7vFIUg1R/blobs/EKh727BovIG1YXS5MQWw/laravel-travel-planner-ai-agent.png" alt=""><figcaption></figcaption></figure>

#### Cómo usar este proyecto

Descarga el proyecto en tu máquina y abre la terminal en el directorio del proyecto. Primero, instala las dependencias de Composer:

```bash
composer install

npm run build

php artisan migrate
```

Crea una `.env` archivo en la raíz de tu proyecto (consulta `.env.example` para una plantilla), y proporciona las claves API según el servicio con el que quieras conectarte.

```
# Al menos una requerida
ANTHROPIC_API_KEY=
GEMINI_API_KEY=
OPENAI_API_KEY=

#Requerido
SERPAPI_KEY=

# Opcional
INSPECTOR_INGESTION_KEY=
INSPECTOR_TRANSPORT=sync
```

Abre el proyecto en tu navegador, regístrate para obtener una cuenta y empieza a planificar tu viaje.
