載入中
載入中

當您需要 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 產生的內容整合到需要乾淨、結構化資料的應用程式中變得更加容易。