：CreateChat

使用前提

• 需先建立 DataAgent，並透過 CreateThread 取得會話執行緒 ID。

串流回傳

• 本介面為串流介面，回應的 Content-Type 為 text/event-stream。狀態碼 200 之後事件會持續推送，直到收到 type 為 stream_done 的事件。

• 每個事件的 data 欄位都是一條獨立的 JSON 文件，而不是整段回覆的替換，請按到達順序處理：文字回覆以增量片段給出，工具與子 Agent 的執行過程以獨立的訊息事件給出。

出錯的兩種型態

• 若在首個事件到達之前出錯，回傳的是一般 JSON 錯誤回應，並帶有對應的 HTTP 狀態碼。

• 若已在串流輸出過程中出錯，則會收到一個事件名為 error 的事件，其 data 中帶有 error 欄位，此時 HTTP 狀態碼仍為 200。用戶端需要同時處理這兩種情況。

action 的三種用法

• create（預設）：攜帶 messages 發起新一輪對話。

• reconnect：不攜帶 messages，重新連線本執行緒尚未結束的對話，繼續接收輸出。

• stop：終止正在產生的回覆。

需要您補充輸入的情況

• 當 Agent 需要您確認或補充資訊時，會推送 type 為 interactive 的事件；請在用戶端完成互動後，攜帶互動結果以 action 為 create 的請求繼續會話。

發起新一輪對話：

{
  "name": "my-agent",
  "threadId": "thread-tiirv9-irwdoal8t4rm",
  "action": "create",
  "messages": [
    {
      "role": "user",
      "contents": [
        { "type": "text", "value": "統計最近 1 小時 nginx-access-log 中請求量最高的 10 個 URL" }
      ]
    }
  ],
  "variables": {
    "region": "cn-hangzhou",
    "project": "nginx-demo",
    "language": "zh"
  }
}

終止正在產生的回覆（不需要 messages）：

{
  "name": "my-agent",
  "threadId": "thread-tiirv9-irwdoal8t4rm",
  "action": "stop"
}

回應按事件推送，每個事件由 event、id 與 data 組成，data 是一條完整的 JSON 文件：

event: message
id: 1
data: {"messages":[{"parentCallId":"","callId":"thread-t709p8-s24hgl7ug8jw","role":"assistant","seq":4,"timestamp":"1765289004","contents":[{"type":"text","value":"正在分析……","append":true}]}],"traceId":"88b50db22437400fa9c16c5399722310"}

把同一條訊息中 type 為 text 的 value 按到達順序拼接，即為完整的回覆文字；type 為 spin_text 的內容是 Agent 的思考與執行過程提示，可不作為正文展示。任務結束時依序收到 type 為 task_finished（payload 中含 success）與 stream_done 的事件。