全部產品
Search

搜尋本產品

    DataWorks：ReplyAgentSession

    文件中心

    DataWorks：ReplyAgentSession

    更新時間：Oct 09, 2026

    回覆 DataAgent 會話中等待處理的使用者互動。

    介面說明

    回覆 DataAgent daemon 發出的 permission_request，支援提交 ask_user_question 的答案或取消目前互動。PermissionRequestId 必須來自原 PromptAgentSession SSE 的 _qwen/notify 事件（params.kind=permission_request）中的 params.data.requestId。回覆僅返回是否被接受；後續執行事件仍透過原 PromptAgentSession SSE 返回，不要重複提交同一輪 prompt。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dataworks:ReplyAgentSession

    none

    *All Resource

    *

    		 無 無

    請求文法

    POST  HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Jsonrpc

    string

    否

    JSON-RPC 協定版本，固定為 2.0。

    枚舉值：

    • 2.0 :

      JSON-RPC 2.0

    2.0
    Id

    string

    是

    本次回覆請求的 JSON-RPC 關聯識別碼，回應中原樣返回；與 PermissionRequestId 不同。

    reply-rpc-001
    Params

    object

    是

    使用者互動回覆參數。

    Answers

    object

    否

    ask_user_question 的答案，鍵為從 0 開始的問題下標字串，值為回答文字；多個問題逐項填寫。普通工具授權或取消時省略。

    {"0":"lakehouse_uat"}

    string

    否

    回答清單。

    {"0":"key","1":"value"}
    Outcome

    object

    是

    使用者對本次互動的處理結果。

    OptionId

    string

    否

    Outcome=selected 時必填且不能為空，取本次事件 options 中實際選項的 optionId（提交答案通常選擇 kind=allow_once 的選項）；Outcome=cancelled 時省略。

    option-from-event
    Outcome

    string

    是

    處理類型：selected 表示選擇一個選項；cancelled 表示使用者明確取消。

    枚舉值：

    • cancelled :

      已取消。

    • selected :

      已選擇。

    selected
    PermissionRequestId

    string

    是

    目前 permission_request 的識別碼。取自原 SSE 的 _qwen/notify.params.data.requestId，不是 ToolCallId、HTTP RequestId 或本次 JSON-RPC Id；不能為 . 或 ..。

    permission-001
    SessionId

    string

    是

    LSP 會話標識。使用建立會話返回的 SessionId，不是 daemon 內部會話 ID。

    lsp-session-001

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    JsonRpcResponse

    object

    JSON-RPC 回應。成功時返回 Result，協定錯誤時返回 Error。

    Error

    object

    JSON-RPC 錯誤資訊。例如 daemon 回覆功能未啟用時返回 DAEMON_PERMISSION_UNAVAILABLE。

    Code

    integer

    JSON-RPC 錯誤碼。

    -32601
    Data

    any

    可選的錯誤附加資訊；內容取決於錯誤類型。

    {}
    ErrorCode

    string

    業務錯誤碼。

    DAEMON_PERMISSION_UNAVAILABLE
    Message

    string

    錯誤資訊。

    DataAgent daemon permission reply is not enabled
    Id

    string

    本次回覆請求的 JSON-RPC 關聯標識。

    reply-rpc-001
    Jsonrpc

    string

    JSON-RPC 協定版本。

    2.0
    Result

    object

    回覆處理結果；僅表示是否接受本次回覆，不表示原任務執行完成。

    Accepted

    boolean

    true 表示 daemon 接受本次回覆；false 表示未接受，可能是請求未知、已處理、已過期或會話不存在，不能據此區分具體原因。

    true
    Timestamp

    integer

    回應時間，Unix 時間戳記，單位為毫秒。

    1789549200000
    RequestId

    string

    本次呼叫的請求標識，可用於問題排查。

    request-001

    樣本

    正常返回樣本

    JSON格式

    {
  "JsonRpcResponse": {
    "Error": {
      "Code": -32601,
      "Data": "{}",
      "ErrorCode": "DAEMON_PERMISSION_UNAVAILABLE",
      "Message": "DataAgent daemon permission reply is not enabled"
    },
    "Id": "reply-rpc-001",
    "Jsonrpc": "2.0",
    "Result": {
      "Accepted": true
    },
    "Timestamp": 1789549200000
  },
  "RequestId": "request-001"
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。