5 サービスで Claude Agent SDK を呼ぶことになって、共通化した部分と意図的に揃えなかった部分
この記事で分かること
複数のサービスからClaude Agent SDKを呼び出す際に、共通化した処理と意図的に統一しなかった処理の設計判断が学べる。共通化による保守性向上と、サービスごとの特性を残すトレードオフの実例が得られる。実際の設計方針を決める際の判断基準として使える。
詳細要約
複数のサービスでClaude Agent SDKを統合する際、呼び出し部分の共通化と意図的な非共通化の判断基準が実装の効率と柔軟性を左右する。共通化したのは、エラーハンドリングやリトライロジック、API認証情報の管理といった、どのサービスでも変わらない基盤処理。一方、意図的に揃えなかったのは、各サービスのユースケースに応じたプロンプトテンプレートや、返却形式のパース処理、タイムアウト値の設定。これにより、共通基盤を保ちつつ、サービス固有の要件に合わせた調整を可能にしている。