.NET+AI | MEAI | ChatOptions 详解（4）
💡
原文中文，约5800字，阅读约需14分钟。
📝
内容提要
ChatOptions 是 Microsoft.Extensions.AI 的配置容器，提供统一接口以控制 AI 对话的生成策略和工具调用，支持灵活扩展和细粒度控制，确保跨提供商的一致体验。
🎯
关键要点
- ChatOptions 是 Microsoft.Extensions.AI 的统一配置容器，用于控制 AI 对话的生成策略和工具调用。
- 提供统一配置接口，确保跨提供商的一致体验。
- 支持细粒度控制，从对话上下文到采样策略进行全方位调整。
- 通过 AdditionalProperties 和 RawRepresentationFactory 支持灵活扩展。
- ChatOptions 的属性分为五大类：对话上下文、生成策略、工具调用、背景执行和扩展点。
- 对话上下文属性包括 ConversationId 和 Instructions，用于绑定会话和附加提示。
- 生成策略属性包括 ModelId、ResponseFormat、Temperature、TopP、MaxOutputTokens 等。
- 工具调用属性包括 ToolMode、Tools 和 AllowMultipleToolCalls。
- 背景执行与恢复属性支持后台长任务和流式响应的恢复。
- 扩展点通过 AdditionalProperties 透传自定义参数，RawRepresentationFactory 提供底层控制。
- 使用示例展示了如何配置对话上下文、生成策略和工具调用。
- RawRepresentationFactory 允许在统一抽象与底层实现之间建立桥梁，提供最大灵活性。
- 配置属性的优先级由 RawRepresentationFactory 中的非 null 值、ChatOptions 中的值和客户端的默认值决定。
- 最佳实践包括使用标准属性、避免状态污染和文档化特殊配置。
❓
延伸问答
ChatOptions 的主要功能是什么？
ChatOptions 是 Microsoft.Extensions.AI 的统一配置容器，用于控制 AI 对话的生成策略和工具调用。
ChatOptions 支持哪些类型的属性？
ChatOptions 的属性分为五大类：对话上下文、生成策略、工具调用、背景执行和扩展点。
如何使用 ChatOptions 配置对话上下文？
可以通过设置 ConversationId 和 Instructions 属性来绑定会话并追加系统提示词。
生成策略属性中有哪些重要参数？
生成策略属性包括 ModelId、ResponseFormat、Temperature、TopP 和 MaxOutputTokens 等。
什么是 RawRepresentationFactory，它的作用是什么？
RawRepresentationFactory 是用于在统一抽象与底层实现之间建立桥梁的机制，提供最大灵活性。
使用 ChatOptions 时有哪些最佳实践？
最佳实践包括使用标准属性、避免状态污染和文档化特殊配置。
➡️
