بتای Anthropic · بازبینی‌شده در 2026-10-20

راهنمای کامل Claude Managed Agents

Claude Managed Agents پلتفرم عامل هوش مصنوعی مدیریت‌شده‌ی Anthropic برای اجرای Claude به‌عنوان یک عامل خودمختار است: Anthropic حلقه عامل، اجرای ابزار و محیط اجرای سندباکس را فراهم می‌کند و شما رویدادها را برای آن می‌فرستید. مستندات رسمی در تاریخ 2026-10-20 هنوز آن را بتا علامت می‌زنند و هر نقطه پایانی به هدر بتای managed-agents-2026-04-01 نیاز دارد. این سرویس همچنین روی Claude Platform on AWS اجرا می‌شود، با برخی تفاوت‌ها در دسترس‌بودن قابلیت‌ها و رفتار نشست.

#ClaudeAgents #ManagedAgents #AI Agent #Anthropic

Claude Managed Agents چیست؟

جایگاه‌یابی رسمی: یک هارنس عامل از پیش ساخته‌شده و قابل‌پیکربندی در زیرساخت مدیریت‌شده، بهترین گزینه برای کارهای طولانی‌مدت و کارهای ناهمگام. این محصول پیرامون عامل (مدل، prompt سیستمی، ابزارها، سرورهای MCP، مهارت‌ها)، محیط (یک سندباکس ابری مدیریت‌شده توسط Anthropic یا یک سندباکس خودمیزبان)، نشست (یک نمونه در حال اجرای عامل) و رویدادها (پیام‌های میان برنامه شما و عامل) ساخته شده است. صفحه قیمت‌گذاری رسمی دو مورد را محاسبه می‌کند: توکن‌ها با نرخ‌های رسمی هر مدل (جست‌وجوهای وب درون یک نشست $10 به‌ازای هر 1,000 است) و زمان اجرای نشست با $0.08 به‌ازای هر ساعت نشست، که فقط هنگام در حال اجرا بودن نشست محاسبه می‌شود، نه هنگام بیکار بودن. Anthropic همچنین می‌گوید Managed Agents در حال حاضر واجد شرایط Zero Data Retention (ZDR) یا پوشش HIPAA BAA نیست.

اجرای عامل‌ها توسط خودتان چه هزینه‌ای دارد؟

✗صرف چرخه‌های توسعه برای ساخت زیرساخت سندباکس امن
✗پیاده‌سازی دستی مدیریت وضعیت و ماندگاری نشست
✗پیاده‌سازی دستی امنیت اعتبارنامه و جداسازی مجوزها
✗ساخت حلقه عامل، اجرای ابزار و محیط اجرای اختصاصی خودتان

Managed Agents چه کارهایی را بر عهده می‌گیرد؟

✓محیط اجرای کد سندباکس‌شده و آماده استفاده
✓checkpoint‌گیری خودکار و بازیابی نشست
✓مدیریت اعتبارنامه و کنترل مجوزهای محدوده‌دار تعبیه‌شده
✓حلقه عامل نگهداری‌شده توسط Anthropic با کش prompt و فشرده‌سازی داخلی

شش قابلیت اصلی

اجرای کد در سندباکس

کد عامل در یک سندباکس ایزوله اجرا می‌شود: ابزار bash تعبیه‌شده دستورها را اجرا می‌کند و عملیات فایل تعبیه‌شده خواندن، نوشتن، ویرایش، glob و grep را انجام می‌دهد، همگی خارج از سیستم میزبان.

checkpoint‌گیری

وضعیت اجرای عامل را به‌طور خودکار ذخیره می‌کند تا کارهای طولانی‌مدت بدون راه‌اندازی مجدد در هر نقطه متوقف و از سر گرفته شوند: وقتی یک نشست بیکار می‌شود، از سندباکس آن checkpoint گرفته می‌شود و سیستم فایل، بسته‌های نصب‌شده و فایل‌هایی که عامل ایجاد کرده است حفظ می‌شوند. وضعیت سندباکس به مدت 30 روز پس از ایجاد نگه داشته می‌شود.

