入门#
本节是 Colang 2.0 的入门指南。它从一个基本的“Hello World”示例开始,然后深入讲解对话 Rails、输入 Rails、多模态 Rails 以及其他 Colang 2.0 概念,例如交互循环和 LLM Flows。本指南假定您没有使用 Colang 1.0 的经验,所有概念都从零开始解释。
先决条件#
本入门指南将只关注 Colang 文件。有关如何安装 NeMo Guardrails 并创建示例配置的完整详细信息,请参阅安装指南和NeMo Guardrails 入门指南。
所有示例的 config.yml
文件应包含以下内容
config.yml#
colang_version: "2.x"
models:
- type: main
engine: openai
model: gpt-4-turbo
上述配置将 Colang 版本设置为“2.x”(这是必需的,因为当前默认版本是“1.0”),并将 LLM 引擎设置为 OpenAI 的 gpt-4-turbo
。请确保将所需的 API 访问密钥设置为环境变量(例如,OpenAI API 使用 OPENAI_API_KEY)。有关所有支持的模型,请参阅支持的模型部分。
注意
有关如何安装 Colang 语法高亮以方便编辑 Colang 脚本,请查看开发与调试部分。
术语#
从高层面来看,Colang 尽可能多地采用了 Python 的术语。本指南将讨论 Colang 脚本和模块(即 .co
文件)、包(即文件夹)、标准库、导入机制等。