読み込み中
読み込み中

JSON、Pythonコード、箇条書きリストなどの構造化データをClaudeに生成させたい場合、よくある問題に直面します。Claudeは役に立とうとして、コンテンツの周りに説明文を追加したがるのです。これは通常は良いことですが、場合によっては説明抜きの生のデータだけが必要なこともあります。

AWS EventBridgeルールを生成するウェブアプリを構築するケースを考えてみましょう。ユーザーが説明を入力し、生成ボタンをクリックすると、すぐにコピーして使用できるクリーンなJSONが表示されることを期待します。Claudeがmarkdownコードブロックで囲んだJSONに説明文を添えて返すと、ユーザーはレスポンス全体を単純にコピーすることができず、JSON部分だけを手動で選択しなければなりません。

EventBridge Rule Generator アプリ:「Rule to monitor EC2 instances」という入力、Generate ボタン、コピー ボタン付きのクリーンな JSON。

デフォルトのレスポンスの問題点

デフォルトでは、ClaudeにJSONの生成を依頼すると、次のような結果が得られるかもしれません。

markdown
```json
{
  "source": ["aws.ec2"],
  "detail-type": ["EC2 Instance State-change Notification"],
  "detail": {
    "state": ["running"]
  }
}
```

This rule captures EC2 instance state changes when instances start running.

JSON自体は正しいのですが、markdownの書式で囲まれており、説明文も含まれています。ユーザーが生のJSONをコピーする必要があるウェブアプリでは、これがユーザー体験の妨げになります。

解決策:アシスタントメッセージのプリフィル + ストップシーケンス

アシスタントメッセージのプリフィルとストップシーケンスを組み合わせることで、まさに求めているコンテンツだけを得ることができます。ストップシーケンスとは、Claudeがそれを生成した時点でレスポンスを終了させる文字列のことです。そこで、まず chat 関数にそのリストを受け取らせましょう。

python
def chat(messages, system=None, temperature=1.0, stop_sequences=[]):
    params = {
        "model": model,
        "max_tokens": 1000,
        "messages": messages,
        "temperature": temperature
    }
    if system:
        params["system"] = system
    if stop_sequences:
        params["stop_sequences"] = stop_sequences

    message = client.messages.create(**params)
    return message.content[0].text

この2つがどのように連携するかを見てみましょう。

python
messages = []

add_user_message(messages, "Generate a very short event bridge rule as json")
add_assistant_message(messages, "```json")

text = chat(messages, stop_sequences=["```"])

この手法は以下のように機能します。

  1. ユーザーメッセージが、Claudeに何を生成すべきかを伝える
  2. プリフィルされたアシスタントメッセージにより、Claudeはすでにmarkdownコードブロックを開始したと認識する
  3. Claudeはそのまま続けて、JSONの内容だけを書き進める
  4. Claudeがコードブロックを ``` で閉じようとすると、ストップシーケンスが即座に生成を終了させる

ストップシーケンスと、json ブロックを開始するプリフィルされたアシスタントメッセージにより、Claude は説明ではなく JSON だけを書くようになる。

結果として、余分な書式のないクリーンなJSONが得られます。

json
{
  "source": ["aws.ec2"],
  "detail-type": ["EC2 Instance State-change Notification"],
  "detail": {
    "state": ["running"]
  }
}

レスポンスの処理

レスポンスの中に、いくつか余分な改行文字が含まれていることに気づくかもしれません。これらは簡単に処理できます。

python
import json

# JSONをクリーンアップして解析する
clean_json = json.loads(text.strip())

JSONを超えて

この手法はJSON生成に限定されるものではありません。説明なしの構造化データが必要な場合はいつでも使用できます。

  • Pythonコードスニペット
  • 箇条書きリスト
  • CSVデータ
  • コンテンツだけが欲しく、説明が不要な、あらゆる書式付きコンテンツ

重要なのは、Claudeが自然とコンテンツをどのような形式で囲みたがるかを見極め、それをプリフィルとストップシーケンスとして利用することです。コードの場合、それは通常markdownコードブロックです。リストの場合は、異なる書式マーカーになることもあります。

このアプローチにより、Claudeの出力形式を精密に制御できるようになり、クリーンで構造化されたデータが不可欠なアプリケーションにAI生成コンテンツを統合することがはるかに容易になります。