Agent 回應回饋

允許使用者針對 Agent 生成的回應提供回饋，協助 Agent 開發者優化效能。

請求方法

POST

請求網址

https://api-${endpoint}.gptbots.ai/v1/message/feedback

請求認證

請參考 API 概覽以瞭解認證說明。

請求

請求範例

curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/message/feedback' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "answer_id": "123456789", // 回應的訊息識別碼 "feedback": "POSITIVE" // 回饋類型 }'

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/message/feedback' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
        "answer_id": "123456789", // 回應的訊息識別碼
        "feedback": "POSITIVE"    // 回饋類型
}'

此代碼塊在浮窗中顯示

請求標頭

欄位	類型	描述
Authorization	Bearer ${API Key}	使用 Authorization: Bearer ${API Key} 進行認證。您可以從 API Key 頁面獲取 API 金鑰。
Content-Type	application/json	資料類型，設為 application/json。

請求參數

欄位	類型	必填	描述
answer_id	string	是	Agent 回應的訊息識別碼。
feedback	string	是	對 Agent 回應的回饋。 - POSITIVE：正面、喜歡、按讚、批准 - NEGATIVE：負面、不喜歡、倒讚、不批准 - CANCELED：取消回饋

回應

回應範例

{ "affectCount": 0 }

                      
                      {
    "affectCount": 0
}

此代碼塊在浮窗中顯示

成功回應

欄位	類型	描述
affectCount	long	成功回饋的數量。若成功，則為 1。

失敗回應

欄位	類型	描述
code	int	錯誤代碼。
message	string	錯誤詳情。

錯誤代碼

錯誤代碼	訊息
40000	無效參數
40127	開發者認證失敗
20059	Agent 已刪除