查询实例。
接口说明
功能描述：此接口用于查询指定智能体实例的详细信息。
使用场景：当需要监控或分析智能体在通话中的表现，或者调试智能体配置效果时，可调用此接口获取所需数据。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
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 |
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 |
错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。