Le SDK XiaoZhiSharp offre aux développeurs C# une solution robuste pour concevoir des applications d'interaction vocale et des agents intelligents. Conçu pour être multiplateforme, cet outil simplifie l'intégration de fonctionnalités d'intelligence artificielle au sein de l'écosystème .NET, que ce soit pour des applications console ou des interfaces modernes avec MAUI Blazor.

Confiugration de l'environnement

Pour commencer le développement, assurez-vous de disposer du SDK .NET 8.0 ou d'une version ultérieure. La bibliothèque est distribuée via NuGet, ce qui facilite son intégration dans n'importe quel projet C# existant.

dotnet add package XiaoZhiSharp --version 1.0.6

Initialisation de l'agent intelligent

L'implémentation de base repose sur l'objet XiaoZhiAgent. Ce dernier gère automatiquement les mises à jour OTA (Over-The-Air) et établit la connexion via WebSocket pour la communication en temps réel avec le serveur d'IA.

using XiaoZhiSharp;
using XiaoZhiSharp.Protocols;

// Initialisation du client IA
var aiClient = new XiaoZhiAgent();

// Abonnement aux événements de messagerie
aiClient.OnMessageEvent += async (type, payload) => 
{
   Console.WriteLine($"[Flux {type}] : {payload}");
   await Task.CompletedTask;
};

// Gestion de la configuration et des mises à jour
aiClient.OnOtaEvent += (response) => 
{
   if (response != null)
   {
       Console.WriteLine("Synchronisation avec le serveur réussie.");
       // Accès aux URLs de WebSocket et jetons d'authentification
   }
   return Task.CompletedTask;
};

// Lancement de la procédure de connexion
await aiClient.Start();

Extension des capacités via le protocole MCP

Le Model Context Protocol (MCP) permet d'étendre les capacités de l'agent en lui donnant accès à des outils externes. Par exemple, vous pouvez créer un outil permettant à l'IA d'interagir avec le navigateur Web du système.

using System.Diagnostics;
using System.ComponentModel;
using XiaoZhiSharp.Mcp;

[McpServerToolType]
public sealed class WebAutomationTools
{
   [McpServerTool, Description("Ouvre une URL spécifiée dans le navigateur par défaut")]
   public static string NavigateToSite(string targetUrl)
   {
       try
       {
           if (string.IsNullOrWhiteSpace(targetUrl))
               targetUrl = "https://www.bing.com";

           var startInfo = new ProcessStartInfo
           {
               FileName = targetUrl,
               UseShellExecute = true
           };
           
           Process.Start(startInfo);
           return "Navigation effectuée avec succès.";
       }
       catch (Exception ex)
       {
           return $"Échec de l'ouverture du lien : {ex.Message}";
       }
   }
}

Une fois cet outil enregistré, l'agent IA peut interpréter des commandes vocales telles que « Ouvre Google » ou « Recherche les dernières actulaités » en invoquant directement la méthode C# correspondante.

Configuration réseau

Pour la communication avec les services d'intelligence, le SDK pointe généralement vers les points de terminaison suivants, selon votre région ou votre infrastructure :

• https://xiaozhi.me
• https://coze.nbee.net

Grâce à cette architecture, le SDK XiaoZhiSharp permet de transformer une simple application .NET en un assistant intelligent capable d'interagir avec son environnement de manière dynamique et autonome.