QueryAiVoiceAgentDetail - 查询通信智能体详情信息

查询通信智能体详情信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
AgentIdstring

智能体 ID。

123123********

返回参数

名称类型描述示例值
object
AccessDeniedDetailstring

访问被拒绝的详细原因。

None
Messagestring

状态码描述。

成功
RequestIdstring

请求 ID。

742C9243-2870-B8D6-0C68-C60BEB2DF09A
Dataobject

智能体详情数据

Statuslong

智能体状态。

枚举值:
  • 1已上线
  • 2已下线
  • 3审核中
  • 4审核失败
  • 5构建中
  • 6调试中
  • 7可上线
  • 8构建失败
7
BusinessTypeNamestring

业务场景名称

个人线索转化
Descriptionstring

智能体说明。

日常测试使用。
AiVoiceAgentModelConfigobject

智能体模型配置。

BasicTaskDescriptionstring

基础任务配置。

任务描述。
MainPurposeobject

主意图配置。

MainPurposeEnumarray<object>

主意图可取值列表。

mainPurposeEnumobject
Descriptionstring

可取值说明。

意向强烈。
Valuestring

可取值。

A
Idstring

可取值唯一 ID。

d5606d80-7625-dcea-8610-17f66fbb564a
MainPurposeNamestring

主意图名称。

通话效果评级
MainPurposeTypestring

主意图取值类型。目前只有 ENUM 类型。

ENUM
MainPurposeDescriptionstring

主意图说明。

通话效果评级:A、B、C、D,(A最好)
Idstring

主意图 ID。

1ee6e994-08e0-5e87-f662-1659cc54d409
ChildTaskListarray<object>

子任务配置列表。

childTaskListobject
ChildTaskNamestring

子任务名称。

开场与邀约
ChildTaskDescriptionstring

子任务描述。

新用户邀约: \"喂,家长您好!我是*****的王老师,;我们现在有**课程100个试听名额,想帮宝贝安排一下体验,您看什么时候比较方便呢?\
Idstring

子任务唯一 ID。

280cd4bf-*******df472c
CustomExceptionFileNamestring

自定义异常文件名称。

异常测试文件.xlsx
BusinessTypelong

业务场景。

枚举值:
  • 1个人客户线索转化
  • 2企业客户线索转化
  • 3会员提醒-续费/复购场景
  • 4会员提醒-促销/赠券场景
  • 5简单客服-答疑类客服场景
  • 6其他
1
CustomExceptionUrlPathstring

废弃字段,后续会下掉。

-
KnowledgeIdstring

知识库 ID。

1232131*******
KnowledgeDocOriginalNameListarray

知识库文档原始文件名列表。

knowledgeDocOriginalNameListstring

文件名。

**会话引擎测试.xlsx
KnowledgeEnableboolean

是否关联知识库。

false
CustomExceptionEnableboolean

是否开启自定义异常处理。

false
Prologuestring

开场白。

你好,这里是******。
CustomExceptionFileIdstring

自定义异常文件 ID。

OSS文件ID
PhoneTagConfigarray<object>

通话变量配置。

phoneTagConfigobject
PhoneTagTypestring

变量值类型。

枚举值:
  • ENUM枚举类型
  • TEXT文本类型
ENUM
PhoneTagNamestring

变量中文名称。

意向车系
PhoneTagRequiredboolean

是否必填。

true
Idstring

变量唯一 ID。

280cd4bf-*******df472c
PhoneTagDescriptionstring

变量描述。

用户感兴趣的车系。
PhoneTagEnumarray<object>

变量枚举值列表。只有变量值类型为 ENUM 时才有该字段。

phoneTagEnumobject
Descriptionstring

枚举值描述。

客户完全不接受挽留
Valuestring

枚举值。

完全不接受
Idstring

枚举值唯一 ID。

c3d4ff4e-*********bc26dc044682
PhoneTagKeystring

变量键名。

testParam
FlowDescstring

高级任务流程描述。

这次外呼通过三个核心步骤与家长沟通,........ 3. 用户需求 > 主动介绍
UserRolestring

用户角色。

急需课程的新用户
TaskTypestring

任务类型。

枚举值:
  • BASIC基础任务
  • ADVANCED高级任务
ADVANCED
SysRolestring

系统角色。

课程销售
OutputTagConfigarray<object>

输出标签配置。

outputTagConfigobject
OutputTagDescriptionstring

标签描述信息。

记录本次通话的最终状态
OutputTagTypestring

标签值类型。

枚举值:
  • ENUM枚举类型
  • TEXT文本类型
ENUM
OutputTagEnumarray<object>

标签枚举值,只有标签值类型为 ENUM 时才有该字段。

outputTagEnumobject
Descriptionstring

标签枚举值描述。

高(非常积极,大概率转化)
Valuestring

