読み込み中

柔軟なツール抽出

レッスン 319 分
読み込み中

構造化データ抽出のために詳細なJSONスキーマを書くことは、AIツールを使用する際の本当の悩みの種になることがあります。複雑なスキーマを作成する代わりに、プロンプト内で直接希望するデータ構造を指定できる巧妙な回避策があります。

柔軟なスキーマのアプローチ

データ抽出タスクごとに詳細なスキーマを書く代わりに、任意のオブジェクト構造を受け入れるto_jsonという汎用的なツールを1つ作成できます。ポイントは、入力スキーマで追加プロパティを許可するように設定し、プロンプト自体で正確な要件を指定することです。

to_jsonのツールスペック。入力スキーマは「json」をtype「object」に設定し、「additionalProperties」をTrueに設定して、あらゆるJSONを受け入れる。

このアプローチは、大きな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%を実現するため、スキーマ管理のオーバーヘッドなしに構造化データ抽出が必要なほとんどのユースケースに最適です。