入门#

本节是 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 文件)、包(即文件夹)、标准库、导入机制等。

指南#