Hello World#
本节介绍一个 “Hello World” Colang 示例。
流程#
Colang 脚本是一个 .co
文件,由一个或多个流程定义组成。流程是描述用户和机器人之间期望交互的一系列语句。
Colang 脚本的入口点是 main
流程。在下面的示例中,main
流程等待用户说 “hi”,并指示机器人回复 “Hello World!”。
examples/v2_x/tutorial/hello_world_1/main.co#
1import core
2
3flow main
4 user said "hi"
5 bot say "Hello World!"
注意
您可以在此处找到本指南的完整示例。
为了实现这一点,main
流程使用了两个预定义的流程
user said
:当用户说了某些内容时,此流程被触发。bot say
:此流程指示机器人说出特定消息。
这两个流程都位于 core
模块中,该模块包含在 Colang 标准库中,默认情况下可用(类似于 Python 标准库)。开头的 import
语句导入 core
模块中的所有流程。
注意
有关更多详细信息,请查看Colang 标准库 (CSL)。
测试#
要测试上述脚本,您可以使用 NeMo Guardrails CLI
$ nemoguardrails chat --config=examples/v2_x/tutorial/hello_world_1
> hi
Hello World!
> something else is ignored
>
注意
上面的示例不使用 LLM。要从机器人获得响应,您必须发送确切的 “hi” 文本,否则不会返回任何响应。下一节将介绍如何扩展 LLM 支持。
恭喜,您刚刚创建了您的第一个 Colang 脚本。
下一个示例将教您如何通过添加其他流程和启用 LLM 集成来创建对话轨道。