全部產品
Search

搜尋本產品

    Intelligent Media Services：DescribeAIAgentInstance - 查詢智能體執行個體詳情

    文件中心

    Intelligent Media Services：DescribeAIAgentInstance - 查詢智能體執行個體詳情

    更新時間：Apr 03, 2026

    查詢執行個體。

    介面說明

    • 功能描述：此介面用於查詢指定智能體執行個體的詳細資料。

    • 使用情境：當需要監控或分析智能體在通話中的表現，或者調試智能體配置效果時，可調用此介面擷取所需資料。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ice:DescribeAIAgentInstance

    none

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    InstanceId

    string

    是

    智能體執行個體 ID。

    說明

    InstanceId 為智能體執行個體啟動成功後，返回的唯一的 Id。啟動智能體介面，請參見StartAIAgentInstance 、 GenerateAIAgentCall 。

    39f8e0bc005e4f309379701645f4****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    Instance

    object

    智能體執行個體資訊

    CallLogUrl

    string

    通話日誌的 URL。

    https://example.com/call_logs/12345
    RuntimeConfig AIAgentRuntimeConfig

    智能體運行時的配置資訊。

    {"VoiceChat":{"AgentUserId":"voice_agent_001","ChannelId":"voice_channel_001","AuthToken":"your_voice_chat_auth_token"}}
    Status

    string

    智能體執行個體的狀態，如 Finished，Executing。

    枚舉值：

    • Finished :

      結束

    • Executing :

      運行中

    Finished
    TemplateConfig deprecated AIAgentTemplateConfig

    智能體模版配置。

    {"VoiceChat": {"AppId": "your_voice_chat_app_id"}}
    UserData

    string

    使用者自訂資訊。

    {"Email":"johndoe@example.com","Preferences":{"Language":"en"}}
    SessionId

    string

    對話的唯一標記，預設無。

    955535**************
    AgentConfig AIAgentConfig

    智能體模版配置。

    GmtCreate

    string

    建立時間(UTC)

    2025-07-18T06:39:08.000+00:00
    GmtModified

    string

    修改時間(UTC)

    2025-07-18T06:40:12.000+00:00
    CallInfo AIAgentCallInfo

    RequestId

    string

    請求 ID。

    7B117AF5-2A16-412C-B127-FA6175ED1AD0

    錯誤碼

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

    變更歷史

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