Claude の構造化出力入門——AI の返答を必ず JSON に変える

Message Batches APIを使うことで、バッチ処理が通常料金の50%引きで実行できます。チケット分類など「今すぐ結果が不要」な処理をTypeScriptで実装する方法と、リクエスト投入・ポーリング・結果回収時に踏みやすい3つの落とし穴を解説。

Claude API のプロンプトキャッシュ導入時、cache_control を記述しても請求が下がらない原因の多くはキャッシュ不使用に気づけていないこと。TypeScript で最小構成から始め、usage の cache_read_input_tokens を測定し、最小トークン数・変動値混在・並列実行・TTL 切れ等の外れ要因を潰す手順を解説。

Claude API の web_search ツールを使い最新情報を取得する実装方法を解説。tools にweb_search_20260209を追加するだけでサーバー側で検索実行され、複数のテキストブロックで返されることや、検索エラーが HTTP 200 で返ってくること、allowed_domains で検索先を絞る方法など3つの実装時の落とし穴を具体的に紹介。

2027年度開始のプロフェッショナルデジタルスキル試験（PD試験）は対策問題がほぼ存在しないため、Claude API を活用してオリジナル演習問題150問を生成・検証し無料公開した。プロンプト設計（出力形式の厳密指定・分野ローテーション・解説粒度の指示）と品質管理（正解の偏り確認・重複チェック・JavaScriptデバッグ）の課題を経験。