CCAR-F · Arquitectura agéntica
Qué recibe y qué devuelve un subagente
Un subagente existe para hacer trabajo pesado sin llenarle el contexto al coordinador. Para que eso funcione, importa tanto lo que recibe como lo que devuelve.
Lo que recibe
El subagente arranca con un contexto aislado (isolated context): no ve la conversación del coordinador. Todo lo que necesita tiene que ir en el pedido: el objetivo, lo que ya se sabe, qué falta y en qué formato devolver el resultado. Un pedido orientado a objetivos funciona mejor que una lista de pasos.
Si le pasás resultados de otros agentes (por ejemplo, búsquedas y análisis de documentos para que haga la síntesis), van completos y en un formato estructurado que separe el contenido de sus metadatos: URL, nombre del documento, número de página. Así el subagente no pierde la atribución (attribution) de cada dato y puede citar de dónde salió.
Lo que devuelve
Un resultado estructurado (structured result) y conciso: los hallazgos clave con sus referencias (archivo y línea, fuente y fecha) para poder verificarlos. Lo que no conviene:
- devolver la transcripción completa, porque le llena el contexto al coordinador;
- que el coordinador lea los archivos de trabajo del subagente, porque se saltea el resultado ordenado;
- cortar con
max_tokens, porque el resultado queda incompleto.
En paralelo o en secuencia
Si las tareas son independientes, el coordinador hace varias llamadas a la herramienta Task en una sola respuesta y corren en paralelo. Si una necesita el resultado de otra, van en secuencia. Para que el coordinador pueda delegar, Task tiene que estar en sus herramientas permitidas (allowedTools).
La definición del subagente
En el Agent SDK, cada subagente se describe con una definición de agente (AgentDefinition):
description: cuándo delegar en este subagente (la lee el coordinador para decidir);prompt: el system prompt del subagente;tools: qué herramientas puede usar.
En el examen
Si el problema es que el coordinador se queda sin espacio, la respuesta casi siempre es que el subagente devuelva menos y mejor ordenado, no que el coordinador lea más.
Pregunta rápida
Una pregunta del simulacro sobre este dominio. Cuenta para tu progreso.
A team at a travel booking company is deciding how to refactor its fare-search service. After a long analysis session in Claude Code, the developer used fork_session to create two branches from that shared baseline: one for a performance refactor and one for a readability refactor. Both branches work in the same local checkout of the repository.
In the performance branch, the agent rewrote the caching logic and edited 6 files on disk. The developer reviewed the diff and was happy with the direction.
The developer then switches to the readability branch to continue there, planning to compare both results at the end of the week. The readability branch read those same 6 files during the original analysis.
What is the main risk?