用途
该技能用于指导开发者使用 Microsoft 365 Agents SDK（.NET）构建面向 Microsoft 365、Teams 和 Copilot Studio 的企业级多渠道智能体。核心能力包括：基于 ASP.NET Core 的智能体宿主、AgentApplication 路由、以及基于 MSAL 的认证。
主要能力
- 通过 NuGet 安装 Microsoft.Agents.* 系列包，包括 Hosting.AspNetCore、Authentication.Msal、Storage、CopilotStudio.Client 以及 Microsoft.Identity.Client.Extensions.Msal。
- 提供 appsettings.json 配置示例，涵盖 TokenValidation、AgentApplication、Connections、ConnectionsMap 与 CopilotStudioClientSettings。
- 提供 ASP.NET Core 智能体宿主代码，包含 AddAgentApplicationOptions、AddAgent、AddAgentAspNetAuthentication、/api/messages 端点映射与授权控制。
- 提供 AgentApplication 子类示例，演示会话更新欢迎消息、消息路由（OnActivity）与回合错误处理（OnTurnError）。
- 提供 Copilot Studio 直连引擎客户端示例，包括用于令牌获取的 DelegatingHandler（交互式流程）以及使用 CopilotClient 的控制台宿主。
使用方式
- 安装所需 NuGet 包（命令见资料）。
- 按示例配置 appsettings.json。
- 在 ASP.NET Core 中注册智能体与认证，映射 /api/messages 端点。
- 继承 AgentApplication 实现路由与错误处理。
- 如需对接 Copilot Studio，配置 CopilotStudioClientSettings 并使用 CopilotClient。
资料建议在实现前使用 microsoft-docs MCP 核对 AddAgent、AgentApplication 与认证选项的最新 API，并在 NuGet 确认包版本。
适用场景
适用于需要为 Teams/M365/Copilot Studio 构建多渠道企业智能体的 .NET 开发任务。
限制
- 资料中的 references/acceptance-criteria.md 为外部前置文件，未随目录提供，也未给出已验证的下载来源；依赖该路径的步骤在文件存在前不可执行，不得伪造缺失脚本。
- 仅在任务明确匹配上述范围时使用；输出不能替代针对具体环境的验证、测试或专家评审。
- 若缺少必要输入、权限、安全边界或成功标准，应停止并请求澄清。
- 生产环境应启用 TokenValidation 并要求 /api/messages 授权；MemoryStorage 仅用于开发；密钥应存放于 Key Vault、托管标识或环境变量；应复用 IHttpClientFactory 的 HttpClient 并缓存 MSAL 令牌。
参考链接
- Microsoft 365 Agents SDK：https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/
- AddAgent API：https://learn.microsoft.com/en-us/dotnet/api/microsoft.agents.hosting.aspnetcore.servicecollectionextensions.addagent?view=m365-agents-sdk
- AgentApplication API：https://learn.microsoft.com/en-us/dotnet/api/microsoft.agents.builder.app.agentapplication?view=m365-agents-sdk
- 认证配置选项：https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/microsoft-authentication-library-configuration-options
- Copilot Studio 集成：https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/integrate-with-mcs
- GitHub 示例：https://github.com/microsoft/agents