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

在当今数字化的时代，语音交互技术正以前所未有的速度发展，为人们的生活和工作带来了极大的便利。XiaoZhiSharp 作为一款使用 C# 语言编写的 “小智SDK”，为开发者提供了一个强大而灵活的工具，能够轻松实现跨平台的语音交互应用。今天，我们就来深入了解一下这个项目。

一、项目简介

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

二、环境准备

2.1 安装 .NET SDK

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

2.2 克隆项目

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

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

gitcode
git clone https://gitcode.com/zhulige/xiaozhi-sharp
cd xiaozhi-sharp

三、添加 NuGet 包

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

dotnet add package XiaoZhiSharp --version 1.0.6

四、配置项目

服务器地址：
https://xiaozhi.me
或
https://coze.nbee.net

五、示例代码

5.1 Agent

using XiaoZhiSharp;
using XiaoZhiSharp.Protocols;

XiaoZhiAgent agent = new XiaoZhiAgent();
agent.OnMessageEvent += Agent_OnMessageEvent;
agent.OnOtaEvent += Agent_OnOtaEvent;
await agent.Start(); // 会自动进行OTA检查，然后连接WebSocket

private static Task Agent_OnMessageEvent(string type, string message)
{
    LogConsole.InfoLine($"[{type}] {message}");
    return Task.CompletedTask;
}

private static Task Agent_OnOtaEvent(OtaResponse? otaResponse)
{
    if (otaResponse != null)
    {
        LogConsole.InfoLine("OTA检查完成，获取到服务器配置信息");
        // 处理OTA响应数据，包括WebSocket URL、Token、MQTT配置等
    }
    return Task.CompletedTask;
}

5.2 MCP

/XiaoZhiSharp_ConsoleApp/McpTools

[McpServerToolType]
    public sealed class Chrome_Tool
    {
        [McpServerTool, Description("打开网站")]
        public static string OpenUrl(string url)
        {
            return OpenUrlInChrome(url);
        }

        public static string OpenUrlInChrome(string url)
        {
            try
            {
                // 如果URL为空，使用默认主页
                if (string.IsNullOrEmpty(url))
                    url = "https://www.google.com";

                // 在Windows上，使用Process.Start()直接打开URL
                // 系统会自动选择默认浏览器
                Process.Start(new ProcessStartInfo(url) { UseShellExecute = true });
                return "网站打开成功";
            }
            catch (Exception ex)
            {
                Console.WriteLine($"打开浏览器时出错: {ex.Message}");

                // 如果上述方法失败，尝试直接启动Chrome
                //TryOpenChromeDirectly(url);
                return "网站打开失败";
            }
        }
    }

语音尝试 帮我打开百度、帮我搜索今天最新的新闻。

六、贡献与反馈

如果你在使用过程中发现了项目中的问题，或者有任何改进的建议，欢迎随时提交 Issue 或者 Pull Request。你还可以加入项目的社区，分享经验、提出建议或获取帮助。

七、总结

通过本文的介绍，你已经学会了如何使用 .NET 技术开发一个基于小智的 AI 智能体应用。小智还提供了丰富的功能和便捷的MCP，让开发者可以轻松集成 AI 智能体功能到自己的应用中。希望你能在实际项目中发挥小智MCP的强大能力，开发出更加优秀的应用。

以上就是使用 .NET 技术开发一个 AI 智能体应用 - 小智Sharp的详细步骤，希望对你有所帮助！