查询通信智能体详情信息。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| aiccs:QueryAiVoiceAgentDetail | get | *全部资源 * |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| AgentId | string | 否 | 智能体 ID。 | 123123******** |
返回参数
示例
正常返回示例
JSON格式
{
"AccessDeniedDetail": "None",
"Message": "成功",
"RequestId": "742C9243-2870-B8D6-0C68-C60BEB2DF09A",
"Data": {
"Status": 7,
"BusinessTypeName": "个人线索转化",
"Description": "日常测试使用。",
"AiVoiceAgentModelConfig": {
"BasicTaskDescription": "任务描述。",
"MainPurpose": {
"MainPurposeEnum": [
{
"Description": "意向强烈。",
"Value": "A",
"Id": "d5606d80-7625-dcea-xxxx-17f66fbb564a"
}
],
"MainPurposeName": "通话效果评级",
"MainPurposeType": "ENUM",
"MainPurposeDescription": "通话效果评级：A、B、C、D，（A最好）",
"Id": "1ee6e994-08e0-xxxx-f662-1659cc54d409"
},
"ChildTaskList": [
{
"ChildTaskName": "开场与邀约",
"ChildTaskDescription": "新用户邀约: \\\"喂，家长您好！我是*****的王老师，我们现在有**课程100个试听名额，想帮宝贝安排一下体验，您看什么时候比较方便呢？\\",
"Id": "280cd4bf-*******df472c"
}
],
"CustomExceptionFileName": "异常测试文件.xlsx",
"StartWordType": 1,
"BusinessType": 1,
"CustomExceptionUrlPath": "-",
"KnowledgeId": "1232131*******",
"KnowledgeDocOriginalNameList": [
"**会话引擎测试.xlsx"
],
"KnowledgeEnable": false,
"CustomExceptionEnable": false,
"Prologue": "你好，这里是******。",
"CustomExceptionFileId": "OSS文件ID",
"PhoneTagConfig": [
{
"PhoneTagType": "ENUM",
"PhoneTagName": "意向车系",
"PhoneTagRequired": true,
"Id": "280cd4bf-*******df472c\n",
"PhoneTagDescription": "用户感兴趣的车系。",
"PhoneTagEnum": [
{
"Description": "客户完全不接受挽留",
"Value": "完全不接受",
"Id": "c3d4ff4e-*********bc26dc044682"
}
],
"PhoneTagKey": "testParam"
}
],
"FlowDesc": "这次外呼通过三个核心步骤与家长沟通，........ 3. 用户需求 > 主动介绍",
"UserRole": "急需课程的新用户",
"TaskType": "ADVANCED",
"SysRole": "课程销售",
"OutputTagConfig": [
{
"OutputTagDescription": "记录本次通话的最终状态",
"OutputTagType": "ENUM",
"OutputTagEnum": [
{
"Description": "高（非常积极，大概率转化）",
"Value": "高",
"Id": "8757************2c499fa"
}
],
"OutputTagName": "客户意向度",
"Id": "8757************2c499fa\n"
}
],
"CustomExceptionVoiceStyle": 2,
"RecordingFile": "示例值",
"CustomExceptionList": [
{
"ExceptionType": "-",
"SupportBreak": false,
"Reply": "-",
"ExceptionSign": true
}
],
"KnowledgeDocNameList": [
"117d2********388f2a615be5c0d3546e.xlsx"
],
"KnowledgeDocIdList": [
"12213******"
]
},
"KnowledgeName": "测试知识库",
"VoiceStyleName": "亲切",
"AgentId": 0,
"AgentName": "测试智能体",
"AiVoiceAgentCallConfig": {
"VocabId": "afb2c43**********83e6df30551c11f7",
"TtsConfig": {
"VoiceCode": "示例值",
"MixingTemplate": 1,
"BackgroundEnabled": true,
"TtsVolume": 72,
"TtsStyle": "longxiaoxia_v2p1",
"VoiceType": "示例值",
"MixingEnabled": true,
"TtsSpeed": 34,
"BackgroundSound": 1,
"BackgroundVolume": 1
},
"EventConfig": {
"MuteActive": false,
"SessionTimeout": 600,
"CallAssistantHangup": false,
"CallAssistantRecognize": true,
"MuteDuration": 10,
"MuteHangupNum": 1
}
}
},
"Code": "OK",
"Success": false
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2025-10-29 | 新增 OpenAPI | 查看变更详情 |