# Claude Agent SDKの便利で実践的な使い方
📦 エージェントの出力を型付き JSON で受け取り、UI コンポーネントに直接バインドできます。
構造化出力は、`output_format` でエージェントの最終出力を JSON スキーマに従った型付きデータとして取得する機能です。Zod / Pydantic で型安全に検証できます。
📌 タイトル:エージェントから構造化された出力を取得する
🔗 URL:
🧩 概要
`output_format` に JSON スキーマを指定すると、エージェントはツール実行・分析の結果を自由文ではなく構造化 JSON で返します。Zod(TypeScript)/ Pydantic(Python)で型安全に検証可能です。
🛠 使い方
`output_format={"type": "json_schema", "schema": your_schema}` をオプションに設定します。Pydantic の `.model_json_schema()` や Zod の `z.toJSONSchema()` でスキーマを生成できます。結果は `ResultMessage.structured_output` に格納されます。
🏗 実践的な使い方
・レシピアプリで Web 検索結果を `{name, prep_time_minutes, ingredients[], steps[]}` の型付き JSON で受け取り、UI コンポーネントへ直接バインドします。
・TODO 抽出エージェントで Grep + Bash(git blame) を自律実行し `{todos[{text, file, line, author?, date?}], total_count}` を返します。
・機能実装計画を `{summary, steps[{description, complexity}], risks[]}` のスキーマで受け取り、プロジェクト管理ツールに自動投入します。
💡 ユースケース
🎨 UI コンポーネントへの直接データバインディング
📊 分析結果の構造化レポート生成
🔧 プロジェクト管理ツールへの自動データ投入
⚠️ 注意点
構造化出力はストリーミングと非互換です。JSON 結果は最終 `ResultMessage.structured_output` にのみ出力されます。`error_max_structured_output_retries` を検知して、より単純なプロンプトでの再試行や非構造化フォールバックを実装してください。
#
ClaudeAgentSDK# #
AI#