入门指南#

本节是 Colang 2.0 的入门指南。它从基本的 “Hello World” 示例开始，然后深入探讨对话 rails、输入 rails、多模态 rails 和其他 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 文件）、包（即文件夹）、标准库、导入机制等。

指南#

在本页中