加载中
加载中

当您需要 Claude 生成 JSON、Python 代码或项目符号列表等结构化数据时,经常会遇到一个常见问题:Claude 想要提供帮助,会在您的内容周围添加解释性文字。虽然这通常很好,但有时您只需要原始数据,不需要其他任何内容。

设想正在构建一个生成 AWS EventBridge 规则的网页应用。用户输入描述,点击生成按钮,期望看到可以立即复制使用的干净 JSON。如果 Claude 返回的 JSON 被包裹在带有解释性文字的 markdown 代码块中,用户就无法直接复制整个响应——他们必须手动只选中 JSON 部分。

EventBridge 规则生成器应用:输入框"监控 EC2 实例的规则"、一个生成按钮,以及带有复制按钮的干净 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

以下是两者如何协同工作的:

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 生成的内容集成到需要干净、结构化数据的应用程序中变得更加容易。