載入中
載入中

當您需要 Claude 生成像 JSON、Python 程式碼或項目符號列表這樣的結構化資料時,您常常會遇到一個常見問題:Claude 想要提供幫助,並在您的內容周圍添加說明文字、標題或 markdown 格式。當您只需要原始資料時,這些額外的評論會破壞使用者體驗。

EventBridge Rule Generator 應用程式:輸入「監控 EC2 執行個體的規則」、一個 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 自然的格式化直覺。