全部產品
Search

搜尋本產品

    Intelligent Media Services：ListAIAgentDialogues

    文件中心

    Intelligent Media Services：ListAIAgentDialogues

    更新時間：Oct 09, 2026

    列出會話的歷史記錄。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ice:ListAIAgentDialogues

    none

    *全部資源。

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    SessionId

    string

    是

    會話 ID。

    f27f9b9be28642a88e18****
    RoundLimit

    string

    否

    對話回合限制。指定回傳最近 N 個回合的對話記錄，必須為正整數。與分頁參數互斥，使用此參數時將忽略分頁參數。

    5
    StartTime

    integer

    是

    開始 Unix 時間戳記（包含），毫秒。

    0
    EndTime

    integer

    是

    結束 Unix 時間戳記（包含），毫秒。

    17358082464030
    PageNumber

    integer

    否

    分頁數，預設 1。

    1
    PageSize

    integer

    否

    分頁大小，最大 100，預設 20。

    20
    Order

    string

    否

    ASC 正序，DESC 倒序。預設 DESC。

    DESC

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID。

    7B117AF5-***************
    Dialogues

    array<object>

    對話記錄列表。

    array<object>

    DialogueId

    string

    這條對話的唯一 ID。

    19de81b3b3d94abda22****
    RoundId

    string

    對話回合 ID。

    f27f9b9be28642a88e18****
    Producer

    string

    這句話的產生者。

    • user： 使用者產生的句子

    • agent：智能體產生的句子。

    枚舉值：

    • agent :

      agent

    • user :

      user

    user
    Text

    string

    對話具體的文字。

    hello
    ReasoningText

    string

    深度思考的文字。

    I am thinking
    AttachedFileList

    array<object>

    附件列表。對話中引用的檔案附件資訊。

    object

    Url

    string

    附件的存取位址（URL）。

    https://media.w3.org/2010/05/sintel/trailer.mp3
    Id

    string

    附件的唯一識別碼。

    7B117AF5-***************

    Format

    string

    附件的格式（如 mp3、wav、pdf 等）。

    mp3
    Type

    integer

    附件類型。數值類型，具體含義由業務定義。

    1
    Name

    string

    附件的檔案名稱。

    MusicDemix
    Time

    integer

    這條對話產生的 Unix 時間戳記，單位毫秒。

    1734511087000
    Type

    string

    這句話的類型。可選：

    語音通話

    1. greeting 歡迎語

    2. normal 語音回覆

    3. speech 主動播報

    文字對話

    1. normal 文字回覆

    2. announcement 主動推送文字。

    3. custom 自訂訊息。

    announcement
    Source

    string

    這句話的來源。可選：

    chat 文字對話

    call 語音通話

    chat
    NodeId

    string

    節點 ID。標示產生該對話的流程節點，用於追溯對話是由哪個處理節點產生的。

    e01-cn-to345ikn62o
    Extend

    string

    擴充資訊。JSON 格式的擴充欄位，用於儲存額外的自訂資料，如情感標籤、意圖識別結果等。

    {\"addTransferLock\":true}

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "7B117AF5-***************",
  "Dialogues": [
    {
      "DialogueId": "19de81b3b3d94abda22****",
      "RoundId": "f27f9b9be28642a88e18****",
      "Producer": "user",
      "Text": "Hello",
      "ReasoningText": "我在思考",
      "AttachedFileList": [
        {
          "Url": "https://media.w3.org/2010/05/sintel/trailer.mp3",
          "Id": "7B117AF5-***************\n",
          "Format": "mp3",
          "Type": 1,
          "Name": "MusicDemix"
        }
      ],
      "Time": 1734511087000,
      "Type": "announcement",
      "Source": "chat",
      "NodeId": "e01-cn-to345ikn62o",
      "Extend": "{\\\"addTransferLock\\\":true}"
    }
  ]
}

    錯誤碼

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

    變更歷史

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