オプションBは、ツールインターフェース自体から曖昧さを解消します。エージェントは、密接に関連する業務操作を表す別々の機能を選択する必要がなくなります。代わりに、単一の報酬ツールが明確なアクションパラメータを公開し、既存の注文検索ツールは、明確に定義されたフラグを通じて、オプションで配送追跡情報を返すことができます。
Anthropicのツール設計ガイドラインでは、個別の機能が不必要な意味的重複を生み出す場合、関連する操作をより少なく、より高性能なツールに統合することを推奨しています。Claudeは主にツールの名前、説明、スキーマ、および現在のタスクに基づいてツールを選択します。複数のツールが同じ要求を満たすことができるように見える場合、エージェントはインターフェース設計で明示的に示されるべき区別を推測する必要があるため、選択精度が低下します。
オプションAはルーティングの複雑さを増しますが、同じサブエージェント内で重複する金融操作が引き続き利用可能になります。オプションCは初期ロードされるツールの数を減らしますが、補償操作間または重複する検索機能間の意味的な重複を解消しません。オプションDは例を通して動作を改善する可能性がありますが、根本原因を修正するのではなく、設計の不十分なツールインターフェースを補うものです。
統合されたスキーマでは、サポートされるアクションには列挙型を使用し、各アクションが適用されるタイミングを明確に定義し、返されるフィールドを文書化する必要があります。これにより、エージェントとコンピュータ間のインターフェースがより小さく、より決定論的になります。
公式参照/トピック: ツールの統合、セマンティックツールの境界、アクションパラメータ、MCPツールの選択精度。

フォーク機能は、共有された過去の分析結果から代替的な方向性を探るために特別に設計されています。各フォークは、読み込まれたファイル、アーキテクチャ上の観察結果、依存関係の発見、既に記録された決定事項など、昨日の会話履歴のコピーから始まります。マイクロサービスアプローチとインプレースリファクタリングアプローチは、それぞれ別のセッションIDの下で独立して開発できます。
Anthropic の Agent SDK ドキュメントには、フォークは元の履歴のコピーから新しいセッションを作成し、元のセッションは変更されないと記載されています。結果として得られる各セッションは、その後独立して再開できます。ドキュメントに記載されている実装では、Python では resume と fork_session=True、TypeScript では forkSession: true を組み合わせています。( https://code.claude.com/docs/en/agent-sdk/sessions ) オプション B では、最初のアプローチからの結論、仮定、および提案された編集が、2 番目の評価に影響を与える可能性があります。オプション C では、1 つのブランチのコンテキストのみが保持され、エンジニアは他のブランチのコンテキストを手動で再構築する必要があります。オプション D では、セッションですでにキャプチャされた詳細な分析が破棄され、不完全な要約に依存する可能性があります。
2つのフォークは同等の開始条件を提供し、親の調査を維持し、範囲、移行リスク、運用上の複雑さ、および必要なコード変更の公平な比較をサポートします。セッションのフォークは作業ディレクトリではなく会話履歴を分岐させるため、ファイルシステムの編集はワークツリーまたはチェックポイントによって分離する必要があります。
公式リファレンス/トピック: エージェントSDKセッション、セッションフォーク、代替アプローチの探索、コンテキストの保持。

エラー応答では、制御セマンティクスとユーザー向けの意味の両方を明確に伝える必要があります。「retriable」をfalseに設定すると、同じ操作を繰り返しても結果が変わらないことをエージェントに伝えます。顧客にとって分かりやすい説明を提供することで、Claudeは内部実装の詳細を公開したり、ビジネスルールを独自に解釈したりすることなく、正確に応答できます。
Anthropic は、失敗したツール操作をエラー インジケータと十分な情報を含むコンテンツとともに返すことを推奨しています。これにより、Claude は再試行するか、別の入力を要求するか、制限を説明するかを判断できます。ツール インターフェイスは、Claude に曖昧なテキストから操作動作を推測させるのではなく、詳細な説明と構造化されたパラメータを提供する必要があります。( https://platform.claude.com/docs/en/agents-and-tools/tool-use/build-a-tool- using-agent?utm_source=chatgpt.com ) オプション A は、自動再試行を技術的な障害に適切に制限しますが、ビジネス上の障害にも明確な意味がない限り、述べられている顧客応答の問題を解決しません。オプション B は、人間が読めるメッセージの脆弱な解析に依存しています。オプション C は、遅延と別のツールへの依存を追加し、事前チェックでカバーされていない理由で適格性が変更または失敗する可能性があります。
完全なスキーマでは、エラーコード、カテゴリ、再試行可能性、顧客にとって安全な説明、および許可される次のアクションを特定する必要があります。技術的なエラーの場合も同様に、「再試行可能」: true が返され、再試行に関するガイダンスと最大試行回数ポリシーが示されます。
公式参照資料／トピック：構造化ツールエラー、再試行可能性の分類、顧客にとって安全な説明、回復力のあるMCP契約。