AI 助理
文档备案控制台
官方文档
首页 智能外呼机器人 开发参考 API参考（4.0） API目录 场景管理 UpdateScriptVersion - 更新场景版本

UpdateScriptVersion - 更新场景版本

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

更新场景配置。

接口说明

调试

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

调试

授权信息

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

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

outboundbot:UpdateScriptVersion

update

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
InstanceId

string

否

实例 ID

4f9a8e2b-6c1d-4a7e-9b3f-2d5c8a1e7b04
ScriptId

string

否

场景 ID

4f9a8e2b-6c1d-4a7e-9b3f-2d5c8a1e7b15
VersionId

string

否

版本 ID

4f9a8e2b-6c1d-4a7e-9b3f-2d5c8a1e7b26
TranscriberConfig

object

否

ASR 配置

NlsAccessType

string

否

ASR 调用方式

枚举值：

  • PROVIDED :

    PROVIDED

  • MANAGED :

    MANAGED

MANAGED
NlsEngine

string

否

ASR 引擎

枚举值：

  • TENCENT :

    TENCENT

  • IFLYTEK :

    IFLYTEK

  • VOLC :

    VOLC

  • BAILIAN :

    BAILIAN

BAILIAN
NlsAccessProfile

object

否

关联配置

AccessProfileId

string

否

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

c2c9baae-9351-4c49-a8cb-6f24a83a8718
VocabularyId

string

否

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

cd97223f-42f2-4cd9-95af-e734e2fe1fe3
EndSilenceTimeout

integer

否

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

700
CustomizationId

string

否

ASR 的定制语言模型 ID

cd97223f-42f2-4cd9-95af-e734e2fe1472
SpeechNoiseThreshold

integer

否

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

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

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

0
Model

string

否

ASR 模型

Paraformer
CorrectionRules

array<object>

否

ASR 纠错词典

object

否

Pattern

string

否

识别错误文本

啊里巴巴
Replacement

string

否

纠正后文本

阿里巴巴
SynthesizerConfig

object

否

TTS 配置

NlsAccessType

string

否

TTS 调用方式

枚举值：

  • PROVIDED :

    PROVIDED

  • MANAGED :

    MANAGED

MANAGED
NlsEngine

string

否

TTS 引擎

枚举值：

  • IFLYTEK :

    IFLYTEK

  • VOLC :

    VOLC

  • BAILIAN :

    BAILIAN

BAILIAN
NlsAccessProfile

object

否

关联配置

AccessProfileId

string

否

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

c2c9baae-9351-4c49-a8cb-6f24a83a8718
Model

string

否

TTS 模型

枚举值：

  • CosyVoice :

    CosyVoice

  • Qwen :

    Qwen

  • iflytek-default :

    iflytek-default

  • seed-tts-2.0 :

    seed-tts-2.0

CosyVoice
Voice

string

否

发音人

longanyang
SpeechRate

integer

否

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

0
Volume

integer

否

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

50
PitchRate

integer

否

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

0
PronRules

array<object>

否

TTS 纠错词典

object

否

Pattern

string

否

易错字/词

还钱
Replacement

string

否

同音字/词

环钱
ScriptProfile

object

否

对话能力配置

ChatbotId

string

否

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

chatbot-cn-MQuyjjb666
AgentKey

string

否

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

1309723684579735_p_beebot_public
BuilderType

string

否

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

枚举值：

  • LITE :

    LITE

  • FLOW :

    FLOW

LITE
FunctionMeta

object

否

函数计算配置

RegionId

string

否

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

cn-hangzhou
FunctionId

string

否

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

9b752bbb-805a-4d3e-9013-eab5555c3fef
FunctionName

string

否

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

my_funciton
HttpTriggerUrl

string

否

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

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

string

否

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

defaultTrigger
Model

string

否

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

qwen-plus
AgentProfile

object

否

对话 Agent 配置

