查询指定智能体的详细信息，包括基础信息、分支信息、版本信息等。
接口说明
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| aiccs:QueryAiVoiceAgentDetailNew | get | *全部资源 * |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| BranchId | string | 否 | 分支 ID。为空时自动定位到当前生效分支。 | 12 |
| AgentId | string | 是 | 智能体 ID。 | 1234***5678 |
| VersionId | string | 否 | 版本 ID。为空时取对应分支的最新发布版本。需与 BranchId 配合使用。 | 21 |
返回参数
示例
正常返回示例
JSON格式
{
"AccessDeniedDetail": "None",
"RequestId": "742C9243-2870-B8D6-0C68-C12345AABBCC0",
"Message": "成功",
"Data": {
"AgentCallConfig": {
"StartWordType": 1,
"Prologue": "你好，这里是******。",
"VocabId": "afb2c43**********83e6df30551c11f7",
"TtsConfig": {
"VoiceCode": "V123ABC00",
"MixingTemplate": 1,
"BackgroundEnabled": true,
"TtsVolume": 88,
"TtsStyle": "longxiaoxia_v2p1",
"ResourceId": "voice-12345",
"CustomerAccountId": 75,
"VoiceType": true,
"MixingEnabled": true,
"TtsSpeed": 0,
"BackgroundSound": 17,
"BackgroundVolume": 1
},
"EventConfig": {
"MuteActive": true,
"SessionTimeout": 1000,
"CallAssistantHangup": false,
"CallAssistantRecognize": true,
"MuteDuration": 5,
"MuteHangupNum": 1
},
"RecordingFile": "/oss-file-key",
"TransferConfig": {
"SeatRouteName": "人工座席",
"CalledNumber": 123111122222,
"CustomerRouteCode": 123,
"CallingNumberType": 1,
"Enabled": false,
"CallerNumberType": 48,
"ExtraInfo": "Additional information for the agent",
"TransferType": 73,
"CallingNumber": 123111122222,
"CallerNumber": 123111122222,
"TransferBizId": 123,
"SeatRouteCode": "SEAT_CTI_A_NET",
"TransferContent": "提示语",
"FailureContent": "失败说明"
}
},
"AgentMode": 1,
"BranchDesc": "默认分支",
"BranchDeployStatus": 1,
"BranchId": 18,
"BranchName": "默认版本",
"Scene": "个人客户线索转化",
"AgentDemandConfig": {
"BasicTaskDescription": "进行产品营销，介绍优势特点",
"CoreTarget": "销售线索转化",
"AiGenerate": false,
"UserRole": "潜在客户",
"BusinessType": 1,
"SysRole": "销售"
},
"SummaryConfig": {
"MainPurpose": {
"MainPurposeEnum": [
{
"Description": "Description of the tag value",
"Value": "Tag value example",
"Id": "tag_12345"
}
],
"MainPurposeName": "Customer inquiry handling",
"MainPurposeType": "ENUM",
"MainPurposeDescription": "Description of the main intent",
"Id": 123
},
"CallResultTagConfig": {
"MappingTag": {
"key": "\"CANCEL\": \"{\\\"tag\\\":\\\"test\\\",\\\"desc\\\":\\\"11\\\"}\""
},
"DefaultTag": {
"Desc": "标签说明",
"Tag": "标签1"
}
},
"OutputTagConfig": [
{
"OutputTagDescription": "用户购买产品的意愿",
"OutputTagType": "ENUM",
"OutputTagEnum": [
{
"Description": "用户有较高购买意愿",
"Value": "高意愿",
"Id": 10
}
],
"OutputTagName": "购买意愿",
"Id": 123
}
]
},
"PhoneTagConfig": [
{
"PhoneTagType": "ENUM",
"PhoneTagName": "用户性别",
"PhoneTagRequired": false,
"Id": 123,
"PhoneTagSource": "MANUAL_CREATE",
"PhoneTagKey": "gender",
"PhoneTagEnum": [
{
"Description": "gender",
"Value": "male",
"Id": 123
}
]
}
],
"AgentDesc": "日常测试使用。",
"AgentId": 3021893791,
"AgentName": "测试智能体",
"KnowledgeConfig": {
"KnowledgeIds": [
{
"KnowledgeName": "产品知识库",
"KnowledgeId": 68
}
],
"RagConfig": {
"Description": "知识库检索",
"Enabled": false
}
},
"VersionId": 89,
"VersionPublishTime": "2024-01-15 10:30:00 ",
"VersionPublishStatus": 1,
"VersionName": "测试版本1",
"VersionDesc": "测试第一个版本"
},
"Code": "OK",
"Success": true
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2026-05-18 | OpenAPI 返回结构发生变更 | 查看变更详情 |
| 2026-05-14 | 新增 OpenAPI | 查看变更详情 |