Botium Watson Assistant测试用#include引入部分对话的正确语法
问题根因定位
你遇到的解析错误本质是Botium对话文件的解析规则导致的:
.convo 主对话文件的解析器约定,行首以#开头的内容一律被识别为对话段(Section)标记,仅支持预设的固定段名(如#me、#bot、#DEFAULT、#NLP等)。很多人写的时候会习惯性把其他语言里带#的引入语法套用到Botium对话文件上,刚好踩中规则陷阱:你直接在对话步骤之间写#include SECOND-STRIKE时,解析器会把开头的#判定为新段标记,试图寻找名为include的合法段定义,因为没有这个内置段,所以抛出“Section "include" unknown”的解析失败错误。
对话任意位置嵌入部分对话的正确语法
你需要去掉INCLUDE指令前的#号,把它作为步骤级可执行指令,放置在想要插入的目标位置即可——既不需要嵌套进#bot段内部,也不会被误判为段标记。
核心区别:带#是段标记,不带#是可执行步骤指令,两者解析路径完全不同。
举个正确的文件结构示例,你的主对话immediate-pound-out_with_partial.convo.txt可以这样写:
#me 你好,帮我查下我的订单状态 #bot 您好,请提供一下您的订单号 #me OD20240512001 ; 以下直接在两个对话回合中间插入部分对话,无需嵌套进任何段 INCLUDE SECOND-STRIKE #me 那这个订单预计什么时候送达
对应的部分对话文件second-strike.pconvo.txt保持原有定义即可:
SECOND-STRIKE #bot 好的,我已查询到您的订单信息 #me 好的,我知道了
这种写法下,Botium运行时会直接把SECOND-STRIKE段定义的对话步骤流,无缝插入到当前位置,完全符合“在对话中间任意位置多次插入部分对话”的需求。
为什么你之前把INCLUDE放进#bot段的写法不可取
这种写法本质是把INCLUDE绑定为#bot段内部的响应规则,而不是独立的流程插入点:
- 逻辑上会让部分对话的触发时机被绑定到bot响应的等待节点,很容易出现步骤顺序错位,打乱原本设计的对话流逻辑
- 没有解决你“在对话步骤中间灵活插入”的核心需求,相当于把部分对话的执行时机强行限制在了bot发言的环节,不符合复用预期。
常见踩坑提醒
- 所有步骤级可执行指令(包括
INCLUDE、WAIT、LOG、ASSERT)都不要加行首的#号,否则必然被误判为段标记触发解析错误 - 同一个对话流程里需要插入多个部分对话时,只需要在目标位置依次书写不带#的INCLUDE语句即可,执行顺序和书写顺序完全一致
- 部分对话文件(.pconvo)的段名不需要加#号,作为独立的流程索引标识即可被INCLUDE指令正常识别
内容的提问来源于stack exchange,提问作者Andrew R. Freed
相关产品推荐
相关产品推荐

