Saltar al contenido
PentAGI
Conceptos

Agents

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

Un flow es ejecutado por un equipo de agents. Cada agent type tiene su propio prompt, configuración de modelo y tools, por lo que puedes asignar modelos más potentes o más económicos según el rol.

Agent types

AgentRol
primary_agentAgent de razonamiento principal que dirige un flow
assistantModo de assistant interactivo
generatorDivide cada task en subtasks
refinerEl agent refiner refina el plan a medida que llegan los resultados
adviserEl agent adviser ofrece asesoramiento experto; mentor en la supervisión de ejecución y planificador en la planificación de task
reflectorEl agent reflector corrige a los agents que dejan de generar tool calls
searcherEl agent searcher realiza recopilación de información y búsqueda web
enricherEl agent enricher recopila contexto adicional de la memory y el sandbox antes de que el adviser responda
coderEl agent coder escribe y analiza código
installerEl agent installer instala y configura tools en el sandbox
pentesterEl agent pentester realiza pentest y evaluación de seguridad
simple, simple_jsonCompletados 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

How a task is split into subtasks and the primary agent delegates each step to specialist agents through shared memoryVector storeSpecialistsMemoristPrimary agentGeneratorVector storeSpecialistsMemoristPrimary agentGeneratorSubtasks of the taskPast work, when the context lacks itSearch memoryDelegate a step to the searcher, pentester, coder or installerStore tool resultsResult

Salvaguardas

  • 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.

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.

Última actualización el