CreateScriptVersion - 创建场景版本

更新时间:
复制 MD 格式

创建场景配置。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

InstanceId

string

实例 ID

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

ScriptId

string

场景 ID

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

SourceVersionId

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

700

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

Params

array

错误信息中的变量值列表

string

错误信息中的变量值

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

Success

boolean

是否调用成功

true

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

更多信息,参考变更详情