AI 助理
文档备案控制台
官方文档
输入文档关键字查找
首页

CreateScriptVersion - 创建场景版本

更新时间：
复制为 MD 格式
产品详情
我的收藏

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用前面加 * 表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
voicebot:CreateScriptVersioncreate
*全部资源
*
    无
无

请求参数

名称类型必填描述示例值
InstanceIdstring是

实例 ID。

abb4aa26-3a8e-43dd-82f8-0c3898c9c67f
ScriptIdstring是

场景 ID

64241e64-190c-45d1-af66-06f51c07b090
TranscriberConfigobject否

ASR 配置

NlsAccessTypestring否

ASR 调用方式

枚举值：
  • PROVIDED：PROVIDED。
  • MANAGED：MANAGED。
MANAGED
NlsEnginestring否

ASR 引擎

枚举值：
  • IFLYTEK：IFLYTEK。
  • VOLC：VOLC。
  • BAILIAN：BAILIAN。
BAILIAN
NlsAccessProfileobject否

关联配置

AccessProfileIdstring否

三方语音配置 ID（使用豆包、科大等三方 ASR 服务时需配置）

c2c9baae-9351-4c49-a8cb-6f24a83a8718
VocabularyIdstring否

热词表 ID（热词管理页面获取）

cd97223f-42f2-4cd9-95af-e734e2fe1fe3
EndSilenceTimeoutinteger否

静音检测（说话间隔超过 x 毫秒时触发断句，即 VAD）

700
CustomizationIdstring否

ASR 的定制语言模型 ID

cd97223f-42f2-4cd9-95af-e734e2fe1fe4
SpeechNoiseThresholdinteger否

噪音参数阈值，参数范围：[-100,100]。取值说明如下：

取值越趋于-100，噪音被判定为语音的概率越大。

取值越趋于+100，语音被判定为噪音的概率越大。

0
Modelstring否

ASR 模型

Paraformer
SynthesizerConfigobject否

TTS 配置

NlsAccessTypestring否

TTS 调用方式

枚举值：
  • PROVIDED：PROVIDED。
  • MANAGED：MANAGED。
MANAGED
NlsEnginestring否

TTS 引擎

枚举值：
  • IFLYTEK：IFLYTEK。
  • VOLC：VOLC。
  • BAILIAN：BAILIAN。
BAILIAN
NlsAccessProfileobject否

关联配置

AccessProfileIdstring否

三方语音配置 ID（使用豆包、科大等三方 ASR 服务时需配置）

c2c9baae-9351-4c49-a8cb-6f24a83a8718
Modelstring否

TTS 模型

枚举值：
  • CosyVoice：CosyVoice。
  • Qwen：Qwen。
  • iflytek-default：iflytek-default。
  • seed-tts-2.0：seed-tts-2.0。
CosyVoice
Voicestring否

发音人

longanyang
SpeechRateinteger否

语速
取值范围-500~500
默认值 0

0
Volumeinteger否

音量
取值范围 0~100
默认值 50

50
PitchRateinteger否

语调
取值范围 -500~500
默认值 0

0
PronRulesarray<object>否

TTS 纠错列表

object否
Patternstring否

易错词

还钱
Replacementstring否

同音词

环钱
ScriptProfileobject否

对话能力配置

ChatbotIdstring否

对话机器人 ID
当前场景 NluEngine=BEEBOT 时必填

chatbot-cn-MQuyjjb666
AgentKeystring否

对话机器人 AgentKey
当前场景 NluEngine=BEEBOT 时必填

1309723684579735_p_beebot_public
FunctionMetaobject否

函数计算配置

RegionIdstring否

函数服务所在地域
当前场景 NluEngine=FUNCTION 时必填

cn-hangzhou
FunctionIdstring否

函数服务 ID
当前场景 NluEngine=FUNCTION 时必填

9b752bbb-805a-4d3e-9013-eab5555c3fef
FunctionNamestring否

函数服务名称
当前场景 NluEngine=FUNCTION 时必填

my_funciton
HttpTriggerUrlstring否

函数触发器 URL
当前场景 NluEngine=FUNCTION 时必填

