# Agents

> Los agents especializados detrás de un flow y las salvaguardas que los mantienen en el camino correcto.

Un [flow](https://pentagi.com/es/docs/glossary/#flow) es ejecutado por un equipo de [agents](https://pentagi.com/es/docs/glossary/#agent). Cada [agent type](https://pentagi.com/es/docs/glossary/#agent-type) tiene su propio prompt, configuración de modelo y [tools](https://pentagi.com/es/docs/glossary/#tool), por lo que puedes asignar modelos más potentes o más económicos según el rol.

## [Agent types](https://pentagi.com/es/docs/concepts/agents/#agent-types)

| Agent                   | Rol                                                                                                                                                           |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `primary_agent`         | Agent de razonamiento principal que dirige un flow                                                                                                            |
| `assistant`             | Modo de [assistant](https://pentagi.com/es/docs/glossary/#assistant) interactivo                                                                                                    |
| `generator`             | Divide cada [task](https://pentagi.com/es/docs/glossary/#task) en [subtasks](https://pentagi.com/es/docs/glossary/#subtask)                                                                               |
| `refiner`               | El agent refiner refina el plan a medida que llegan los resultados                                                                                            |
| `adviser`               | El agent adviser ofrece asesoramiento experto; mentor en la supervisión de ejecución y planificador en la planificación de task                               |
| `reflector`             | El agent reflector corrige a los agents que dejan de generar [tool calls](https://pentagi.com/es/docs/glossary/#tool-call)                                                          |
| `searcher`              | El agent searcher realiza recopilación de información y búsqueda web                                                                                          |
| `enricher`              | El agent enricher recopila contexto adicional de la [memory](https://pentagi.com/es/docs/glossary/#memory) y el [sandbox](https://pentagi.com/es/docs/glossary/#sandbox) antes de que el adviser responda |
| `coder`                 | El agent coder escribe y analiza código                                                                                                                       |
| `installer`             | El agent installer instala y configura tools en el sandbox                                                                                                    |
| `pentester`             | El agent pentester realiza [pentest](https://pentagi.com/es/docs/glossary/#pentest) y evaluación de seguridad                                                                       |
| `simple`, `simple_json` | Completados en texto plano y estructurados en JSON                                                                                                            |

Dos agents más trabajan entre bastidores: el agent `memorist` responde a las preguntas de otros agents sobre trabajos anteriores desde la memory a largo plazo, y el agent `reporter` redacta el resultado de cada task.

## [Cómo se delega el trabajo](https://pentagi.com/es/docs/concepts/agents/#how-work-is-delegated)

```mermaid
sequenceDiagram
  accTitle: How a task is split into subtasks and the primary agent delegates each step to specialist agents through shared memory
  participant G as Generator
  participant O as Primary agent
  participant M as Memorist
  participant S as Specialists
  participant V as Vector store
  G->>O: Subtasks of the task
  O->>M: Past work, when the context lacks it
  M->>V: Search memory
  O->>S: Delegate a step to the searcher, pentester, coder or installer
  S->>V: Store tool results
  S-->>O: Result
```

## [Salvaguardas](https://pentagi.com/es/docs/concepts/agents/#safeguards)

* **Límites de tool call** (siempre activo) — `MAX_GENERAL_AGENT_TOOL_CALLS` (por defecto 100) limita los turnos del modelo en las cadenas de `primary_agent`, `assistant`, `pentester`, `coder` y `installer`, y `MAX_LIMITED_AGENT_TOOL_CALLS` (por defecto 20) los limita para los demás agents. Un turno puede invocar varias tools. Los valores de 1 a 5 se elevan a 6, y 0 o menos significa el valor por defecto.
* **Detección de repeticiones** (siempre activado) — a partir de la tercera llamada consecutiva a la misma tool con los mismos argumentos, la tool no se ejecuta de nuevo: el agent recibe la respuesta anterior junto con una solicitud para cambiar de rumbo. La séptima llamada de este tipo finaliza la cadena.
* **Reflector** (siempre activo) — el agent reflector interviene la primera vez que un modelo responde sin una tool call y guía al agent para que realice una; después de tres intentos fallidos, la cadena se detiene.
* **Supervisión de ejecución** (beta, `EXECUTION_MONITOR_ENABLED`) — para `primary_agent`, `pentester`, `coder`, `installer` y `assistant` cuando trabaja con agents, el adviser actúa como mentor cuando el agent llama a la misma tool `EXECUTION_MONITOR_SAME_TOOL_LIMIT` veces seguidas (por defecto 5) o realiza `EXECUTION_MONITOR_TOTAL_TOOL_LIMIT` tool calls desde el último consejo (por defecto 10). El desencadenante cuenta las llamadas en lugar de detectar un estancamiento; el adviser entonces revisa el progreso del agent y recomienda si continuar, cambiar de enfoque o detenerse.
* **Planificación inteligente de task** (beta, `AGENT_PLANNING_STEP_ENABLED`) — el agent adviser elabora de 3 a 7 pasos concretos antes de que los especialistas inicien una subtask.

> [!NOTE]
> La supervisión de ejecución y la planificación de task duplican aproximadamente la calidad de los resultados en modelos de menos de 32B parámetros, a costa de consumir entre 2 y 3 veces más tokens y tiempo. Están desactivadas por defecto.

En Enterprise, el planner siempre se ejecuta y la supervisión de ejecución está activada por defecto con límites de 20 y 40 — consulta [Agent profiles](https://pentagi.com/es/docs/enterprise/agent-profiles/#planner-and-execution-monitor).