این بخش در docs رسمی Anthropic با عنوان Claude Managed Agents و Tool Runner (SDK) توضیح داده میشود و برای وقتی است که output سادهی مدل کافی نیست و باید رفتار agent را کنترل کنی.
Agent SDK
Claude Managed Agents لایهی رسمی Anthropic برای ساخت agentهای چندمرحلهای است؛ جایی که session، toolها، فایلها و human review کنار هم قرار میگیرند.
agent orchestration و sessionهای مدیریتشده
تعریف و شروع
شروع سریع
اول یک agent ساده با Managed Agents بساز، بعد اگر لازم شد tool و review را اضافه کن.
- Anthropic Console account
- API key
- یک task چندمرحلهای واقعی
با یک task کوچک مثل خلاصهکردن repo، تولید checklist یا اجرای یک workflow محدود شروع کن و بعد session و toolها را اضافه کن.
قابلیتهای اصلی
Managed sessions
اجرای طولانیمدت و قابلردیابی برای agentها.
Tools
اتصال ابزارها و workflowهای بیرونی به agent.
File-aware work
خواندن و دستکاری فایلها در یک session کنترلشده.
Human review
جایی برای بررسی انسانی و بازبینی قبل از تصمیم نهایی.
این بخش را کی انتخاب کنیم
Messages API
برای درخواست و پاسخ رسمی، state و کنترل خروجی از Messages API شروع کن.
Tool Use
وقتی خروجی Claude باید به tool یا action واقعی وصل شود، Tool Use را روی همین لایه اضافه کن.
Console
Console برای راهاندازی، key management و کنترل استفادهٔ تیمی است.
نصب و شروع عملی
شروع سریع
اول یک agent ساده با Managed Agents بساز، بعد اگر لازم شد tool و review را اضافه کن.
- Anthropic Console account
- API key
- یک task چندمرحلهای واقعی
با یک task کوچک مثل خلاصهکردن repo، تولید checklist یا اجرای یک workflow محدود شروع کن و بعد session و toolها را اضافه کن.
مثال واقعی
Agent SDK
agent orchestration و sessionهای مدیریتشده
- وقتی task چندمرحلهای است و state مهم است.
- وقتی tool use و review انسانی باید در یک flow رسمی کنار هم باشند.
- وقتی میخواهی agent را با Claude Code یا API فقط بهصورت یک layer بالاتر ببینی.
Claude Managed Agents لایهی رسمی Anthropic برای ساخت agentهای چندمرحلهای است؛ جایی که session، toolها، فایلها و human review کنار هم قرار میگیرند.
اشتباهات رایج
مرز محصول و API را روشن نگه دار
این component یک لایه مشخص در اکوسیستم است، نه کل اکوسیستم.
اول یک workflow کوچک بساز
بهجای مسیرهای پیچیده، با یک task کوچک و واقعی شروع کن.
لینک رسمی را جایگزین implementation نکن
docs مرجع هستند، اما باید در محصول خودت هم تست شوند.