当前位置：首页 > news >正文

10分钟学会使用.Net技术开发一个Ai智能体应用

news 来源：原创 2025/6/10 7:00:18

文章目录

- 一、项目简介
- 二、环境准备
- - 2.1 安装 .NET SDK
  - 2.2 克隆项目
- 三、添加 NuGet 包
- 四、配置项目
- - 4.1 配置 `appsettings.json`
- 五、编写代码
- - 5.1 初始化 `CozeAgent`
  - 5.2 代码解释
- 六、运行项目
- 七、语音功能支持
- 八、贡献与反馈
- 九、总结

在当今数字化的时代，AI 智能体应用越来越受到开发者的关注。扣子 Coze 是一个强大的 AI 智能体平台，本文将带你在 10 分钟内学会使用 .NET 技术开发一个基于扣子 Coze 的 AI 智能体应用。

一、项目简介

CozeSharp（扣子 Coze Chat SDK）是使用 C# 语言编写的开发工具包，它为开发者提供了便捷的方式来集成 AI 智能体功能到自己的应用中。该 SDK 不仅提供了丰富的 API，还附带了一个 ConsoleApp 示例，方便开发者快速上手。

二、环境准备

2.1 安装 .NET SDK

确保你已经安装了 .NET 8.0 或更高版本。你可以从 .NET 官方网站下载并安装适合你操作系统的版本。

2.2 克隆项目

打开终端或命令提示符，执行以下命令克隆扣子 Coze 项目：

git clone https://github.com/zhulige/coze-sharp.git
cd coze-sharp

三、添加 NuGet 包

你可以使用以下命令添加 CozeSharp NuGet 包到你的项目中：

dotnet add package CozeSharp --version 1.0.1

四、配置项目

4.1 配置 `appsettings.json`

打开 CozeSharp_ConsoleApp 项目下的 appsettings.json 文件，配置个人令牌、智能体 ID 和用户 ID：

{"CozeSettings": {"Token": "your_token","BotId": "your_bot_id","UserId": "your_user_id"}
}

请将 your_token、your_bot_id 和 your_user_id 替换为你自己的实际值。

五、编写代码

5.1 初始化 `CozeAgent`

以下是一个简单的示例代码，展示了如何初始化 CozeAgent 并启动与 AI 智能体的交互：

using CozeSharp;
using CozeSharp.Utils;
using Microsoft.Extensions.Configuration;class Program
{static async Task Main(string[] args){// 创建配置构建器var configuration = new ConfigurationBuilder().SetBasePath(AppContext.BaseDirectory).AddJsonFile("appsettings.json", optional: false, reloadOnChange: true).Build();CozeSharp.Global.IsDebug = false;CozeAgent agent = new CozeAgent();agent.Token = configuration["CozeSettings:Token"];agent.BotId = configuration["CozeSettings:BotId"];agent.UserId = configuration["CozeSettings:UserId"];agent.OnMessageEvent += Agent_OnMessageEvent;await agent.Start();while (true){string? input = Console.ReadLine();if (!string.IsNullOrEmpty(input)){await agent.ChatMessage(input);}}}private static Task Agent_OnMessageEvent(string type, string message){LogConsole.InfoLine($"[{type}] {message}");return Task.CompletedTask;}
}

5.2 代码解释

配置读取：使用 ConfigurationBuilder 读取 appsettings.json 文件中的配置信息。
初始化 CozeAgent：创建 CozeAgent 实例，并设置令牌、智能体 ID 和用户 ID。
事件处理：订阅 OnMessageEvent 事件，用于处理接收到的消息。
启动服务：调用 agent.Start() 方法启动与 AI 智能体的连接。
消息发送：通过 agent.ChatMessage(input) 方法发送用户输入的消息。

六、运行项目

在终端或命令提示符中，进入 CozeSharp_ConsoleApp 项目目录，执行以下命令运行项目：

dotnet run

运行项目后，你可以在控制台输入文字消息，与 AI 智能体进行交互。

七、语音功能支持

扣子 Coze SDK 还支持语音消息功能。你可以通过以下代码实现语音消息的录制和发送：

private static bool _recordStatus = false;while (true)
{string? input = Console.ReadLine();if (!string.IsNullOrEmpty(input)){await agent.ChatMessage(input);}else{if (!_recordStatus){_recordStatus = true;Console.Title = "开始录音...";Console.WriteLine("开始录音... 再次回车结束录音");await agent.StartRecording();}else{await agent.StopRecording();Console.Title = "扣子CozeSharp客户端";Console.WriteLine("结束录音");_recordStatus = false;}}
}