GenerateAIAgentCall
创建一个智能体实例，返回智能体所在的频道、频道内名称以及进入频道所需的token
服务地址：
华东1（杭州）
输入参数
只看必填
AIAgentId智能体ID
Expire可选参数
UserId对话频道内用户名称
TemplateConfig智能体模版参数
VoiceChat语音通话参数
Greeting问候语
LlmHistoryllm/mllm历史对话上下文
0
Role表示对话参与者的角色
Content存储实际的对话内容文本
添加
WorkflowOverrideParams工作流覆盖参数
EnableIntelligentSegment智能断句开关
请选择布尔值
AvatarUrlType智能体头像链接类型
AvatarUrl语音通话的智能体头像的头像链接
VoiceIdList可选音色列表
0音色
添加
EnableVoiceInterrupt是否支持语音打断
请选择布尔值
VoiceprintId声纹识别的唯一身份ID
GracefulShutdown是否优雅下线
请选择布尔值
InterruptWords触发对话中断的特定词汇或短语列表
0触发对话中断的特定词汇或短语
添加
UserOnlineTimeout用户未入会
AsrLanguageIdasr语种Id
UserOfflineTimeout用户退会后
LlmSystemPrompt启动通话后llm的系统提示词
BailianAppParams百炼应用中心参数
VadLevel打断阈值参数
LlmHistoryLimitllm/mllm历史对话上下文最大保留轮次
AsrMaxSilence语音断句检测阈值
WakeUpQuery用户在通话启动前的指令
Volume智能体说话的音量
VoiceId音色ID
UseVoiceprint是否使用声纹识别的开关
请选择布尔值
MaxIdleTime和智能体无互动的最大等待时间
EnablePushToTalk是否开启对讲机模式
请选择布尔值
VisionChat视觉智能体参数
InterruptWords触发对话中断的特定词汇或短语列表
0触发对话中断的特定词汇或短语
添加
Greeting问候语
LlmHistoryllm/mllm历史对话上下文最大保留轮次
0
Role表示对话参与者的角色
Content存储实际的对话内容文本
添加
UserOnlineTimeout用户未入会
AsrLanguageIdasr语种Id
UserOfflineTimeout用户退会后
WorkflowOverrideParams工作流覆盖参数
LlmSystemPrompt启动通话后llm的系统提示词
EnableIntelligentSegment智能断句开关
请选择布尔值
BailianAppParams百炼应用中心参数
VadLevel打断阈值参数
LlmHistoryLimitllm/mllm历史对话上下文最大保留轮次
AsrMaxSilence语音断句检测阈值
WakeUpQuery用户在通话启动前的指令
Volume智能体说话的音量
VoiceIdList可选音色列表
0音色
添加
EnableVoiceInterrupt是否支持语音打断
请选择布尔值
VoiceprintId声纹识别的唯一身份ID
VoiceId音色ID
UseVoiceprint是否使用声纹识别的开关
请选择布尔值
MaxIdleTime和智能体无互动的最大等待时间
GracefulShutdown是否优雅下线
请选择布尔值
EnablePushToTalk是否开启对讲机模式
请选择布尔值
AvatarChat3D3d数字人参数
Greeting问候语
LlmHistoryllm/mllm历史对话上下文最大保留轮次
0
Role表示对话参与者的角色
Content存储实际的对话内容文本
添加
WorkflowOverrideParams工作流覆盖参数
EnableIntelligentSegment智能断句开关
请选择布尔值
VoiceIdList可选音色列表
0音色
添加
AvatarId数字人模型id
EnableVoiceInterrupt是否支持语音打断
请选择布尔值
VoiceprintId声纹识别的唯一身份ID
GracefulShutdown是否优雅下线
请选择布尔值
InterruptWords触发对话中断的特定词汇或短语列表
0触发对话中断的特定词汇或短语
添加
UserOnlineTimeout用户未入会
AsrLanguageIdasr语种Id
UserOfflineTimeout用户退会后
LlmSystemPrompt启动通话后llm的系统提示词
BailianAppParams百炼应用中心参数
VadLevel打断阈值参数
LlmHistoryLimitllm/mllm历史对话上下文最大保留轮次
AsrMaxSilence语音断句检测阈值
WakeUpQuery用户在通话启动前的指令
Volume智能体说话的音量
VoiceId音色ID
UseVoiceprint是否使用声纹识别的开关
请选择布尔值
MaxIdleTime和智能体无互动的最大等待时间
EnablePushToTalk是否开启对讲机模式
请选择布尔值
UserData用户自定义信息
SessionId对话的唯一标记
ChatSyncConfig同步聊天记录配置
IMAIAgentIdIM的智能体Id
ReceiverId接收用户Id
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

通过此 API，您可以根据提供的 AI 智能体 ID（AIAgentId）创建一个智能体实例。您可以通过 API 响应中的信息进入对应房间，与智能体进行对话。

注意 确保提供的 AI 智能体 ID 有效，并根据实际应用场景适当配置可选参数。

请求参数

字段名称字段详情
AIAgentIdstring

智能体 ID。

示例值:39f8e0bc005e4f309379701645f4****参考取值来源:
    StartAIAgentInstance
Expireinteger<int64>

可选参数，表示 token 失效的时间，单位秒，默认 3600 秒。取值范围 0~604800。

注意 该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。
示例值:3600
UserIdstring

对话频道内用户名称，不输入则系统自动生成。长度不超过 64。

示例值:877ae632caae49b1afc81c2e8194ffb4
TemplateConfigobject

智能体模版参数

UserDatastring

用户自定义信息。

示例值:{"Email":"johndoe@example.com","Preferences":{"Language":"en"}}
SessionIdstring

对话的唯一标记，默认无。

示例值:fw1gr0bc005e4f309379701645f4****
ChatSyncConfigobject

同步聊天记录配置。

返回参数

字段名称字段详情
AIAgentUserIdstring

ARTC 频道内智能体的名称。

示例值:877ae632caae49b1afc81c2e8194ffb4
ChannelIdstring

ARTC 频道 ID。

示例值:70f22d5784194938a7e387052f2b3208
InstanceIdstring

生成的智能体实例 ID。

示例值:39f8e0bc005e4f309379701645f4****
RequestIdstring

请求 ID。

示例值:7B117AF5-2A16-412C-B127-FA6175ED1AD0
Tokenstring

端侧的 ARTC Token。

示例值:eyJhcHBpZCI6ICIxMjM0MTIzNxxxxx
UserIdstring

ARTC 频道内用户名称。

示例值:user123
变更历史
变更时间变更内容概要操作
2025-02-27
新增请求参数ChatSyncConfig
2025-01-23
新增请求参数SessionId
2024-11-20
新增请求参数UserData