Subagentes en el SDK

import { query } from '@anthropic-ai/claude-agent-sdk';

const result = query({
  prompt: "Revisa el módulo de autenticación para problemas de seguridad",
  options: {
    agents: {
      'code-reviewer': {
        description: 'Especialista experto en revisión de código. Usar para revisiones de calidad, seguridad y mantenibilidad.',
        prompt: `Eres un especialista en revisión de código con experiencia en seguridad, rendimiento y mejores prácticas.

Al revisar código:
- Identifica vulnerabilidades de seguridad
- Verifica problemas de rendimiento
- Verifica adherencia a estándares de codificación
- Sugiere mejoras específicas

Sé exhaustivo pero conciso en tu retroalimentación.`,
        tools: ['Read', 'Grep', 'Glob'],
        model: 'sonnet'
      },
      'test-runner': {
        description: 'Ejecuta y analiza suites de pruebas. Usar para ejecución de pruebas y análisis de cobertura.',
        prompt: `Eres un especialista en ejecución de pruebas. Ejecuta pruebas y proporciona análisis claro de resultados.

Enfócate en:
- Ejecutar comandos de prueba
- Analizar salida de pruebas
- Identificar pruebas fallidas
- Sugerir correcciones para fallas`,
        tools: ['Bash', 'Read', 'Grep'],
      }
    }
  }
});

for await (const message of result) {
  console.log(message);
}

Campo	Tipo	Requerido	Descripción
`description`	`string`	Sí	Descripción en lenguaje natural de cuándo usar este agente
`prompt`	`string`	Sí	El prompt del sistema del agente definiendo su rol y comportamiento
`tools`	`string[]`	No	Array de nombres de herramientas permitidas. Si se omite, hereda todas las herramientas
`model`	`'sonnet' \| 'opus' \| 'haiku' \| 'inherit'`	No	Anulación de modelo para este agente. Por defecto usa el modelo principal si se omite

---
name: code-reviewer
description: Especialista experto en revisión de código. Usar para revisiones de calidad, seguridad y mantenibilidad.
tools: Read, Grep, Glob, Bash
---

El prompt del sistema de tu subagente va aquí. Esto define el rol del subagente,
capacidades y enfoque para resolver problemas.

const result = query({
  prompt: "Optimiza las consultas de base de datos en la capa API",
  options: {
    agents: {
      'performance-optimizer': {
        description: 'Usar PROACTIVAMENTE cuando los cambios de código puedan impactar el rendimiento. DEBE USARSE para tareas de optimización.',
        prompt: 'Eres un especialista en optimización de rendimiento...',
        tools: ['Read', 'Edit', 'Bash', 'Grep'],
        model: 'sonnet'
      }
    }
  }
});

const result = query({
  prompt: "Usa el agente code-reviewer para verificar el módulo de autenticación",
  options: {
    agents: {
      'code-reviewer': {
        description: 'Especialista experto en revisión de código',
        prompt: 'Eres un revisor de código enfocado en seguridad...',
        tools: ['Read', 'Grep', 'Glob']
      }
    }
  }
});

import { query, type AgentDefinition } from '@anthropic-ai/claude-agent-sdk';

function createSecurityAgent(securityLevel: 'basic' | 'strict'): AgentDefinition {
  return {
    description: 'Revisor de código de seguridad',
    prompt: `Eres un revisor de seguridad ${securityLevel === 'strict' ? 'estricto' : 'equilibrado'}...`,
    tools: ['Read', 'Grep', 'Glob'],
    model: securityLevel === 'strict' ? 'opus' : 'sonnet'
  };
}

const result = query({
  prompt: "Revisa este PR para problemas de seguridad",
  options: {
    agents: {
      'security-reviewer': createSecurityAgent('strict')
    }
  }
});

const result = query({
  prompt: "Analiza la arquitectura de esta base de código",
  options: {
    agents: {
      'code-analyzer': {
        description: 'Análisis estático de código y revisión de arquitectura',
        prompt: `Eres un analista de arquitectura de código. Analiza la estructura del código,
identifica patrones y sugiere mejoras sin hacer cambios.`,
        tools: ['Read', 'Grep', 'Glob']  // Sin permisos de escritura o ejecución
      }
    }
  }
});

Subagentes en el SDK

Descripción General

Beneficios de Usar Subagentes

Gestión de Contexto

Subagentes en el SDK

Descripción General

Beneficios de Usar Subagentes

Gestión de Contexto

Paralelización

Instrucciones y Conocimiento Especializados

Restricciones de Herramientas

Creando Subagentes

Definición Programática (Recomendada)

Configuración de AgentDefinition

Definición Basada en Sistema de Archivos (Alternativa)

Cómo el SDK Usa Subagentes

Subagentes de Ejemplo

Patrones de Integración del SDK

Invocación Automática

Invocación Explícita

Configuración Dinámica de Agentes

Restricciones de Herramientas

Combinaciones Comunes de Herramientas

Documentación Relacionada