修改指定 DataAgent 下某個會話的標題、狀態與自訂屬性。
介面說明
對話的標題、狀態與自訂屬性可以透過本介面修改。對話建立時關聯的日誌服務 Project 與工作空間（variables）不支援透過本介面修改；對話中的訊息內容也無法在此變更，歷史訊息請使用 GetThreadData 查詢，刪除對話請使用 DeleteThread。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求文法
PUT /dataagents/{name}/threads/{threadId} HTTP/1.1路徑參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| name |
string |
否 |
DataAgent 的名稱，透過請求路徑傳入，用於指定會話所屬的 DataAgent。 |
order-analysis-agent |
| threadId |
string |
否 |
要修改的對話 ID，透過請求路徑傳入，由 CreateThread 返回。 |
thread-tiirv9-irwdoal8t4rm |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| body |
object |
否 |
請求主體。填寫需要修改的會話欄位，至少填寫一個。 |
|
| attributes |
object |
否 |
更新後的會話自訂屬性，鍵與值均為字串。 |
|
|
string |
否 |
屬性值，字串類型。 |
2026-08 |
|
| status |
string |
否 |
更新後的會話狀態，取值與返回參數 status 一致；例如傳入 archived 可歸檔該會話。 |
archived |
| title |
string |
否 |
更新後的會話標題。 |
Order Exception Cause Analysis |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| requestId |
string |
本次請求的 ID，用於問題排查時定位本次呼叫。 |
5B0A6B60BB6EE39764D458B5 |
| threadId |
string |
Id of the request |
thread-tiirv9-irwdoal8t4rm |
| version |
integer |
會話更新後的版本號。 |
4 |
樣本
正常返回樣本
JSON格式
{
"requestId": "5B0A6B60BB6EE39764D458B5",
"threadId": "thread-tiirv9-irwdoal8t4rm",
"version": 4
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。