Orquestación y subagentes
la orquestador es lo que convierte un mensaje entrante en una respuesta. Ensambla un aviso del sistema en capas y dirige un bucle de llamadas a funciones: el modelo piensa, llama a herramientas, lee los resultados y repite hasta que produce una respuesta final. Encima de este ciclo, un agente puede generarse subagentes y aplicar opcional estrategias de razonamiento — todo lo cual puede ser configurado por el administrador.
El bucle de giro
Un turno es un bucle de llamadas a funciones acotado. Al modelo se le da el aviso del sistema, la conversación y las herramientas disponibles; puede llamar a una o más herramientas, el orquestador las ejecuta y devuelve los resultados, y el bucle continúa hasta que el modelo devuelve un mensaje final. Las herramientas, la memoria y el conocimiento siempre llegan como resultados de la herramienta, nunca como instrucciones inyectadas: esto es lo que mantiene al bucle resistente a la inyección de indicaciones.
prompt + tools ─▶ model ─▶ tool calls ─▶ results ─▶ model ─▶ ... ─▶ final replySubagentes
Un agente puede generar subagentes manejar una sub-tarea y devolver un resultado al llamador. Esto permite que un agente coordinador delegue trabajo enfocado — investigación, redacción, una búsqueda especializada — sin sobrecargar un único contexto.
La recursión está limitada: la profundidad máxima de anidamiento está controlada por AIHUMMER_SUBAGENT_MAX_DEPTH. Esto previene la aparición descontrolada y mantiene predecibles el costo y la latencia de un turno.
[!WARNING] Los subagentes multiplican el trabajo. Mantener
AIHUMMER_SUBAGENT_MAX_DEPTHconservador en anfitriones compartidos — cada nivel extra de profundidad puede multiplicar las llamadas a herramientas y el modelo uso.
Estrategias de razonamiento
Más allá del bucle simple, el orquestador ofrece opciones estrategias de razonamiento. Están desactivados a menos que se habiliten, y cada uno es configurable desde la interfaz de administración en Agente · Razonamiento grupo de configuración.
| Estrategia | Lo que hace |
|---|---|
| Pasos del plan | El agente redacta un plan antes de actuar, luego sigue los pasos. |
| Reflejar | El agente critica y revisa su propio borrador antes de responder. |
| Debate | N los agentes discuten a lo largo de varios rondas, luego un juez elige al ganador. |
| Mejor de N | Genera varias respuestas candidatas y selecciona la mejor. |
| Auto-sanarse | En caso de fallo, el agente diagnostica y reintenta en lugar de rendirse. |
[!TIP] Las estrategias de razonamiento intercambian latencia y costo de tokens por calidad. Actívalas selectivamente para los agentes y tareas que los necesitan en lugar de globalmente.
Gráficos de agentes
Para flujos de trabajo de múltiples agentes que son más estructurados que las llamadas ad-hoc a subagentes, AiHummer soporta gráficos de agentes — conexión explícita de agentes en un flujo de trabajo. Los gráficos se gestionan desde la interfaz de administración y la API de administración bajo /v1/admin/graphs/*.
La interfaz de administrador Gráficos la página es visual editor de diagramas de flujo: los nodos del grafo se arrastran por un lienzo, las conexiones entre ellos se dibujan como flechas, una paleta agrega nuevos nodos y un panel lateral edita los parámetros del nodo seleccionado. La definición del grafo (nodo inicial, límite de pasos, nodos y transiciones) se almacena como JSON: el interruptor “Exportar/Importar JSON” lo abre para inspección, transferencia entre instancias y edición manual.
Resumen de configuración
| Perilla | Dónde |
|---|---|
| Profundidad máxima del subagente | AIHUMMER_SUBAGENT_MAX_DEPTH (env; recargable en caliente) |
| Estrategias de razonamiento | Grupo de configuración Agente · Razonamiento |
| Gráficos de agentes | /v1/admin/graphs/* |
[!NOTE] La profundidad del subagente y la habilitación de herramientas están entre los ajustes que se aplican caliente (sin reinicio). Otros ajustes pueden requerir un reinicio — consulte la configuración modelo en la guía de inicio.
¿A dónde vamos ahora?
- Mira lo que puede llamar el bucle Herramientas.
- Aprende cómo un mensaje elige su agente inicial en Enrutamiento.
- Configure los propios agentes en Agentes y personas.