[SDK] doc_url 的使用存在的问题

[choby]

在 1.0.0-pre1版本中的 doc_url的问题:
使用TextChatMessage.DocUrl()这种方式就无法兼容Microsoft.Extensions.AI,因为 TextChatMessage 并不继承微软的 ChatMessage

[ikesnowy]

近期不会处理，目前以完善 SDK 功能为主，有需要可以直接通过 IDashScopeClient 调用。

TextChatMessage 不会继承微软的 ChatMessage（SDK 本体基于 .net6，不能依赖 Microsoft.Extensions.AI）。目前是拿到 ChatMessage 然后我们转换成 TextChatMessage，因此通过 Microsoft.Extensions.AI 能够调用的功能一定是比直接使用 SDK 少的。

Microsoft.Extensions.AI 是微软提供的一个兼容层，主要是方便更换底下的 AI 供应方（例如对于聊天这种大家都提供的功能，可以不用改业务代码，直接更换包和key配置即可）。类似的有微软提供的 IDistributedCache 接口，对应的 Redis 实现也是无法使用 Redis 的全部功能的，只能是满足各个分布式缓存功能的交集。

对于 doc_url 这种和云厂商甚至是模型都高度绑定的功能，建议还是直接通过 SDK 调用。

[choby]

#154

[ikesnowy]

会考虑通过 RawRepresentation 允许直接传入 TextMessage，微软官方的 OpenAI 实现里是这么用的。

 internal static List<ChatMessageContentPart> ToOpenAIChatContent(IEnumerable<AIContent> contents)
{
    List<ChatMessageContentPart> parts = [];

    foreach (var content in contents)
    {
        if (content.RawRepresentation is ChatMessageContentPart raw)
        {
            parts.Add(raw);
        }
        else
        {
            if (ToChatMessageContentPart(content) is { } part)
            {
                parts.Add(part);
            }
        }
    }

    if (parts.Count == 0)
    {
        parts.Add(ChatMessageContentPart.CreateTextPart(string.Empty));
    }

    return parts;
}

[ikesnowy]

我这两天加一下吧，不要搞 PR 突袭了。

[ikesnowy]

1.0.0-pre2 允许直接传入 TextChatMessage，这样就可以在 Microsoft.Extensions.AI 无法支持时回退到普通的 SDK 调用。

var messages = new List<TextChatMessage>()
{
    TextChatMessage.DocUrl(
        "从这两份产品手册中，提取所有产品信息，并整理成一个标准的JSON数组。每个对象需要包含：model(产品的型号)、name(产品的名称)、price(价格（去除货币符号和逗号）)",
        [
            "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251107/jockge/%E7%A4%BA%E4%BE%8B%E4%BA%A7%E5%93%81%E6%89%8B%E5%86%8CA.docx",
            "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251107/ztwxzr/%E7%A4%BA%E4%BE%8B%E4%BA%A7%E5%93%81%E6%89%8B%E5%86%8CB.docx"
        ])
};
var parameters = new TextGenerationParameters()
{
    ResultFormat = "message", IncrementalOutput = true,
};

var response = client
    .AsChatClient("qwen-doc-turbo")
    .GetStreamingResponseAsync(
        messages.Select(x => new ChatMessage() { RawRepresentation = x }),
        new ChatOptions()
        {
            AdditionalProperties = new AdditionalPropertiesDictionary() { { "raw", parameters } }
        });
await foreach (var chunk in response)
{
    Console.Write(chunk.Text);
}

[choby]

dotnet 社区好像更倾向于从 AIContent 抽象类进行扩展:
dotnet/extensions@33322d8
dotnet/extensions#6314

[ikesnowy]

dotnet 社区好像更倾向于从 AIContent 抽象类进行扩展: dotnet/extensions@33322d8 dotnet/extensions#6314

他后面不是回复了吗？提出 Issue != 倾向。

我也同意他的观点，Microsoft.Extensions.AI 应该是和 SDK 无关的。

除非用户明确知道它的功能满足不了自己的需求，那他可以显式地绕过它，从底层拿数据。

[choby]

他后面那句说如果是服务提供商, 比如阿里云,那么希望是通过类来暴露数据:

并且微软确实也把 AIContent 的构造函数公开了, 并且也演示了如何序列化/反序列化一个继承于 AIContent 的自定义子类