مدیریت اعتبارنامه

کلیدهای API، توکن‌های OAuth و سایر اعتبارنامه‌های حساسی را که عامل‌ها به‌صورت درخواستی به آن‌ها دسترسی دارند، به‌طور امن ذخیره و تزریق می‌کند بدون آنکه متن ساده افشا شود: آن‌ها در یک گاوصندوق مدیریت‌شده قرار دارند و به‌صورت متغیرهای محیطی به عامل می‌رسند، سندباکس فقط یک نگه‌دارنده موقت دارد و کلید واقعی در مرز شبکه متصل می‌شود.

مجوزهای محدوده‌دار

کنترل مجوز ریزدانه — برای هر عامل یک مجموعه مجوز حداقلی پیکربندی کنید، مطابق اصل حداقل دسترسی. برای هر ابزار یک سیاست انتخاب می‌کنید: always_allow ابزار را اجرا می‌کند، always_ask منتظر تأیید شما می‌ماند، auto به سرور اجازه می‌دهد هر فراخوانی را داوری کند، و مجموعه ابزار عامل به‌طور پیش‌فرض always_allow است.

ردیابی سرتاسری

ردیابی کامل زنجیره اجرا — هر اقدام عامل قابل مشاهده، قابل حسابرسی و قابل بازپخش است: رویدادهایی که می‌فرستید از طریق SSE به‌صورت جریانی بازمی‌گردند، تاریخچه رویداد در سمت سرور ذخیره می‌شود و می‌توان آن را به‌طور کامل دریافت کرد. نقاط پایانی خواندن 1,200 درخواست در دقیقه و نقاط پایانی ایجاد 300 درخواست در دقیقه را مجاز می‌کنند؛ این شمارش بر حسب سازمان است.

استقرارهای زمان‌بندی‌شده

زیرساخت ابری میزبانی‌شده، بدون نیاز به عملیات زیرساخت: به یک عامل یک عبارت cron با دقت تا دقیقه بدهید تا نشست‌ها را طبق زمان‌بندی شروع کند، و هر اجرا یک نشست جدید باز می‌کند که کار را کامل می‌کند.

شروع سریع

شروع سریع رسمی به این ترتیب اجرا می‌شود: یک عامل ایجاد کنید (مدل، prompt سیستمی، ابزارها)، یک محیط ایجاد کنید (سندباکس و شبکه‌سازی)، یک نشست ایجاد کنید، سپس اولین رویداد را بفرستید. هر درخواست به هدر بتای managed-agents-2026-04-01 نیاز دارد.

Python Python SDK

# pip install anthropic

from

anthropic

import

Anthropic

client = Anthropic()

# ایجاد یک عامل (مدل، prompt سیستمی، ابزارها)

agent = client.beta.agents.create(

name="Coding Assistant",

model="claude-opus-5-5",

system="You are a helpful coding assistant. Write clean, well-documented code.",

tools=[{"type": "agent_toolset_20260401"}],

)

environment = client.beta.environments.create(

name="quickstart-env",

config={"type": "cloud", "networking": {"type": "limited", "allow_package_managers": True}},

)

# ایجاد یک نشست و ارسال اولین رویداد

session = client.beta.sessions.create(

agent=agent.id,

environment_id=environment.id,

)

client.beta.sessions.events.send(

session.id,

events=[{"type": "user.message", "content": [{"type": "text", "text": "..."}]}],

)

TypeScript SDK برای TypeScript

// npm install @anthropic-ai/sdk

import

Anthropic

from

'@anthropic-ai/sdk'

;

const client = new Anthropic();

// ایجاد یک عامل (مدل، prompt سیستمی، ابزارها)

const

agent =

await

client.beta.agents.create({

name: 'Coding Assistant',

model: 'claude-opus-5-5',

system: 'You are a helpful coding assistant. Write clean, well-documented code.',

tools: [{ type: 'agent_toolset_20260401' }]

});

const

environment =

await

client.beta.environments.create({

name: 'quickstart-env',

config: { type: 'cloud', networking: { type: 'limited', allow_package_managers: true } }

});

