Was this page helpful?
Las habilidades son recursos reutilizables basados en el sistema de archivos que dan a tu agente experiencia específica del dominio: flujos de trabajo, contexto y mejores prácticas que convierten un agente de propósito general en un especialista. A diferencia de los prompts (instrucciones a nivel de conversación para tareas puntuales), las habilidades se cargan bajo demanda, impactando la ventana de contexto solo cuando es necesario.
Se admiten dos tipos de habilidad. Ambos funcionan de la misma manera: tu agente las invoca automáticamente cuando son relevantes para la tarea.
Para aprender cómo crear habilidades personalizadas, consulta la descripción general de Agent Skills y mejores prácticas. Esta página asume que ya tienes habilidades disponibles en tu organización o estás usando habilidades preintegradas de Anthropic.
Todas las solicitudes de la API de Managed Agents requieren el encabezado beta managed-agents-2026-04-01. El SDK establece el encabezado beta automáticamente.
Adjunta habilidades al crear un agente. Se admite un máximo de 20 habilidades por sesión - esto incluye habilidades en todos los agentes de la sesión, si estás trabajando con múltiples agentes.
agent=$(curl -sS https://api.anthropic.com/v1/agents \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: managed-agents-2026-04-01" \
--json @- <<'EOF'
{
"name": "Financial Analyst",
"model": "claude-sonnet-4-6",
"system": "You are a financial analysis agent.",
"skills": [
{"type": "anthropic", "skill_id": "xlsx"},
{"type": "custom", "skill_id": "skill_abc123", "version": "latest"}
]
}
EOF
)| Campo | Descripción |
|---|---|
type | Ya sea anthropic para habilidades preintegradas o custom para habilidades creadas por la organización. |
skill_id | El identificador de la habilidad. Para habilidades de Anthropic, usa el nombre corto (por ejemplo, xlsx). Para habilidades personalizadas, usa el ID skill_* devuelto en la creación. |
version | Solo habilidades personalizadas. Fija una versión específica o usa latest. |