# Claude Agent SDKの便利で実践的な使い方
🤖 サブエージェントに専門タスクを委譲して、メインコンテキストをリーンに保てます。
サブエージェントは、特定のサブタスクを専門エージェントに委譲し、メインエージェントのコンテキストを汚さずに並列・専門処理を実現する機能です。
📌 タイトル:SDK のサブエージェント
🔗 URL:
🧩 概要
`agents` パラメータで専門エージェントを定義し、メインエージェントが `Agent` ツール経由で呼び出します。各サブエージェントには独自のプロンプト・ツール制限・モデル設定が可能で、結果は要約としてメインに返されます。
🛠 使い方
`agents` パラメータに `AgentDefinition`(`description`・`prompt`・`tools`・`model` 等)を定義します。`allowed_tools` に `"Agent"` を含めるとサブエージェント呼び出しが自動承認されます。各サブエージェントは独自のツール制限・プロンプト・モデルを持てます。
🏗 実践的な使い方
・`research-assistant` サブエージェントに数十ファイルの探索を委譲し、親エージェントには要約だけ返します。メインコンテキストがリーンに保たれます。
・`style-checker` / `security-scanner` / `test-coverage` を同時実行し、コードレビュー時間を数分→数秒に短縮します。
・`database-migration` サブエージェントに SQL ベストプラクティス・ロールバック戦略のプロンプトを持たせ、メインを汚さず専門タスクを処理します。
・ファクトリ関数で実行時条件に応じて `model: "opus"` / `sonnet` を動的に切り替えます。
💡 ユースケース
🔍 大量ファイル探索の委譲
⚡ 並列コードレビュー(style/security/coverage)
🎯 専門知識エージェントへのタスク分割
⚠️ 注意点
サブエージェントは自分のサブエージェントを生成できません(1 段階のみ)。大規模オーケストレーションには `Workflow` ツール(TS v0.3.149+)を使用してください。`agentId` と `session_id` をキャプチャすれば `resume` でフォローアップも可能です。
#
ClaudeAgentSDK# #
AI#