在ModelContextProtocol/CSharp-SDK中实现Ollama大语言模型对话的技术方案

在使用ModelContextProtocol的C# SDK对接Ollama大语言模型服务时，开发者可能会遇到接口冲突问题。本文将深入分析问题原因并提供多种解决方案。

问题背景

当尝试通过C# SDK创建Ollama的聊天客户端时，开发者可能会编写如下代码：

using IChatClient chatClient = 
    new OllamaApiClient("http://localhost:11434", "MFDoom/deepseek-r1-tool-calling:1.5b")
    .AsBuilder().UseFunctionInvocation().Build();

这段代码会触发编译错误CS0121，提示存在两个签名相同的AsBuilder方法无法区分。

技术分析

这个问题的根源在于OllamaApiClient同时实现了IChatClient和IEmbeddingGenerator两个接口，而这两个接口都有对应的AsBuilder扩展方法。C#编译器在这种情况下无法自动确定应该使用哪个扩展方法。

解决方案

方案一：显式类型转换

通过显式转换为IChatClient接口，明确告知编译器使用哪个扩展方法：

using IChatClient chatClient = 
    ((IChatClient)new OllamaApiClient("http://localhost:11434", "MFDoom/deepseek-r1-tool-calling:1.5b"))
    .AsBuilder().UseFunctionInvocation().Build();

方案二：使用中间变量

先将实例存储在明确类型的变量中，再进行后续操作：

IChatClient client = new OllamaApiClient("http://localhost:11434", "MFDoom/deepseek-r1-tool-calling:1.5b");
client = client.AsBuilder().UseFunctionInvocation().Build();

方案三：直接使用构建器

绕过扩展方法，直接使用ChatClientBuilder类：

IChatClient client = new ChatClientBuilder(
    new OllamaApiClient("http://localhost:11434", "MFDoom/deepseek-r1-tool-calling:1.5b"))
    .UseFunctionInvocation().Build();

最佳实践建议

1. 接口隔离原则：在设计类时，应尽量避免让单个类实现过多功能相似的接口
2. 明确性优先：在可能产生歧义的场景下，优先选择最明确的编码方式
3. 错误处理：在实际应用中，应添加适当的错误处理机制，特别是网络请求部分

总结

通过理解C#编译器的方法解析机制，我们可以采用多种方式解决接口冲突问题。在实际开发中，方案二（使用中间变量）通常可提供最好的代码可读性，而方案三（直接使用构建器）则提供了最明确的意图表达。开发者可以根据具体场景选择最适合的方案。

对于需要频繁创建聊天客户端的场景，建议考虑封装一个工厂方法，统一处理这些创建逻辑，提高代码的复用性和可维护性。