本文以报时机器人为载体，介绍了报时机器人的对话能力范围、配置文件功能和训练和运行命令，重点介绍了rasa shell命令启动后的程序执行过程。
一.报时机器人项目结构
1.对话能力范围
(1)能够识别欢迎语意图(greet)和拜拜意图(goodbye)
(2)能够识别时间意图(query_time)
(3)能够识别日期意图(query_date)
(4)能够识别星期几意图(query_weekday)
2.配置文件功能
(1)nlu.yml：主要包含意图、例子、对实体的标注等。
(2)stories.yml文件：用户和机器人之间对话的表示，用户输入意图，机器人响应action。
(3)actions.py：自定义的action，比如action_query_time、action_query_date、action_query_weekday。
(4)config.yml：主要包含nlu(分词、特征提取和分类等)和dialog policy(记忆、规则、机器学习等)。
(5)domain.yml：主要包含意图、视图、槽位、响应、动作等。
(6)credentials.yml：主要和其它对话平台集成，比如facebook、slack等。
(7)endpoints.yml：action_endpoint(调用自定义action)、tracker_store对话存储(内存、redis、mongodb等)、event_broker消息队列(RabbitMQ、Kafka等)。
3.训练和运行命令
(1)训练模型
使用NLU数据和stories训练模型，模型保存在./models中。
rasa train
说明：关于如何把数据集按照比例拆分为训练集和测试集，在训练集上训练模型，在测试集上测试模型，可以参考《聊天机器人框架Rasa资源整理》。
(2)启动action服务器
使用Rasa SDK开启action服务器。
rasa run actions
(3)启动rasa服务器和客户端
通过命令行的方式加载训练模型，然后同聊天机器人进行对话。
rasa shell
二.rasa shell执行流程分析
整体思路是通过rasa shell加载和解析模型，通过消息处理的方式建立起用户(客户端)和聊天机器人(rasa服务)对话的桥梁。
1.rasa/cli/shell.py文件
在rasa/cli/shell.py文件中，def shell(args: argparse.Namespace) -> None函数如下：
2.rasa/cli/run.py文件
在rasa/cli/run.py文件中，def run(args: argparse.Namespace) -> None函数如下：
3.rasa/api.py文件
在rasa/api.py文件中，def run(...) -> None函数如下：
在run()函数中调用serve_application()函数如下：
4.rasa/core/run.py文件
在rasa/core/run.py文件中，serve_application()函数如下：
在serve_application()函数中启动了一个基于Sanic的Web服务器，通过configure_app()方法构建了app，然后通过run()方法启动，如下所示：
app = configure_app(
input_channels,
cors,
auth_token,
enable_api,
response_timeout,
jwt_secret,
jwt_method,
port=port,
endpoints=endpoints,
log_file=log_file,
conversation_id=conversation_id,
use_syslog=use_syslog,
syslog_address=syslog_address,
syslog_port=syslog_port,
syslog_protocol=syslog_protocol,
request_timeout=request_timeout,
)
......
app.run(
host=interface,
port=port,
ssl=ssl_context,
backlog=int(os.environ.get(ENV_SANIC_BACKLOG, "100")),
workers=number_of_workers,
)
通过register_listener(listener, event)注册给定事件的侦听器：
app.register_listener(partial(load_agent_on_start, model_path, endpoints, remote_storage), "before_server_start",)
app.register_listener(close_resources, "after_server_stop")
5.rasa/core/agent.py文件
通过load_agent_on_start()方法加载一个agent。在rasa/core/agent.py文件中，load_agent()函数如下所示：
在load_agent()函数中，加载模型代码是agent.load_model(model_path)。在Agent类的def load_model()方法中，关于初始化MessageProcessor代码如下：
self.processor = MessageProcessor(
model_path=model_path,
tracker_store=self.tracker_store,
lock_store=self.lock_store,
action_endpoint=self.action_endpoint,
generator=self.nlg,
http_interpreter=self.http_interpreter,
)
加载模型的代码如下：
logger.info(f"Loading model {model_tar}...")
with tempfile.TemporaryDirectory() as temporary_directory:
try:
metadata, runner = loader.load_predict_graph_runner(
Path(temporary_directory),
Path(model_tar),
LocalModelStorage,
DaskGraphRunner,
)
return os.path.basename(model_tar), metadata, runner
except tarfile.ReadError:
raise ModelNotFound(f"Model {model_path} can not be loaded.")
6.rasa/engine/loader.py文件
在rasa/engine/loader.py文件中，def load_predict_graph_runner()函数如下：
三.遇到的问题和说明
1.如何用PyCharm调试Rasa项目
解析：一种是基于Script path的调试方法，一种是基于Module name的调试方法。这里介绍前者如下所示：
(1)Script Path：安装rasa类库的__main__.py文件路径。
(2)Parameters：rasa的各种cli，比如train、test、shell等。
(3)Working directory：安装rasa类库的根目录。
说明：因为rasa类库依赖类库太多导致系统环境混乱，所示建议使用虚拟环境进行rasa类库安装。
2.NoConsoleScreenBufferError
解析：exception=NoConsoleScreenBufferError(‘No Windows console found. Are you running cmd.exe?’)
3.模型20220915-081548-honest-yield.tar.gz
解析：由metadata.json文件和components文件夹组成，后者和config.yml内容密切相关，如下所示：
4.Sanic框架
解析：Sanic是一个高性能异步的Web框架。
5.asyncio库
解析：它的编程模型是一个消息循环，关键字涉及event_loop、coroutine、task、future、async/await等。
本文只是简要的介绍了rasa shell命令启动后的程序执行过程，但是对于加载模型后如何解析模型构建图，以及用户输入后，消息如何通过模型(nlu和dialog policy)得到输出并没有介绍，后面写篇文章专门介绍。
参考文献：
[1]Rasa实战：构建开源对话机器人
[2]Sanic官方文档：https://www.osgeo.cn/sanic/
[3]asyncio库异步I/O：https://docs.python.org/3.7/library/asyncio.html
[4]聊天机器人框架Rasa资源整理
