创建 AI 智能体，用于配置和启动智能体，例如智能语音助手、智能硬件智能体。更多详情，请参考 配置智能体。

• Agent 创建成功后，系统会自动分配唯一的 agentId。
• 发起请求时，agentName 和 llmPromptContent 必填，其他配置可以按需填写。

功能描述

• 支持多种 LLM 供应商配置，包括千问、OpenAI、百度等。
• 提供丰富的 TTS 音色选择和语音参数配置。
• 支持多种 ASR 供应商和语言识别配置。
• 支持语音打断、开场白、声纹识别等高级功能。

请求信息

请求 URI

POST https://rtc-agent.yunxinapi.com/v1/agent

请求头参数

请求 Header 的参数说明请参考 请求结构。

请求体参数

参数名称	类型	是否必选	示例	说明
agentName	String	是	"助手小易"	Agent 名称，长度限制 1-100 个字符
llmPromptContent	String	是	"作为网易云信的智能语音助手..."	LLM 提示词内容，长度限制 1-3000 个字符
- llmConfig	Object	否	-	LLM 配置
llmVendor	Number	否	1	LLM 供应商类型： 1：千问 2：openAI 5：豆包 9：DeepSeek 默认为 1
llmModel	String	否	"qwen-turbo"	模型名称，根据供应商提供的模型列表选择。默认为 qwen-plus
temperature	Number	否	0.8	温度参数，控制输出的随机性，范围 0-2，默认为 1
topP	Number	否	0.9	核采样阈值，控制输出的多样性，范围 0-1，默认为 0.9
maxTokens	Number	否	1000	生成的最大 token 数，范围 1-4000，默认为 4000
enableWebSearch	Boolean	否	true	是否启用网页搜索功能，默认为 false
contextSize	Number	否	10	上下文窗口大小，范围 1-20，表示保留的对话轮数，默认为 3
enableVision	Boolean	否	false	是否启用视觉功能，默认为 false
- ttsConfig	Object	否	-	TTS 音色相关配置
ttsVendor	Number	否	4	TTS 供应商： 3：千问(普通) 4：千问(cosyvoice) 5：miniMax 6：豆包 8：miniMax(流式) 100：网易云信克隆音色（可通过 克隆音色 获取） 默认为 6
ttsModel	String	否	-	TTS 模型名称（当 ttsVendor 供应商为 miniMax 时需要）
voice	String	否	"aiya"	音色名称，或者是克隆音色的 ID。音色设置范围受 ttsVendor 影响，例如： ttsVendor 如果设置为 100，则音色取值范围为克隆音色的 ID；ttsVendor 如果设置为 3 或者 4（千问），则普通音色取值范围为： siyue：温柔女声 aiya：严厉女声 aimei：甜美女声 zhiqing：台湾地区女性声音 默认为 zh_female_qingxinnvsheng_mars_bigtts
gender	String	否	"Female"	音色性别： Female(女声) Male(男声) 默认为 Female
language	String	否	"Chinese"	TTS 语言： Chinese(中文) English(英文) 默认为 Chinese
ignoreBracketTextSet	Array	否	[1,2]	过滤内容配置： 1：中文括号 2：英文括号 3：中文方括号 4：英文方括号 5：英文花括号 默认为 [1,2]
speed	Number	否	1	TTS 语速，取值范围 0.8-2，默认为 1 即正常语速
pitch	Number	否	1	TTS 语调，取值范围 -12-12，默认为 1 即正常语调
volume	Number	否	1	TTS 音量，取值范围 0.5-2，默认为 1 即正常音量
enableLatex	Boolean	否	flase	是否启用 Latex 播报，默认为 false
- asrConfig	Object	否	-	ASR 相关配置
asrVendor	Number	否	6	ASR 供应商： 6：阿里(实时音) 7：讯飞(短语音) 8：阿里(短语音) 9：火山引擎(实时音) 默认为 6
srcLan	String	否	"AUTO"	源语言设置，默认为 AUTO 表示自动识别语言，其他取值参考《音视频通话 2.0 字母与翻译》语言列表。
maxSentenceSilence	Number	否	500	断句静音时长，单位为毫秒(ms)，用于控制语音识别的断句时机，默认值为 200
enableSaveAudio	Boolean	否	false	是否保存语音文件，默认为 false 表示不保存
enableSemanticVad	Boolean	否	true	是否启用语义 VAD（语音活动检测），默认为 true
vocabularyId	String	否	498ab652265	热词库 ID，可提高 ASR 识别准确率（仅 asrVendor 为阿里和火山引擎支持）
- agentConfigProperties	Object	否	-	Pipeline 设置等高级配置
useMemory	Boolean	否	true	是否启用记忆功能，默认为 true
enableMemoryByVoicePrint	Boolean	否	true	是否按声纹存储记忆，默认为 true。开启该功能前，需要先开启 useMemory 和 enableSpeakerVerify
- pipeline	Object	否	-	Pipeline 配置对象
interruptMode	Number	否	1	打断模式： 0：禁用语音打断 1：开始说话时打断 2：结束说话时打断 4：打断词打断 默认为 2
interruptWords	Array	否	-	自定义打断词列表（当 interruptMode 为 4 时该配置生效），最多 3 个，每个长度不超过 15
enableWelcomeMessage	Boolean	否	true	是否启用开场白，默认为 true
welcomeMessage	String	否	"您好，我是小易..."	自定义开场白内容
enablePause	Boolean	否	false	是否启用会话暂停功能，默认为 false
- serverAudioProcess	Object	否	-	服务端音频处理配置
enableServerAec	Boolean	否	true	是否启用云端回声消除，默认为 false
serverAnsMode	Number	否	1	云端 AI 降噪模式： 0：关闭 1：普通 2：增强 默认为 0
enableSpeakerVerify	Boolean	否	false	是否启用声纹识别，默认为 false
speakerVerifyLevel	Number	否	1	声纹验证等级： 0：宽松 1：标准 2：严格 默认为 1
enableSpeakerLock	Boolean	否	false	是否启用声纹锁定，默认为 false
enableShowSpeakerInAsrResult	Boolean	否	false	字幕是否显示说话人信息，默认为 false

请求体示例

JSON{
    "agentName": "助手小易",
    "llmPromptContent": "作为网易云信的智能语音助手，我遵循以下原则：我的名字叫小易，我的回答语气可爱乖巧，和真正的人类对话一样，内容清晰全面，但不超过 50 个词, 不回复表情和表情符号",
    "ttsConfig": {
        "ttsVendor": 4,
        "voice": "longqiang",
        "language": "Chinese",
        "ignoreBracketTextSet": [
            1,
            2
        ]
    }
}

响应信息

响应参数

参数名称	类型	说明	是否必返回
code	Integer	响应状态码，200 表示成功	是
msg	String	响应消息，成功时返回 "success"	是
requestId	String	请求 ID，用于问题定位和日志跟踪	是
- data	Object	响应数据对象	是
agentId	String	Agent 唯一标识符，用于后续调用和管理	是

响应体示例

JSON{
  "code": 200,
  "msg": "success",
  "data": {
    "agentId": "agent_20231215_123456789"
  },
  "requestId": "req_20231215_abcdef123456"
}

错误码

本文仅列举部分业务接口错误码，完整列表请参考 错误码。

错误码	说明	处理建议
400	参数格式错误或缺少必填参数	检查请求参数格式和必填字段
402	参数值不符合规范要求	检查参数值是否在允许范围内