你好世界#

本节介绍一个“你好世界” Colang 示例。

流程#

一个 Colang 脚本是一个 .co 文件,并且由一个或多个流程定义组成。一个流程是一系列语句,描述了用户和 Bot 之间期望的交互。

Colang 脚本的入口点是 main 流程。在下面的示例中,main 流程正在等待用户说“hi”,并指示 Bot 回复“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: 此流程指示 Bot 说出特定消息。

这两个流程位于 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。要从 Bot 获取响应,您必须发送精确的文本“hi”,否则不会返回响应。在下一节中将介绍如何扩展此示例以支持 LLM。

恭喜,您刚刚创建了第一个 Colang 脚本。

下一个示例将教您如何通过添加其他流程和启用 LLM 集成来创建对话护栏