typechat.net

介绍 TypeChat.NET 项目

TypeChat.NET 是 TypeChat 的 .NET 版本。该项目提供跨平台的库，帮助开发人员使用强类型、类型验证和简单类型安全程序构建自然语言接口。通过强类型，软件可以在使用语言模型时更具确定性和可靠性。

项目核心功能

• 跨平台库支持：TypeChat.NET 提供了多种功能库来支持不同类型的用户界面开发。
• 强类型和类型验证：使用强类型系统和类型验证来确保自然语言请求被正确理解和执行。
• 例子和文档支持：提供多个实例和文档来帮助用户理解和使用该项目。

组件构成

TypeChat.NET 由以下几个主要组件构成：

• Microsoft.TypeChat：负责将用户意图翻译为强类型的验证对象。
• Microsoft.TypeChat.Program：负责生成、验证并运行 JSON 格式的简单程序（计划）。
• Microsoft.TypeChat.SemanticKernel：与 Microsoft Semantic Kernel 集成，支持语言模型、插件和其他特性。

Microsoft.TypeChat

TypeChat 使用语言模型将用户意图翻译成符合特定模式的 JSON 数据，然后对 JSON 进行验证和反序列化处理为类型化对象。同时，应用必要的约束检查。若有验证错误，会反馈给语言模型来修复原始 JSON 数据。

该组件的主要功能包括：

• JSON 的翻译、验证、修复和反序列化。
• 扩展性：用户可自定义模式、验证器和提示。
• 模式导出：通过 Typescript 表达 JSON 对象的模式。

Microsoft.TypeChat.Program

TypeChat.Program 通过将自然语言请求翻译成简单的程序（计划）来进行处理。这些程序表示成 JSON 格式，并且可以针对目标 API 进行类型检查。程序可以使用解释器运行或者编译成 .NET 代码。

该组件包含：

• 程序翻译器：将用户意图翻译成遵循特定语法的程序。
• 程序解释器：使用解释器运行生成的程序。
• 程序编译器：使用动态语言运行时 (DLR) 来编译并类型检查程序。

Microsoft.TypeChat.SemanticKernel

TypeChat.SemanticKernel 使用 Semantic Kernel 1.0，包含以下功能：

• 将注册插件转换为 JSON 程序可调用的 API。
• 通过 Semantic Kernel 访问语言模型和嵌入。

开始使用

前置条件：OpenAI

• 需要了解并能访问 OpenAI 的语言模型（如 gpt-3.5-turbo, gpt-4 等）。
• 包含一些示例和场景，尤其是在使用 gpt-4 时效果最佳。

编译步骤

• 使用 Visual Studio 2022 或命令行工具 dotnet build 加载并构建项目。

Nuget 包

• Microsoft.Typechat
• Microsoft.TypeChat.Program
• Microsoft.TypeChat.SemanticKernel

用户可以通过相应的命令添加上述 Nuget 包，以便使用项目中的功能。

示例项目

提供多个示例项目，每个项目包涵输入文件，通过批处理模式运行来展示不同的功能和场景。

配置和使用

要使用 TypeChat.NET 或运行示例，用户需要一个 OpenAI 的 API key 或 Azure 身份认证配置。具体操作步骤包括配置 appSettings.json 文件，将 API key 添加到开发配置文件中。

语义内核和自定义客户端

TypeChat 可通过自定义客户端通过实现 ILanguageModel 接口来灵活访问不同的语言模型。虽然默认支持一些 OpenAI 模型，但用户可以根据自身需求使用自定义配置和提示数据。

通过这些灵活和强大的功能，TypeChat.NET 为用户提供了一个在 .NET 环境中创建智能自然语言接口的高效工具。