Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
스킬은 에이전트에 도메인별 전문성을 제공하는 재사용 가능한 파일시스템 기반 리소스입니다: 범용 에이전트를 전문가로 변환하는 워크플로우, 컨텍스트 및 모범 사례입니다. 프롬프트(일회성 작업을 위한 대화 수준의 지시사항)와 달리 스킬은 필요할 때만 로드되므로 필요할 때만 컨텍스트 윈도우에 영향을 미칩니다.
두 가지 유형의 스킬이 지원됩니다. 둘 다 동일한 방식으로 작동합니다: 에이전트가 작업과 관련이 있을 때 자동으로 호출합니다.
사용자 정의 스킬을 작성하는 방법을 알아보려면 에이전트 스킬 개요 및 모범 사례를 참조하세요. 이 페이지에서는 조직에서 이미 사용 가능한 스킬이 있거나 Anthropic 사전 구축 스킬을 사용하고 있다고 가정합니다.
모든 Managed Agents API 요청에는 managed-agents-2026-04-01 베타 헤더가 필요합니다. SDK는 베타 헤더를 자동으로 설정합니다.
에이전트를 생성할 때 스킬을 연결합니다. 세션당 최대 20개의 스킬이 지원됩니다. 여러 에이전트로 작업하는 경우 세션의 모든 에이전트에 걸친 스킬을 포함합니다(다중 에이전트 참조).
agent = client.beta.agents.create(
name="Financial Analyst",
model="claude-opus-4-7",
system="You are a financial analysis agent.",
skills=[
{
"type": "anthropic",
"skill_id": "xlsx",
},
{
"type": "custom",
"skill_id": "skill_abc123",
"version": "latest",
},
],
)| 필드 | 설명 |
|---|---|
type | 사전 구축된 스킬의 경우 anthropic, 조직에서 작성한 스킬의 경우 custom입니다. |
skill_id | 스킬 식별자입니다. Anthropic 스킬의 경우 짧은 이름을 사용합니다(예: xlsx). 사용자 정의 스킬의 경우 생성 시 반환된 skill_* ID를 사용합니다. |
version | 사용자 정의 스킬만 해당합니다. 특정 버전으로 고정하거나 latest를 사용합니다. |
Was this page helpful?