http://chat-xxxxx-v-yewiundukb.cn-hangzhou-xxx.run
HttpTriggerNamestring否

函数触发器名称
当前场景 NluEngine=FUNCTION 时必填

defaultTrigger
Modelstring否

对话模型
当前场景 NluEngine=PROMPTS 时必填

qwen-plus
AgentProfileobject否

对话 Agent 配置

ScriptProfileTemplateIdstring否

场景模版 ID

枚举值：
  • CCC_PROMPTS_DEFAULT：CCC_PROMPTS_DEFAULT。
  • CCC_PROMPTS_DEFAULT_OPENING：CCC_PROMPTS_DEFAULT_OPENING。
  • CCC_PROMPTS_SURVEY：CCC_PROMPTS_SURVEY。
CCC_PROMPTS_DEFAULT
PromptsJsonstring否

提示词 json

{\"prompts\":\"我是一个聊天机器人。\"}
NluAccessProfileobject否

关联配置

AccessProfileIdstring否

三方对话模型配置 ID

c2c9baae-9351-4c49-a8cb-6f24a83a8718
OmniModelboolean否

是否为 Omni 模型

true
NluAccessTypestring否

对话模型调用方式

MANAGED
InteractionConfigobject否

交互配置

SilenceDetectionConfigobject否

静默检测配置

Timeoutinteger否

静默超时时间，单位毫秒。
用户静默超过设定值时，播报静默超时话术。
范围 2000~10000。

5000
MaxRepeatsinteger否

连续静默轮次挂机
当前场景 NluEngine=PROMPTS 时生效

3
EndConversationConfigobject否

挂机配置

Delayinteger否

挂机话术播报完成 x 秒后，执行挂机动作。 范围 0~5

1
Triggersarray<object>否

特殊情况拦截

object否
TriggerTypestring否

TurnLimit：最多交互轮次判断；
IntelligentVoiceAssistant：语音助手；
InteractiveVoiceResponse：分机号转接；
KeyWords：自定义拦截

TurnLimit
TurnLimitinteger否

当交互轮次超过 x 轮时，执行挂机。 范围 0~100。 等于 0 表示不开启超出轮次挂机。

20
ClosingStatementstring否

达到轮次上限，执行挂机时的播报话术。

感谢您的接听，祝您生活愉快，再见!
KeyWordsarray否

自定义拦截关键词列表

string否

自定义拦截关键词

机器人助理
InitialGreetingDelayMillisecondsinteger否

接通后，延迟放音时间
单位毫秒

2000
BackgroundMusicIdstring否

背景音 ID

office-ambience
LabelConfigarray<object>否

自定义标签配置

object否
Namestring否

标签名称

是否同意还款
Descriptionstring否

标签描述

用户是否同意于还款截止日期前还款
CandidateValuesarray否

标签可选值列表

string否

标签可选值

同意

返回参数

名称类型描述示例值
object

Schema of Response

Codestring

内部错误码

OK
HttpStatusCodeinteger

http 状态码

200
Messagestring

错误信息

Instance af81a389-91f0-4157-8d82-720edd02b66a does not exist.
RequestIdstring

请求 ID

C00486CA-8025-5ED8-9AA5-E0AFBA87A098
Datastring

版本 ID

af81a389-91f0-4157-8d82-720edd02b66b
Paramsarray

动态错误参数列表

paramstring

动态错误参数

af81a389-91f0-4157-8d82-720edd02b66a

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "Instance af81a389-91f0-4157-8d82-720edd02b66a\n does not exist.",
  "RequestId": "C00486CA-8025-5ED8-9AA5-E0AFBA87A098",
  "Data": "af81a389-91f0-4157-8d82-720edd02b66b",
  "Params": [
    "af81a389-91f0-4157-8d82-720edd02b66a"
  ]
}

错误码

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

变更历史

变更时间变更内容概要操作
2026-04-20API 内部配置变更，不影响调用查看变更详情
2026-04-07OpenAPI 入参发生变更查看变更详情
2026-04-07新增 OpenAPI查看变更详情
上一篇：GetScript - 获取场景脚本配置下一篇：CreateLlmAccessProfile - 创建三方模型配置