// ایجاد یک نشست و ارسال اولین رویداد

const

session =

await

client.beta.sessions.create({

agent: agent.id,

environment_id: environment.id

});

await

client.beta.sessions.events.send(session.id, {

events: [{ type: 'user.message', content: [{ type: 'text', text: '...' }] }]

});

کاربردهایی که Anthropic نام می‌برد

بلاگ Anthropic می‌گوید: Rakuten از استقرارهای زمان‌بندی‌شده برای تحلیل داده‌های صفحه‌گسترده و تولید گزارش‌ها و ارائه‌ها استفاده می‌کند و به مدیران محصول اجازه می‌دهد بدون داشبورد، لاگ‌ها و معیارهای محیط تولید را رصد کنند؛ Notion نیز از متغیرهای محیطی vault برای انتشار CLI خودش استفاده می‌کند.

Notion

Notion با استفاده از Managed Agents عامل‌هایی با قابلیت بارگذاری فایل می‌سازد و CLI خودش را همراه با ابزارهای MCP و با متغیرهای محیطی vault منتشر می‌کند، بدون اینکه هرگز توکن‌های API به مدل سپرده شوند.

Sentry

بلاگ رسمی، Sentry CLI را در میان CLIهایی فهرست می‌کند که می‌توانند با متغیرهای محیطی vault احراز هویت کنند: سندباکس فقط یک جای‌نگهدار دارد و کلید واقعی در مرز شبکه متصل می‌شود.

Rakuten

عامل‌هایی از طریق Managed Agents مستقر شدند: Rakuten از استقرارهای زمان‌بندی‌شده برای تحلیل داده‌های صفحه‌گسترده و تولید گزارش‌ها و ارائه‌ها با برنامه هفتگی یا ماهانه استفاده می‌کند.

Managed Agents و QCode.cc

QCode.cc پروتکل API Anthropic را پیاده‌سازی می‌کند؛ نقاط پایانی بتای Managed Agents برای عامل‌ها و نشست‌ها توسط خود Anthropic میزبانی می‌شوند، به هدر بتای managed-agents-2026-04-01 نیاز دارند و نقطه ورود، API خود Anthropic است. QCode.cc مدل‌های Claude را روی پروتکل Anthropic Messages ارائه می‌دهد — claude-opus-5-5 و claude-sonnet-5 قابل فراخوانی هستند — با صورت‌حساب بر اساس توکن، و قیمت هر مدل در /models است.

# Base URL مربوط به SDK را روی QCode.cc تنظیم کنید.

import anthropic

client = anthropic.Anthropic(

base_url="https://api.qcode.cc/api",

api_key="cr_xxxxxxxx",

)

# مدل‌های Claude از QCode.cc عبور می‌کنند؛ نقاط پایانی عامل و نشست در سمت Anthropic قرار دارند.

response = client.messages.create(

model="claude-opus-5-5",

max_tokens=1024,

messages=[{"role": "user", "content": "..."}],

)

منابع مرتبط

Claude Agent SDK ←

راهنمای توسعه‌دهنده برای ساخت عامل‌های سفارشی هوش مصنوعی با Agent SDK

راهنمای برنامه‌نویسی چندعامله ←

الگوهای برنامه‌نویسی چندعامله و همکاری Agent Teams را بیاموزید

راهنمای کامل Claude Code ←

راهنمای کامل ابزار CLI Claude Code همراه با نکات پیشرفته

برنامه شرکای QCode ←

استخر اعتبار پیش‌پرداخت · درخواست‌های هم‌زمان نامحدود · فروش مجدد با برند خود

ساخت Managed Agent خود را آغاز کنید

از طریق QCode.cc، مدل‌های Claude بر اساس توکن صورت‌حساب می‌شوند و قیمت هر مدل در /models است. نقاط پایانی عامل و نشست Claude Managed Agents توسط Anthropic میزبانی می‌شوند و به هدر بتای managed-agents-2026-04-01 نیاز دارند.

ایجاد حساب کاربری مشاهده قیمت‌گذاری