标签枚举值。

Idstring

标签枚举值唯一 ID。

8757************2c499fa
OutputTagNamestring

标签名称。

客户意向度
Idstring

标签唯一 ID。

8757************2c499fa
CustomExceptionVoiceStylelong

语言风格。

枚举值:
  • 1平实
  • 2亲切
  • 3专业
  • 4严肃
2
CustomExceptionListarray<object>

废弃字段,后续会下掉。

customExceptionListobject
ExceptionTypestring

异常类型

-
SupportBreakboolean

是否支持打断。

false
Replystring

回复内容。

-
ExceptionSignboolean

是否作为异常标签输出。

true
KnowledgeDocNameListarray

知识文档名列表。

knowledgeDocNameListstring

文件名。

117d2********388f2a615be5c0d3546e.xlsx
KnowledgeDocIdListarray

知识文档 ID 列表。

knowledgeDocIdListstring

知识文档 ID。

12213******
KnowledgeNamestring

知识库名称。

测试知识库
VoiceStyleNamestring

语言风格名称。

亲切
AgentIdlong

智能体 ID。

12311212******
AgentNamestring

智能体名称。

测试智能体
AiVoiceAgentCallConfigobject

智能外呼语音配置。

VocabIdstring

热词 ID

afb2c43**********83e6df30551c11f7
TtsConfigobject

TTS 配置。

TtsVolumelong

TTS 播放的音量。

说明
  • 取值范围:0~100,默认值为 0。
  • 不设置值时,默认取大模型应用配置的音量。
  • 72
    TtsStylestring

    音色风格。

    longxiaoxia_v2p1
    TtsSpeedlong

    TTS 播放时的声音速度。

    说明
  • 取值范围:-200~200,默认值为 0;
  • 不设置值时,默认取大模型应用配置的声音速度;
  • 34
    EventConfigobject

    通话事件配置。

    MuteActiveboolean

    第一个静音是否唤起模型。

    false
    SessionTimeoutlong

    最大通话时长,超时后自动挂断。单位:秒。

    说明
  • 最大取值:3600s。
  • 最小取值:600s。
  • 600
    CallAssistantHangupboolean

    识别到智能接听是否挂断。

    false
    CallAssistantRecognizeboolean

    智能接听识别是否开启。

    true
    MuteDurationlong

    静音时长。

    说明
  • 最大取值:15s。
  • 最小取值:3s。
  • 10
    MuteHangupNumlong

    连续多少个静音事件主动挂机。

    说明
  • 最大取值:5。
  • 最小取值:1。
  • 1
    Codestring

    状态码。

    OK
    Successboolean

    调用接口是否成功。取值:

    • true:成功。
    • false:失败。
    false

    示例

    正常返回示例

    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-8610-17f66fbb564a"
              }
            ],
            "MainPurposeName": "通话效果评级",
            "MainPurposeType": "ENUM",
            "MainPurposeDescription": "通话效果评级:A、B、C、D,(A最好)",
            "Id": "1ee6e994-08e0-5e87-f662-1659cc54d409"
          },
          "ChildTaskList": [
            {
              "ChildTaskName": "开场与邀约",
              "ChildTaskDescription": "新用户邀约: \\\"喂,家长您好!我是*****的王老师,;我们现在有**课程100个试听名额,想帮宝贝安排一下体验,您看什么时候比较方便呢?\\",
              "Id": "280cd4bf-*******df472c"
            }
          ],
          "CustomExceptionFileName": "异常测试文件.xlsx",
          "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,
          "CustomExceptionList": [
            {
              "ExceptionType": "-",
              "SupportBreak": false,
              "Reply": "-",
              "ExceptionSign": true
            }
          ],
          "KnowledgeDocNameList": [
            "117d2********388f2a615be5c0d3546e.xlsx"
          ],
          "KnowledgeDocIdList": [
            "12213******"
          ]
        },
        "KnowledgeName": "测试知识库",
        "VoiceStyleName": "亲切",
        "AgentId": 0,
        "AgentName": "测试智能体",
        "AiVoiceAgentCallConfig": {
          "VocabId": "afb2c43**********83e6df30551c11f7",
          "TtsConfig": {
            "TtsVolume": 72,
            "TtsStyle": "longxiaoxia_v2p1",
            "TtsSpeed": 34
          },
          "EventConfig": {
            "MuteActive": false,
            "SessionTimeout": 600,
            "CallAssistantHangup": false,
            "CallAssistantRecognize": true,
            "MuteDuration": 10,
            "MuteHangupNum": 1
          }
        }
      },
      "Code": "OK",
      "Success": false
    }

    错误码

    访问错误中心查看更多错误码。

    变更历史

    变更时间变更内容概要操作
    2025-10-29新增 OpenAPI查看变更详情