加载中
加载中

当您需要 Claude 生成诸如 JSON、Python 代码或项目符号列表之类的结构化数据时,您经常会遇到一个常见问题:Claude 想要乐于助人,于是在您的内容周围添加说明性文字。虽然这通常很好,但有时您只需要原始数据,别无其他。

EventBridge Rule Generator 应用:输入"用于监控 EC2 实例的规则"、一个 Generate 按钮,以及带有复制按钮的干净 JSON。

设想构建一个生成 AWS EventBridge 规则的 Web 应用。用户输入描述,点击生成,期望看到可以立即复制并使用的干净 JSON。如果 Claude 返回的 JSON 被包裹在带有说明性页眉和页脚的 markdown 代码块中,用户就无法简单地点击"全部复制" —— 他们必须手动选中仅 JSON 的部分。

Claude 被要求以 JSON 形式给出用户配置文件、以项目符号列表形式给出任务列表,以及用于数据分析的 Python 代码,并且仅返回这些内容。

每当您生成结构化数据时,都会出现这种模式。Claude 天然地想要解释它的工作,但在许多情况下,您只想要您所要求的内容,别无其他。

Claude 被要求以 JSON 形式给出用户配置文件、以项目符号列表形式给出任务列表,以及用于数据分析的 Python 代码,并且仅返回这些内容。

将停止序列与助手消息预填充相结合

解决方案结合了我们已经介绍过的两种技术:停止序列和助手消息预填充。以下是它在实践中的工作方式:

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

运行这段代码时,您只会得到 JSON 内容,不会有任何 markdown 格式或额外的注释。

幕后工作原理

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

以下是 Claude 处理您的请求时发生的事情:

  1. Claude 读取您的用户消息,并想"我需要写一条完整的规则,并且可能需要描述它"
  2. 它看到预填充的助手消息,并认为自己已经开始编写 JSON markdown 代码块
  3. Claude 想"哦,我已经开始了 JSON 部分,所以我只需要写实际的 JSON 内容"
  4. 它生成 JSON 内容
  5. 当 Claude 尝试用 ``` 关闭 markdown 代码块时,它碰到了停止序列,生成立即停止

结果是,您得到了预填充起始部分和停止序列之间的所有内容 —— 正是您想要的内容。

清理输出

返回的文本可能会有一些多余的换行符,但您可以轻松地清理它:

python
import json

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

这种技术适用于任何结构化数据格式,而不仅仅是 JSON。无论您是在生成 Python 代码、项目符号列表,还是任何其他特定的内容格式,您都可以使用助手消息预填充来启动响应,并使用停止序列在您想要的确切位置结束它。

这种方法让您能够精确控制 Claude 的输出格式,确保您的应用程序获得干净、可用的数据,而不会有可能干扰下游处理的额外格式或注释。