1 ファイル変更 +13 -0
この更新の概要
Agent SDKとManaged Agentsの主な違いを比較するセクションが追加されました。実行環境、インターフェース、セッション状態の管理方法、およびカスタムツールの実行方法について具体的な差異が表形式で明示されています。ローカルでのプロトタイピングにはAgent SDK、本番環境にはManaged Agentsを利用するという推奨される開発フローが示されました。
Agent SDKとManaged Agentsの機能比較表が導入され、各環境の適したユースケースが定義されました。セッション状態の保存先やツールの実行プロセスにおける具体的な違いが詳しく説明されています。
@@ -452,6 +452,19 @@ Same capabilities, different interface:
Many teams use both: CLI for daily development, SDK for production. Workflows translate directly between them.
[Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) is a hosted REST API: Anthropic runs the agent and the sandbox, and your application sends events and streams back results. The **Agent SDK** is a library that runs the agent loop inside your own process.
| | Agent SDK | Managed Agents |
| - | - | - |
| **Runs in** | Your process, your infrastructure | Anthropic-managed infrastructure |
| **Interface** | Python or TypeScript library | REST API |
| **Agent works on** | Files on your infrastructure | A managed sandbox per session |
| **Session state** | JSONL on your filesystem | Anthropic-hosted event log |
| **Custom tools** | In-process Python or TypeScript functions | Claude triggers the tool; you execute and return results |
| **Best for** | Local prototyping, agents that work directly on your filesystem and services | Production agents without operating sandbox or session infrastructure, long-running and asynchronous sessions |
A common path is to prototype with the Agent SDK locally, then move to Managed Agents for production.
## Changelog
View the full changelog for SDK updates, bug fixes, and new features: