1. 平台简介
晓悟剧本编辑平台是一款基于自然语言处理（NLP）和人工智能（AI）技术，是齐悟机器人团队所研发的，面向创作开发者提供易学易用的创作互动小说作品的平台。创作者可以使用该平台创建互动小说，为机器人配置话语意图以实现交互对话，使用对话剧情配置意图实现多轮对话与语音测试服务（如语音版测试等），并将机器人部署在不同终端上（如网站、移动APP、智能硬件等）。
剧本编辑开发平台已经预置了常用的数百个意图理解模型，不需要开发者提供语料数据，就可以理解各种不同的表达，支持各种复杂句子理解及多轮对话。
创作者可以直接开发互动小说，开发环节所花费的时间比写剧本更少。不需要会写代码，也不需要懂自然语言处理。任何人都可以自学，一个小时内掌握开发方法，帮助您快速创作出属于自己的吸引人的语音互动作品，并降低开发成本，使用简单，效果强大！
通过不断更新改进意图和理解模型，不断提升开发平台的自主开放能力。
1.1.编写目的
1.2.主要用途及使用范围
1.3.使用环境条件
1.4.平台特性
1.5. 名词和术语
角色：
每个小说或故事下有多个不同的角色，角色是指的说话人物。
注意：默认新建是“旁白”的类别，也可以自定义编辑角色名称。
旁白角色：
用于当前剧情的背景信息介绍，用于交代好剧情的背景信息，包括什么人发生了什么事情。
多个角色：
同一个剧情里面，有多个人、多个角色说话。
剧情：
新增的剧情，是机器人播报的情节内容部分，即就是把机器人需要播报的文本情节内容部分都按照剧情情节和对应的角色，进行拆分录入。
注意：剧情要注意衔接，写完之后自己要连起来读一读，看是否连贯，剧情跟前面有无冲突。
剧情跳转：
从剧情A跳到剧情B，也就是剧情A下面设置的下一步跳转，包括从剧情A下面添加分支设置下一步跳转到剧情B或者合并剧情的下一步剧情B。
2.1.1 步骤1-2创建账号
步骤1 创建账号
进入晓悟互动小说创作平台，点击【注册账号】，进入注册账户页面。在注册账户页面输入相关信息后，点击【注册】，完成账号的创建。
步骤2 创建项目
创建账号登录完毕后，点击页面上的【新增项目】，默认创建第1个作品，可以对默认的作品名称进行重命名对应的作品名称。
输入对应作品名称，例如求生记,然后点击【确定】，完成一个作品的创建。
2.1.2 步骤3添加剧情
添加剧情
创建项目作品后，点击刚刚新建的作品卡片。进入的对应作品的剧情编辑界面。
新建的作品默认是没有剧情的。等待新增相关剧情或者导入作品剧情。
3.1.添加剧情
（1）点击顶部的【+新增剧情】入口，进入新增文本剧情弹框页面。
（2）输入剧情点编号：格式：数字-数字，可从1-1开始。
（3）点击新增剧情：将进入角色和剧情的编辑。
（4）默认新建的角色是“旁白”，鼠标点击即可进行角色名称进行修改。
（5）剧情文本框：在当前文本框中输入当前角色说的剧情文本。
（6）新建图标：点击用来新增新角色及剧情文本。
（7）修改角色名称，鼠标点击即可进行角色名称进行修改。
（8）剧情文本框：输入对应角色说的剧情文本。
（9）以上步骤完成之后，点击【提交】按钮，完成一个剧情的创建。
以上步骤大的图片如下图展示：
2.1.3 步骤4添加分支和意图
添加分支和意图
1. 添加剧情的分支（用户可能回答的方向）
（1）点击角色和剧情底部的【添加分支】按钮，进入添加分支和意图的操作。
（2）新增分支，设置当前剧情的下一步跳转的剧情编号，即提示的请输入下一步编号：1-1或1-2。
默认的分支名称，是从分支1开始，分支名称可以不用重新命名。
（3）设置完下一步跳转剧情后，卡片紫色展示。
（4）分支剧情的文本输入框内，默认提示请简要输入用户该回答方向可能会说的话语例句，多句可用加号连接或者换行。如果无论用户说什么都跳转到下一步剧情，请填写‘兜底跳转’。根据上面角色剧情的引导，填写相关剧情分支内容。
2.添加意图（用户回答例句的识别意图）
（5）点击分支剧情右边的【+添加新意图】，即可进入意图搜索和意图选择界面。
（6）弹出的添加意图的弹框页面，包括输入文本框、搜索按钮等操作。
（7）在添加意图的弹框页面，输入上面第（4）步写的剧情分支内容。
（8）点击【搜索】按钮。
（9）搜索出来的结果底部展示出来符合意图结构的意图组名称和对应的例句，根据例句勾选对应的意图组，最后点击【确认】按钮。
注明：
绿色：表示全匹配。
搜索的句子符合意图组的结构，并且句子中的关键词也在意图组预设的的词组里。
蓝色：表示模糊匹配。
有etc开放值域的意图组可以加词，系统会把搜索的句子里的词，试着加到etc词组里，如果符合意图组的结构，放进去能被识别。
橙黄：表示名称匹配。
搜索的句子为意图组的名字，并且不满足绿色和蓝色的条件。
重复第（7）、（8）、（9）步骤，添加其它剧情分支内容进行搜索勾选意图。
（11）鼠标点击添加完的意图组名称。
（12）点击完对应意图组的名称，进入到当前意图组的详情展示。如果词组部分的内容为空，表示不需要添加项目的词组
（13）当前意图组的详情展示，如果词组部分的内容不为空，输入框内已经默认预置了可供参考的词组；
（14）根据当前作品的剧情分支的话术添加相关的词组，在项目词组施予帮助者词组下修改，当前意图例句是（张三）帮你根据剧情这里的“张三”要替换为“我”就是我帮你词组里的我目前用英文visitor代替。
（15）修改完意图的项目词组后，最后点击【保存】按钮今天确认保存。
3.提交剧情
（16）点击分支底部的【提交剧情】按钮，即可对前面的操作进行提交保存相关数据。
（17）提交成功的页面反馈展示，若存在提交失败请及时跟我们沟通联系。
2.1.4 步骤5生成对话
1.生成对话 2.对话测试
生成对话及测试对话
（1）点击作品剧情顶部的【生成】按钮，即可打开生成作品bot的弹框页面。
（2）在生成bot弹框页的输入框输入需要开始的剧情，一般情况下就是输入第一个剧情编号即可，最后点【生成】按钮即可生成当前的互动对话作品。也可以在实际开发中，输入指定的剧情编号生成互动对话作品。
（3）提交成功的页面反馈展示，若存在提交失败请及时跟我们沟通联系。
（4）点击作品剧情顶部的【对话】按钮，即可打开互动对话框页面。
（5）对话框，测试互动分支，输入“还是帮帮你吧”跳转到对应的剧情。
（6）刷新对话框，测试互动分支，输入“我不想帮你呢”，跳转到对应1-3的剧情。
（7）刷新对话框，测试互动分支，输入无关的句子就没有添加到分支例句例如“测试测试测试测试其它的话”，就走兜底跳转对应的下一步剧情1-4。
3.1. 用户注册、登录与退出
1.1.用户登录与注册
平台地址：https://juben.jiaoyou365.com/#/
在开始使用晓悟剧本编辑平台服务之前，必须先注册成为创作者，可以按要求填写信息并完成注册：填入“用户名”和密码进行快捷登录；
登录页
如果未注册账号，点击“注册账号”进入注册账号页面进行注册完整的剧本编辑平台的账号，通过填写用户名、密码、确认密码、邮箱，获取验证码，最后点击【注册】按钮，即可快速成为晓悟剧本编辑平台注册的创作者。
注册页
1.2.忘记密码
点击“忘记密码”可以进入密码重置页面，填入用户名和邮箱并获取验证码，填写完收到的验证码后，最后点击【下一步】按钮，即可进入下一步重置了。
密码重置-验证邮箱页
填入新密码和确认密码，最后点击【下一步】按钮，即可完成密码重置了。
密码重置-重新设置密码页
1.3.用户退出
在剧本编辑平台的顶部导航，点击右边的“退出”，即可退出当前账户，回到登录页面。
3.2.2 修改作品
修改作品操作页
（1）作品名称
默认是第x个作品，可以进行更改。用户说对了你的作品名称才能进入作品体验，因此需要考虑语音识别是否友好 。
注意：作品名称的字数限制在3～7个字。尽量选择常见字作为作品名称，禁止在作品名称中出现“我”“你”这两个字。
（2）拼音纠错
格式：{/拼音+声调/}
声调范围：1，2，3，4，5，分别对应 1声调、2声调、3声调、4声调，5轻声的发音
一般情况下是可以不用填写的，存在一些多音字的情况下标注发音。
示例（多音字）： 清新传 {/zhuan4/}
如果不加拼音注释，系统可能会识别成2声调的传{/chuan2/}的发音
注意轻声调也需要标注发音，填写声调数字5。比如：着: {/zhe5/}。
（3）作品封面
根据创作的作品内容，选择上传自己的作品图片。
作品封面示意图
4:3：一般用于电视，推荐尺寸400X300，具体看使用场景。
1:1：一般用于手表，推荐尺寸300X300，具体看使用场景。
列表页面和详情页面的图片用途展示如下：
列表页面展示
详情页面展示
如上所示，列表页面是展示所有的作品，详情页面是展示某一个作品的详情。
列表页面和详情页面，可以设置相同的封面，也可以设置不同的封面。
列表页面的作品封面。更侧重于吸引用户从众多作品中挑选到你的作品。
详情页面的作品封面。更侧重于让用户快速了解作品是讲什么的。
（4）作品简介
作品简介的目的，是让用户看了作品简介后，吸引用户去体验。
简要概括互动故事的主要内容，尽量写出精彩片段，再加点自己的感悟，或者是关于角色的有趣介绍。
（5）作品标签
可以选择系统提供的标签，目前不可以手动输入自定义标签
选择完的作品标签展示
标签列表，选择相关的类型/古风/科幻/经营/剧情/适合人群等等，最后点击“确定”进行保
标签列表
（6）适宜人群
适宜人群，就是作品的目标人群。可以是成年人，也可以是儿童、学生。
（7）作者
作者，需要是中文昵称，作者目前有且仅有一个，最好是简单易语音识别准确的。（需要考虑语音识别是否友好 ）
(1) 5.1.1新增剧情-5.1.4添加剧情分支
5.1.1.新增剧情
点击顶部的【+新增剧情】入口，进入新增文本剧情弹框页面。新增剧情，包括剧情点编号、角色、剧情文本内容等。
顶部最右边的新增剧情按钮
l操作步骤：
第一步：剧情点编号，在输入框中输入编号，格式：数字-数字。
剧情点编号，编号格式参考：1-1，1-1-1；1-2，1-2-1等。剧情的编号是递增的。
当剧情编号输入错误，提交的时候会进行错误提示，如下：
注：开始剧情，第一个编号的就是开始剧情。
开始剧情，指在作品生成后，点击对话进入剧情对话后，一开始出现的第一句剧情。
第二步：点击新增剧情
第三步：角色和剧情，操作说明
（1）角色，默认新建的是“旁白”角色，鼠标点击即可进行角色名称的修改。
（2）剧情文本，当前角色说的话，在当前输入框内任意输入剧情文本即可。
（3）
：用来新建一个对话角色及对话剧情文本内容。
（4）：用来删除当前的对话角色及对角色下的剧情内容。
（5）提交保存按钮，设置完角色和剧情文本后，记得提交保存。
多个角色：
同一个剧情里面，有多个人、多个角色说话，就进行相关角色和剧情文本的添加，示意图如下：
确认提交后展示：
提交剧情后展示的剧情列表
需要再次添加剩余剧情，重新点击顶部的【+新增剧情】入口进行类似重复操作即可。
剧情组下的剧情点个数，限制在100个以内
当前剧情包括合并剧情的字数加起来不要超过300字；
同一个数字开头的剧情，即同一个剧情分组，单个剧情分组下的总数不要超过100个剧情点。
比如1-1，1-2，.....，1-100，超过100就换一个分组比如接着用2开始的 2-1，2-2，......，2-100等。
注意：超过100个编号的剧情，剧本编辑器就会变得比较卡。
5.1.2.剧情更多功能操作
剧情编辑 - 剧情列表
添加完其它剧本后的剧情列表
（1）新增子剧情，点击默认新增当前剧情点下的子剧情。然后点击+新增剧情
即可添加角色和剧情文本内容，同前面的操作。
在1-1剧情下，新增子剧情，默认新建编号1-1-0的子剧情
（2）修改剧情，可修改当前选中的剧情，包括修改角色和剧情文本。
（3）删除剧情，可对当前选中的剧情进行删除操作。
5.1.3.剧情“待完善”状态
默认添加完剧本，剧情编号的开头有个“待完善”的状态，表示当前剧情下，
还没有添加用户回答方向的分支或分支的设置，包括分支的下一步剧情跳转、
分支的用户回答内容、分支的意图添加或者设置合并剧情等等。
【指令系统】退出作品写完提交剧情，右边会提示待完善，是正常的，无需处理。
但是其他剧情点提示有待完善要记得检查，是不是忘记写下一步的剧情编号了。
5.1.4.添加剧情分支
添加剧情分支，即填写用户可能回答方向的例句”，这里用户回答的写法，
同一方向的回答或者下一步剧情编号一样的回答，写在同一输入框里，
多句之间用加号连接，或者换行
添加分支的操作
（1）分支名，可以优先使用默认的分支名（分支1、分支2、分支3等等），但不能空着。
如果想自己重命名分支名称，也是可以重新输入设置的。
下一步剧情跳转的编号，输入跳转到下一步的剧情编号。
分支卡片紫色：表示设置了已存在的跳转剧情；
分支卡片灰色：待添加的剧情编号的角色及剧情文本。
（3）“新建剧情点的快捷操作，当分支卡片是灰色的情况下就存在此操作，
可以点击“新建剧情点”快捷进入新建剧情的操作。
（4）用户的回答输入框，输入用户的回答，5～8种方向，也可以考虑的细一些
多一些除了基础回复，最好多拓展几个。回答的方向和下一步剧情是一样的，
就放到一个分支里，多句用加号或者换行连接。
（5）新加新意图，添加话语意图用来匹配用户的话语想表达的意思。
（6）粘贴意图组，粘贴其它分支已经做好的话语意图，可以利用复制粘贴意图组的快捷操作。
操作步骤：
第一步：添加分支
第二步：设置剧情分支的分支名及下一步跳转剧情
第三步：添加剧情分支下的用户的回答例句，多句之间用换行或者加号连接。
用户例句是这个分支对应的用户回答的各种不同表达方式，而不是同句式变换。
第四步：给剧情分支下的用户的回答例句，添加话语意图。在添加意图输入框输入例句，再点击“搜索”
点击【添加新意图】对用户的话进行识别。这里的识别并不是只识别例句，
而是尽量多的去识别这个分支对应的用户回答的各种不同表达方式，这个很重要。
第五步：输入用户的回答例句，搜索到的话语意图，根据实际情况进行勾选对应的意图。
（1）底色框是绿色的意图，表示全匹配的话语意图。
（2）底色框是蓝色的意图，表示模糊匹配的话语意图。
第六步：点击刚才选择的意图组，查看是否有可拓展词组。
如果有可拓展词组，可以自己添加关键词。记得可扩展词组把原词组的内容删掉后自行添加。
注：原词组的内容一般都是需要删掉的，防止误识别其他的词。
单独举例：可扩展词组意图的操作，
11-1的剧情点已经写好剧情和分支（包括下一步、用户例句），
现在我们要用意图组来识别用户例句里面的话。该分支表示的是【出现不好的事物很害怕】方向的句子。
（6.1）点击【添加意图组】，输入用户例句“狼来了”，可以看到下面推荐了多个模糊匹配的意图组。选择合适的意图组【主谓】。（有的句子也可以选择多个意图组，比如 好的 表示同意也表示赞同） | （6.2）点击刚才勾选好的意图组，进入查看是否有可扩展的词组。有可扩展的词组把原词组删掉。（橙色部分） | （6.3）在词组里加入合适的词，可以扩展新加词的近义词，提高识别范围 | （6.4）如果有多个可拓展词组，则跟上一步一样删除原词组的词，添加新的词就好。添加完成后记得点保存。 | （6.5）生成对话测试看看吧 |
|
|
|
|
|
第七步：当前分支设定完之后，点击最下面的【提交剧情】按钮，进行提交保存。
注意：剧情分支的内容有改动，或者新添加了分支，都需要点击【提交剧情】按钮进行保存。
以上都设置完毕之后，添加其它的分支重复类似步骤。
(2) 5.1.5批量复制5.1.12. 剧情结束怎么设置
5.1.5.批量复制
点击某个剧情点，左边展示角色对话、剧情分支，最低部是常用的操作按钮，
包括“添加分支”、“批量复制”、“粘贴分支”、“提交剧情”等操作。
批量复制，可以复制当前剧情点下的分支或复制意图组，然后进行粘贴分支
的操作或者“粘贴意图组的操作。
5.1.6.粘贴分支
执行完批量复制操作后，就可以切换到其它剧情点进行粘贴分支的操作了。
举例如下：
第一步：复制完了剧情点1-1下的“同意”和“不同意”2个分支下的所有意图组，
第二步：切换到剧情点1-8，先点击“添加分支”出现“粘贴分支”的按钮，
接着可以点击“粘贴分支”进行粘贴的操作了。粘贴的是用户回答的部分和意图组的部分。
第三步：粘贴过来的分支名称是默认的及下一步跳转剧情为空，
需要继续对分支名称和下一步跳转剧情的设定。
5.1.7.粘贴意图组
执行完批量复制操作后，就可以进行粘贴意图组的操作了。
举例如下：
第一步：复制完了某个剧情点的指定分支下的所有意图组或部分意图组，
第二步：切换到其它剧情点，根据需要选择指定的分支，接着可以点击
“粘贴意图组”进行意图的快捷粘贴的操作了。
第三步：粘贴过来的意图组，可以根据当前的剧情点，设定相关的项目词组。
5.1.8.添加剧情评论
评论功能，评论指定的剧情点。
可以用于审核和编辑在审核剧本的时候发现剧情有问题的地方（情节问题、错别字等等）
作者可以根据评论，进行回复标注问题、也可以进行删除等功能操作。
5.1.9.合并剧情
合并剧情，就是让2个不同点的剧情可以合并，走完上一个剧情接着走下一个剧情。
第一步：勾选“合并剧情”，
第二步：添加分支，默认添加分支1，设置下一步剧情编号
第三步：提交剧情，修改了分支，都需要进行剧情的提交保存操作。
设置了合并剧情，就不需要设定用户回答方向例句和话语意图等的操作了。
注意：合并剧情加起来不要超过300字，超了需要自行拆分对话
>
5.1.10.兜底跳转
如果该剧情其他分支都没有命中的话，会走这个兜底跳转，即用户的其他回答或者用户说什么都往下走的分支。
每个剧情点都要有个兜底跳转的分支，防止用户卡在当前剧情点。
格式：在用户回答的例句的输入框里写上兜底跳转即可。
分支名可以用默认的分支几，也可以写兜底跳转，记得写下一步剧情编号。
5.1.11.指令系统
指令系统的角色比较特殊，只用在需要添加指令的地方，比如：
【指令系统】退出作品-------表示剧情结束要退出作品了。
5.1.12.剧情结束怎么设置
在最后一个剧情文本的末尾，加上【指令系统】退出作品
提示审核和编辑，当前剧情已经结束了。
注意：在剧情文本不要太早的结束剧情，否则用户体验不是特别好。
3.3. 4.关闭作品--8.语音合成
4.关闭作品 5.添加词性修改 6.监听 7.生成 8.语音合成
作品剧情页面，顶部左边的作品信息展示，点击X图标，关闭作品编辑页面回到项目主页面。
5.添加词性修改
根据项目的需要，添加词组的词性和词组内容。因为有的词如果没有定义词性，它的词性识别不准确，那么就不一定能被意图组准确识别。专有名词最好定义一下。
比如：星际通行证，如果你不定义它为名词，那么它就是分开的“星际”和“通行证”2个词，虽然我们在意图组的可拓展词组里面加词了，但是因为它不是一个词，所以意图组无法识别。因此需要我们在【添加词性修改】里选择名词，+星际通行证
先确定并选择词性，再添加词组内容，用“+”分隔。
6.关闭作品
作品剧情页面，顶部左边的作品信息展示，点击X图标，关闭作品编辑页面回到项目主页面。
7.添加词性修改
根据项目的需要，添加词组的词性和词组内容。因为有的词如果没有定义词性，它的词性识别不准确，那么就不一定能被意图组准确识别。专有名词最好定义一下。
比如：星际通行证，如果你不定义它为名词，那么它就是分开的“星际”和“通行证”2个词，虽然我们在意图组的可拓展词组里面加词了，但是因为它不是一个词，所以意图组无法识别。
因此需要我们在【添加词性修改】里选择名词，+星际通行证先确定并选择词性，再添加词组内容，用“+”分隔。
8.监听
点击作品剧情页面，顶部的【监听】按钮，进入监听分支页面的设定。监听是全局的，只要用户说的话被监听分支识别到了，就会优先走监听的剧情。
比如我们主线是上班，然后有人叫你去吃饭（监听Ａ，你跟着去吃饭了，监听Ａ的剧情）。
吃饭的过程中，你突然想喝水（监听Ｂ，你去喝水了，监听B的剧情，喝完水之后你想回去吃饭监听A，然后这里你就设置最后中断点。
吃完饭之后你要回去继续上班（回主线），所以吃饭监听A结束的时候，你设置下一步为第一中断点。
添加监听分支的操作，跟剧情下添加分支是类似的操作。详情操作见5.1.4的添加剧情分支。
添加监听示例：点击【监听】---【编写监听分支】（注意是全局的，只要被监听的分支识别）
会优先走监听的下一步剧情--【编写监听的剧情和分支】---【监听剧情结束记得加第一中断点或者最后中断点】
第一中断点
最后中断点
3.4. 9.对话--10.查询
生成完作品之后，就可以点击顶部的【对话】按钮，进入互动对话页。
对话里展示的第一个对话内容就是开始剧情。接着根据输入的对话内容，
来看是否命中当前剧情下已添加的用户回答方向例句意图，命中了相关话语意图就按照设定的剧情跳转了。
如果设定了当前剧情点其他分支都没有命中的话，会走这个兜底跳转的下一步剧情了。
作品完成后要整体对话体验一下，看上下文对话衔接是否正确无误并流畅。
语音版测试，默认是没有声音，如果想要声音，开启“语音模式”
，再点击播放按钮
播放声音。
语音版测试示例
点击按钮点击下载下对话记录，即可下载当前测试对话的文本内容。示例如下：
10.查询
点击作品剧情页面，顶部的”搜索输入栏“和【搜索】按钮，可进行快捷编号/角色/剧情文本的筛选了，筛选出符合搜索条件的剧情展示。
3.5. 11.功能菜单
点击作品剧情页面，顶部蓝色按钮【功能菜单】，“文本导入”、“文本导出”、“角色设置”、“数据统计”、“关闭菜单”等的功能操作。
11.1.文本导入
文本导入，是.txt格式结尾的剧情文本内容，分为累加和覆盖的2种方式导入。
如果是一个新的空项目，就选择“覆盖”上传方式即可；
如果是已经存在了剧情的作品项目，前面剧情文本和剧情编号不变，只补充后面文本，选择“累加”上传方式。
11.2.文本导出
文本导出，也是txt格式结尾的剧情文本内容导出，点击直接导出项目作品。
导出文件的格式，作品名--xxx--年-月-日--时-分-xxx.txt
11.3.角色设计
角色列表设置页，可进行不同角色的，讲话风格的设定。默认给角色分配一个说话风格。也可以点击对应角色的讲话风格，进入自定义声音的设定，包括男女音的选择。
还可以对已合成的系统语音进行参数调节，可以进行“试听”，试听可以了可以选择点击“确定”，保存已调整的参数。
点击左边的“返回”按钮，即可回到剧情编辑页面。
语音调参页面
11.4.数据统计
角对当前项目作品的相关数据统计，包括剧情点数、分支数、意图组数、评论数、文本文字数。通过数据统计的检测，可以反向检查当前作品的完整度情况。
输入开启剧情和结束剧情编号，进行查询，可以查询对话轮数和用户回复的话语内容，这样就可以对剧情进行查缺补漏的工作了。
如果提示无路径可以点击【生成】，然后点击【对话】进行对话，看卡在了哪一个剧情点，进而修改。
11.5.关闭菜单
关闭功能菜单，返回到作品剧情编辑页。