ScriptProfileTemplateId

string

否

场景模版 ID

OUTBOUND_BOT_PROMPTS_DEFAULT
PromptsJson

string

否

提示词 json

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

object

否

关联配置

AccessProfileId

string

否

三方对话模型配置 ID

c2c9baae-9351-4c49-a8cb-6f24a83a8718
OmniModel

boolean

否

是否为 Omni 模型

true
NluAccessType

string

否

对话模型调用方式

MANAGED
InteractionConfig

object

否

交互配置

SilenceDetectionConfig

object

否

静默检测配置

Timeout

integer

否

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

5000
MaxRepeats

integer

否

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

3
Prompt

string

否

静默提示词

- 复述上一轮对话的内容 - 保证上下文自然衔接
FallbackControlParamsList

array<object>

否

连续静默时执行操作列表

object

否

Type

string

否

连续静默时执行操作

HangUp
EndConversationConfig

object

否

挂机配置

Delay

integer

否

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

1
BargeInEnabled

boolean

否

延迟挂机等待过程中是否支持打断

true
Triggers

array<object>

否

特殊情况拦截

object

否

TriggerType

string

否

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

TurnLimit
TurnLimit

integer

否

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

20
ClosingStatement

string

否

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

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

array

否

自定义拦截关键词列表

string

否

自定义拦截关键词

机器人助理
InitialGreetingDelayMilliseconds

integer

否

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

2000
BackgroundMusicId

string

否

背景音 ID

office-ambience
TransitionConfig

object

否

承接语模型配置

TransitionSwitch

boolean

否

是否开启承接语

true
PhraseSource

string

否

承接语生成方式
aiGenerated：模型生成
fixedPhrase：固定话术




枚举值：

  • aiGenerated :

    aiGenerated

  • fixedPhrase :

    fixedPhrase

aiGenerated
AiPhrasePrompt

string

否

模型生成提示词

请根据下面对话记录中用户的最新回复，生成一句简短承接语，用于客服自然、顺畅地衔接对话，要求如下： 1. 使用客服场景常用的口语化表达，保持语气自然、礼貌且中立......
FixedPhraseList

array

否

固定话术承接语列表

string

否

固定话术承接语

好的
BargeInConfig

object

否

打断配置

OpeningBargeInEnabled

boolean

否

开场白是否支持打断

true
GlobalBargeInEnabled

boolean

否

对话过程中是否支持打断

true
ClosingBargeInEnabled

boolean

否

结束语是否支持打断

true
LabelConfigs

array<object>

否

标签配置

object

否

Name

string

否

标签名称

满意度
Description

string

否

描述

描述用户对本次服务是否满意
CandidateValues

array

否

标签可选值

string

否

标签值

非常满意

返回参数

名称

类型

描述

示例值

object

Schema of Response

Code

string

返回码

OK
HttpStatusCode

integer

HTTP 状态码

200
Message

string

错误信息

Instance does not exist. Instance=outb003
RequestId

string

请求 ID

019FDAC7-13C5-1B64-A853-999DF105B9EF
Data

string

场景版本 ID

4f9a8e2b-6c1d-4a7e-9b3f-2d5c8a1e7b26
Success

boolean

是否调用成功

true
Params

array

错误信息中的变量值列表

string

错误信息中的变量值

4f9a8e2b-6c1d-4a7e-9b3f-2d5c8a1e7b04

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "Instance does not exist. Instance=outb003",
  "RequestId": "019FDAC7-13C5-1B64-A853-999DF105B9EF",
  "Data": "4f9a8e2b-6c1d-4a7e-9b3f-2d5c8a1e7b26",
  "Success": true,
  "Params": [
    "4f9a8e2b-6c1d-4a7e-9b3f-2d5c8a1e7b04"
  ]
}

错误码

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

变更历史

更多信息，参考变更详情。

上一篇：场景管理下一篇：UpdateScript - 更新场景