入门指南#

本节是 Colang 2.0 的入门指南。它从一个基本的“Hello World”示例开始，然后深入探讨对话轨道、输入轨道、多模态轨道以及其他 Colang 2.0 概念，如交互循环和 LLM 流。本指南不假设有任何 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 文件）、包（即文件夹）、标准库、导入机制等。

指南#

在本页中