読み込み中

XMLタグで構造化する

レッスン 199 分
読み込み中

多くのコンテンツを含むプロンプトを作成する際、Claudeはどのテキストがひとまとまりであるか、あるいは各セクションが何を表しているのかを理解するのに苦労することがあります。XMLタグを使うと、特に大量のデータを差し込む場合に、プロンプトに構造と明確さを簡単に加えることができます。

構造化が重要な理由

20ページ分の販売記録を分析する必要があるプロンプトを考えてみましょう。明確な境界がなければ、Claudeはあなたの指示と、実際に分析してほしいデータとを区別するのに苦労するかもしれません。

XMLタグのないプロンプト:決定レポートを求め、sales_recordsを差し込み、その後に5つの番号付きステップを列挙している。

上記の例は、境界が不明瞭だとClaudeがあなたの意図を解釈しづらくなることを示しています。販売記録をXMLタグで囲むことで、プロンプトの異なる部分の間に明確な区切りを作ることができます。

明確さのためにXMLタグを使う

XMLタグは区切り文字として機能し、Claudeがプロンプトの構造を理解する助けとなります。含まれる内容を説明するカスタムタグ名を自由に作成できます。

<sales_records>
{sales_records}
</sales_records>

タグ名は公式のXML仕様に従う必要はありません。sales_records、data、recordsのような説明的な名前を自由に作成できます。一般的には、より具体的な名前の方が汎用的な名前よりもうまく機能します。

実践的な例

XMLタグがなぜ違いを生むのか、わかりやすい例を見てみましょう。「Not Great(良くない例)」のバージョンでは、どのコンテンツがバグのあるコードでどれがドキュメントなのかが不明瞭です。

同じデバッグ用プロンプトを2つ並べたもの:コードとドキュメントが混在した「Not Great」、my_codeタグとdocsタグを使った「Better」。

改善版ではXMLタグを使って、異なる種類のコンテンツを明確に分離しています。

<my_code>
from datavortex import Pipeline, DataSource

def process_data(input_file, output_file):
    pipeline = Pipeline()
    source = DataSource.from_csv(input_file)
</my_code>

<docs>
# Creating a data source from data vortex
csv_source = DataSource.from_csv("data.csv")
</docs>

これでClaudeは、デバッグが必要なコードと、デバッグ作業の指針となるべきドキュメントとを容易に区別できます。

プロンプトに構造を適用する

差し込むコンテンツがそれほど大量でない場合でも、XMLタグは明確さを向上させることができます。例えば、食事プランを生成する際には、アスリートに関する情報をまとめてグループ化できます。

<athlete_information>
- Height: {prompt_inputs["height"]}
- Weight: {prompt_inputs["weight"]}
- Goal: {prompt_inputs["goal"]}
- Dietary restrictions: {prompt_inputs["restrictions"]}
</athlete_information>

これにより、このブロックが食事プラン生成の参考にすべきアスリートに関する外部入力であることが、Claudeにとって非常に明確になります。

XMLタグを使うべき場面

XMLタグは次のような場合に特に役立ちます。

  • 大量のコンテキストやデータを含める場合
  • プロンプトに複数の明確に異なる種類のコンテンツが含まれる場合
  • 異なるセクション間の境界を明確にしたい場合
  • 指示内容と混同される可能性のあるコンテンツを差し込む場合

シンプルなプロンプトでは劇的な改善が見られないかもしれませんが、XMLタグは区切り文字として機能し、Claudeがあなたの意図をより良く理解できるようにすることで、より一貫性があり正確な応答につながります。