加载中
加载中

当您需要Claude生成JSON、Python代码或项目符号列表等结构化数据时,通常会遇到一个常见问题:Claude希望提供帮助,会在您的内容周围添加解释性文字、标题或markdown格式。当您只需要原始数据时,这些额外的说明会破坏用户体验。

EventBridge Rule Generator 应用:输入"Rule to monitor EC2 instances",一个Generate按钮,以及带有复制按钮的干净JSON。

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

默认响应的问题

默认情况下,Claude倾向于这样格式化结构化输出:

markdown
# EventBridge Rule
```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 or stop.

虽然这对文档来说很好,但当您只需要JSON用于程序化用途时,这就成了问题。

解决方案:助手消息预填充 + 停止序列

您可以将助手消息预填充与停止序列结合使用,以获得您想要的确切内容。其工作方式如下:

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=["```"])

此技术的工作原理是:

  • 用开头的markdown分隔符预填充助手消息
  • 设置停止序列,以便在Claude尝试关闭代码块时暂停生成
  • 只捕获这些分隔符之间的内容

一个停止序列和一个打开json代码块的预填充助手消息,使Claude只编写JSON,而不是描述。

背后的工作原理

当Claude收到您的请求时,它会看到预填充的助手消息,并认为自己已经开始编写JSON代码块。Claude不会添加自己的标题和开头分隔符,而是直接跳到生成实际的JSON内容。

当Claude完成JSON并自然地想用 ``` 关闭markdown代码块时,停止序列会立即暂停生成并返回响应。您得到的只是JSON内容,没有任何多余的格式。

处理结果

返回的文本可能包含一些换行符,但您可以轻松清理:

python
import json

# 解析为 JSON 以进行验证和格式化
parsed_data = json.loads(text.strip())

# 或者对于其他数据类型,直接去除空白字符
clean_text = text.strip()

不仅限于JSON

此技术不仅限于JSON生成。您可以将其用于任何结构化数据,只需要内容而不需要Claude添加解释性文字的自然倾向:

  • Python代码片段
  • 项目符号列表
  • CSV数据
  • 配置文件
  • 任何干净、可复制输出很重要的格式

关键在于识别Claude自然会在您的内容类型周围使用的分隔符,然后预填充开头分隔符,并在结尾分隔符处停止。这让您能够精确控制输出格式,同时利用Claude的自然格式化本能。