読み込み中
構造化データ抽出のために詳細なJSONスキーマを書くことは、AIツールを使用する際の本当の悩みの種になることがあります。複雑なスキーマを作成する代わりに、プロンプト内で直接希望するデータ構造を指定できる巧妙な回避策があります。
柔軟なスキーマのアプローチ
データ抽出タスクごとに詳細なスキーマを書く代わりに、任意のオブジェクト構造を受け入れるto_jsonという汎用的なツールを1つ作成できます。ポイントは、入力スキーマで追加プロパティを許可するように設定し、プロンプト自体で正確な要件を指定することです。

このアプローチは、大きなJSONスキーマを絶えず書いて管理するという大きな悩みの種を取り除きます。結果は専用のスキーマほど良くはなりませんが、それでもはるかに少ないセットアップ作業で高品質なJSON出力を得ることができます。
仕組み
このプロセスは単純です:
- 任意のオブジェクト構造を受け入れる、単一の柔軟なスキーマを作成する
- プロンプト内で、希望するデータ構造を正確に指定する
- 指定した構造で
to_jsonツールを呼び出すようClaudeに指示する tool_choiceを使用して、Claudeにツールの使用を強制する
プロンプトの設定
プロンプトを書く際は、希望する構造について非常に明確にしてください。リクエストの構造化方法の例を以下に示します:
Analyze the article below and extract key data. Then call the to_json tool.
<article_text>
{result["text"]}
</article_text>
When you call to_json, pass in the following structure:
{{
"title": str # title of the article,
"author": str # author of the article,
"topics": List[str] # List of topics mentioned in the article
}}APIコールの実行
APIコールは柔軟なスキーマを使用し、ツールの使用を強制します:
python
flexible_result = chat(messages, tools=[to_json_schema], tool_choice="to_json")簡単な構造変更
データ構造を変更する必要があるときに、この方法の本当の利点が明らかになります。スキーマ全体を書き直す代わりに、単にプロンプトを更新するだけです。トピック数のフィールドを追加したいですか?1行追加するだけです:
python
"num_topics": int # Number of topics mentionedこれで完了です - スキーマの変更は一切不要です。
どちらのアプローチを使うべきか
柔軟なスキーマのアプローチは、次のような場合にうまく機能します:
- 迅速なプロトタイピングと実験
- シンプルなデータ抽出タスク
- データ要件を頻繁に変更する状況
次のような場合は専用のスキーマを使い続けてください:
- 本番環境での重要なデータ抽出タスク
- 複雑なネストされたデータ構造
- 可能な限り最高の精度が必要な場合
柔軟なアプローチは、セットアップ作業の10%で品質の約90%を実現するため、スキーマ管理のオーバーヘッドなしに構造化データ抽出が必要なほとんどのユースケースに最適です。