如何通过编程方式使用新版Windows Copilot及在应用中调用？

官方支持的编程接入方式 #

• Microsoft Graph Copilot API：这是官方推荐的集成路径，支持文本生成、代码辅助等核心Copilot能力，可直接在Windows应用中调用。需要先在Azure AD注册应用，申请CopilotReadWrite等权限，然后通过HTTP请求或官方SDK实现调用。以下是C#示例：

using Microsoft.Graph;
using Azure.Identity;

var scopes = new[] { "https://graph.microsoft.com/.default" };
var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
var graphClient = new GraphServiceClient(credential, scopes);

var userMessage = new CopilotChatMessage
{
    Role = ChatRole.User,
    Content = "生成一段WinUI 3的基础页面代码"
};

var response = await graphClient.Copilot.Chat.PostAsync(new ChatPostRequestBody
{
    Messages = new List<CopilotChatMessage> { userMessage }
});

• Windows AI Studio + 本地ONNX模型：如果需要离线或低延迟的Copilot能力，可通过Windows AI Studio将开源大模型（如Phi-3、Llama 2）转换为ONNX格式，再用Windows Machine Learning (WinML) API在Windows应用中本地调用，无需依赖云端服务。

Windows应用内集成的具体实现 #

• WPF/WinUI 3应用：可以通过两种方式集成：一是嵌入WebView2控件加载Copilot网页端（注意商用需符合微软条款）；二是通过Graph API获取结果后，直接在应用UI（如TextBlock、RichEditBox）中展示生成内容，搭配按钮触发请求。
• 原生WinRT应用：利用WinRT API结合后台任务，将用户输入异步发送到Copilot服务，再通过回调将结果更新到应用界面，实现无缝交互。
• 自定义Copilot插件：通过Copilot Studio创建自定义插件，定义应用专属的API接口规范，让Windows Copilot能够直接调用你的应用功能，实现Copilot与应用的双向联动。

关键注意事项 #

• 认证与权限：调用Graph API必须配置正确的Azure AD认证信息，确保应用拥有指定权限，否则会触发认证错误。
• 合规要求：商用场景需严格遵守Microsoft服务条款，避免未经授权的网页嵌入或API滥用。
• 性能优化：本地部署模型时，优先选择轻量化ONNX模型（如Phi-3 Mini），适配不同Windows设备的硬件性能，避免应用卡顿。

内容的提问来源于stack exchange，提问作者Antonio Linares Cañas