用外部知识支撑回答
用 Microsoft 365 Copilot 连接器 摄取可搜索的外部内容与权限。它适合发现和 事实依据，不负责事务写入。
Microsoft Copilot API 指南
最适合 Microsoft Copilot AI 工作流的 API
比较适合 Microsoft Copilot 的 API，按企业数据、连接器与权限筛选，并核对接入权限和故障处理。
On this page
实用结论
租户内工作数据优先用 Microsoft Graph；外部知识索引用 Copilot 连接器；Agent 需要执行动作时，用 Copilot Studio 预置或自定义连接器。CRM、工单、搜索、数据库和消息等领域 API，只应围绕明确工作流与权限边界接入。
- 默认首选：Microsoft Graph
- 知识依据：Copilot 连接器 API
- 业务动作：Copilot Studio 连接器
第一项决策
“把 API 接入 Copilot”其实有三种含义
Microsoft Copilot 是一组产品体验，并非单一通用 API 客户端。比较服务商之前，先按目标选择正确通道。
执行业务操作
通过 Copilot Studio 支持的预置连接器、自定义连接器、Agent 流程、REST API 工具或 MCP server 暴露聚焦动作。
读取 Microsoft 365 工作数据
使用 Microsoft Graph 访问文件、邮件、日历、用户和 Teams 等资源，并受委托权限、应用权限及租户策略约束。
按任务筛选
Microsoft Copilot 工作流的最佳 API
下列排序依据是架构适配度，不是通用评分。许可证、区域可用性、限额和连接器支持情况，应以租户对应的官方文档为准。
01
Microsoft Graph API
如果工作流主要发生在 Microsoft 365 内，Graph 通常是首个 API。它为用户、群组、邮件、日历、文件、站点和 Teams 等资源提供统一模型，同时延续 Microsoft 身份与权限语义。广泛 Scope 会增加暴露面，因此应从一个资源、一个操作和官方 Graph 概述列出的最小权限开始。
02
Microsoft 365 Copilot 连接器 API
适合把外部非结构化企业内容带入 Microsoft 365 搜索与 Copilot 体验。该 API 可创建外部连接、Schema、内容项和外部群组。Schema 与 ACL 设计必须按产品级工作处理：标识不稳定、同步过期或权限错误都会削弱 事实依据。参阅 Copilot 连接器 API 概述。
03
Copilot Studio 连接器与自定义 API
适合让 Agent 执行动作。如果预置连接器的操作和认证方式匹配，应优先使用；否则可通过 OpenAPI 定义窄范围自定义连接器、加入 REST API 工具，或连接受支持的 MCP server。读写动作应拆分，高影响写入必须要求确认。微软在为自定义 Agent 添加工具中说明了这些模式。
04
CRM API：Dynamics 365、Salesforce 或 HubSpot
适合销售或服务 Agent 获取当前客户、联系人、商机、Case，或执行获批记录更新。应选择团队真正治理的记录系统，不要把整个 CRM 镜像到 Prompt；只读取决策所需字段，并让更新具备幂等性。使用 Copilot Studio 时，先查看官方连接器参考。
05
工作管理 API：Jira、ServiceNow、Asana 或 Linear
适合分诊、状态汇总、指派和受控工单变更。将数据交给模型前，应统一状态、优先级、负责人、时间戳和规范 URL。先生成草稿比直接转换状态更安全；遇到超时，应使用服务商 请求标识 核对真实状态。
06
搜索与检索 API
适合获取最新公开网页证据，或查询 Microsoft 365 之外的私有检索索引。返回内容应包含来源 URL、标题、日期和受限片段；高风险查询应限制域名。面对不断变化的服务商覆盖，可用 QVeris 工具发现先检查能力与 Schema，再决定服务商。
07
数据与分析 API
适合从运营指标、数据仓库或商业智能系统中生成受治理答案。语义定义、行级安全、查询限制和聚合规则必须放在模型之外。优先使用获批视图或参数化函数，而不是开放 SQL，并随答案返回查询或指标定义。
08
消息与通知 API
最适合作为最终交付或审批环节，而非事实源。先生成包含收件人、频道、证据链接和动作摘要的 Teams、Outlook 或 Slack Payload，再由策略或审核者授权发送。“准备消息”与“发送消息”必须拆开，避免重试导致重复通知。
按工作流结果选型，不按品牌熟悉度
| 目标 | 首选接入面 | 典型 API | 核心控制 |
|---|---|---|---|
| 基于 Microsoft 365 回答 | Microsoft Graph | 邮件、文件、日历、Teams | 最小权限 Scope |
| 查找外部企业知识 | Copilot 连接器 | 外部连接与条目 | ACL 与同步新鲜度 |
| 变更业务记录 | Copilot Studio 工具 | CRM 或工单连接器 | 预览、审批、幂等性 |
| 研究最新公开事实 | 搜索工具 | 网页搜索或检索 API | 来源白名单与引用 |
| 用公司指标回答 | 受治理的数据工具 | 商业分析、数据仓库或指标 API | 语义层与行级安全 |
Copilot API 工作流的参考架构
生产级集成最好拆成四层契约：接收请求的 Copilot 体验、选择知识或工具的编排层、执行身份与策略控制的 API 边界，以及真正持有记录的业务系统。模型可以提出工具调用，但不应负责授权、重试，也不能判断写入是否最终成功。
| 层级 | 职责 | 良好契约 | 需要防止的问题 |
|---|---|---|---|
| Copilot 体验 | 获取意图，展示证据、预览与审批 | 一个边界明确的用户结果 | 把聊天回答误当成已完成操作 |
| 编排 | 选择知识、动作与执行顺序 | 明确工具名称与类型化输入 | 选错工具或不安全动作串联 |
| 策略网关 | 认证、授权、校验、预算与日志 | 模型之外的确定性检查 | Prompt 文本扩大权限 |
| 记录系统 | 返回当前状态并提交获批写入 | 规范 ID 与幂等键 | 重复或无法核验的写入 |
同步知识、联邦知识与直接动作
微软目前明确区分两种 Copilot connector：同步连接器将外部内容摄取到 Microsoft Graph，以便建立索引并按权限裁剪；联邦连接器通过 MCP 实时取数，无需先复制到 Graph 索引。大规模且相对稳定的知识库适合同步模式；强调新鲜度、源端策略或避免数据复制时，更适合联邦模式。两者都不能自动替代更新 CRM、工单或数据库的动作 API。应以 Microsoft 365 Copilot 扩展概述作为权威入口。
新版 Copilot APIs 的位置
Microsoft 365 Copilot APIs 在普通 Graph CRUD 之上提供 AI 能力。Retrieval API 可让自建应用或 自定义引擎 Agent 基于 Microsoft 365 内容进行 事实依据；Search API 和 Chat API 当前在官方文档中标为 预览，必须结合租户可用性和最新条款评估。需要明确读写资源时使用普通 Graph 端点；需要对 Microsoft 365 知识进行推理或检索时，才考虑 Copilot API。生产决策前应查看官方 Copilot APIs 概述。
身份与权限设计
身份模型错误，再好的 API 也无法弥补。选择 Scope 前，应确定每次调用代表登录用户、应用自身，还是特定资源中的安装实例。Microsoft Graph 区分委托访问与应用访问；资源特定同意可以把权限限制在应用安装的资源内。微软建议只申请完成任务所需的最少权限，因为宽泛 Scope 不仅增加安全暴露，也更容易被租户管理员拒绝。
委托访问
适用于用户在线、操作必须遵循该用户权限的场景。最终访问范围同时受已授予 Scope 与用户自身权限约束。
应用访问
适用于没有登录用户的获批后台处理。应将其视为独立服务身份，限制 Endpoint，并加强监控和管理员审核。
OBO 流程
适用于连接器或中间层代表当前用户调用下游 API。每一跳都要校验 Audience 与 Scope，不能把 Token 转交给无关服务。
密钥处理
密钥和证书应放入获批配置或 Secret Store，绝不能写进 Prompt、Agent 指令或被索引的知识内容。
实现时应参照微软的 Graph 权限最佳实践；自定义连接器还应查看 Copilot Studio OBO 认证指南。
工作流示例
受治理的“准备客户续约简报”工作流
以下为假设示例，用于说明为什么可检查的窄契约链优于一个庞大的“CRM 助手”操作。
解析身份
映射登录用户与客户请求，不暴露无关记录。
收集证据
读取获批 CRM 字段、近期 Graph 会议和已索引合同知识。
带来源生成草稿
区分有来源事实与推断风险，并附上规范记录链接。
审批交付
预览 Teams 消息，由人工确认收件人并批准发送。
生产控制比 API 数量更重要
分离知识与指令
邮件、工单、网页和文件返回的内容只能作为不可信证据，不能改写工具、权限或策略。
按意图设计操作
“获取 Case 状态”与“关闭 Case”需要独立名称、Schema、Scope、审计事件与审批规则。
约束成本与延迟
限制调用数、分页数、行数、响应大小与执行时间；缓存稳定发现结果，同时重新核对易变业务状态。
核对每次不确定写入
使用幂等键或服务商 请求标识。超时后先查询远端状态再重试，绝不能让模型猜测是否成功。
快速选型清单
- 写清一个用户结果，并确定记录系统。
- 将需求归类为检索、Microsoft 365 上下文或动作。
- 构建自定义中间件前，优先评估 Graph 或受支持连接器。
- 在官方文档中核对认证、Scope、分页、限流、区域可用性和许可证。
- 测试正常、缺失、未授权、过期、限流、超时与重复请求情况。
- 只有只读证据完整且可审核后，才加入写动作。
生产测试流程
连接器在 Maker 会话中成功一次，并不代表可用于生产。应围绕一个代表性工作流建立固定评测集，记录期望来源与允许动作，并在每次 Schema、指令、连接器、权限或模型变更后重复运行。
记录人工基线
记录系统、字段、证据、审批、耗时以及最终人工决策。
压力测试检索
测试缺失、过期、权限裁剪、重复与冲突内容，确认每个结论都指向正确来源。
攻击动作边界
提交错误 ID、禁止记录、注入指令、过期 Token、限流，以及提交后的超时情况。
批准窄范围上线
只上线已记录的工具、Scope、预算、负责人、审计字段、回滚路径和复审日期。
需要衡量什么
应跟踪工具选择准确性、证据完整度、授权失败、无依据结论、单个完成任务的调用数、限流与超时率、重复写入防护、审核修正、延迟和服务商成本。不要虚构通用及格线；阈值应由工作流风险决定，只读知识助手与修改客户记录的 Agent 不应使用同一上线门槛。
Microsoft Copilot API 工作流故障排查
Copilot 选择了错误工具
把“管理客户”这类宽泛名称拆成“获取续约证据”和“起草续约备注”等意图明确的操作；删除无用输入，写清禁止范围，并用相似请求成对测试。使用 MCP 时，Server 名称与描述也会影响发现；微软的 MCP 接入指南明确要求提供清晰描述。
API 直连正常，但在 Copilot Studio 中失败
对比连接器认证、Token Audience、Consent、环境策略、数据丢失防护规则、网络可达性与操作 Schema。个人 Token 调用成功，并不能证明 Agent 的连接引用或终端用户身份具备访问权。
知识缺失或过期
同步连接器应检查 Connection、Schema、内容 ID、ACL、抓取或推送计划与失败摄取记录；联邦检索应检查源可用性、MCP 认证、查询转换、响应限制与延迟。不要隐藏新鲜度不确定性，应在回答中展示来源时间戳。
写入操作超时
应将结果视为“未知”，而不是“失败”。使用幂等键或 请求标识 查询记录系统并核对状态，只有确认原操作不存在或可重复时才重试；如果服务商无法支持状态核对，则转交人工处理。
避免架构混淆的关键术语
Microsoft Graph API
面向 Microsoft 云数据与操作的资源 API，用于明确读写。
Copilot API
Microsoft 365 的 AI 能力，例如 Retrieval；并非所有 Graph Endpoint 或连接器的统称。
Copilot 连接器
让 Microsoft 365 Copilot 体验获取外部知识的同步或联邦通道。
Copilot Studio 连接器
向 Agent 与 流程 暴露服务操作的 Power Platform 连接。
MCP 服务器
面向模型提供工具与资源的 Server；实际可用性仍取决于 Copilot 支持、Transport、认证和管理策略。
权威记录系统
持有当前业务状态的权威系统；Copilot 输出不能取代它。
生成可持续跟进的研究报告如果同一能力可能由多个服务商提供，可先在 生成可持续跟进的研究报告 中使用非敏感测试数据检查 Schema。若需要可复用工具面，请阅读 QVeris MCP 服务器指南。
常见问题
Microsoft Copilot API 常见问题
Microsoft Copilot 能调用外部 API 吗？
Copilot Studio Agent 可使用预置连接器、自定义连接器、流程、REST API 工具与受支持的 MCP 连接。具体选项取决于 Copilot 产品、环境、租户策略、许可证与可用性。
Microsoft Graph 与 Copilot connector 是一回事吗？
不是。Microsoft Graph 暴露 Microsoft 云资源与 API；Microsoft 365 Copilot 连接器 通过 Graph 端点把外部内容摄取到索引，供搜索和 Copilot 事实依据 使用；Copilot Studio 连接器 则暴露 Agent 或 流程 可调用的操作。
应该使用自定义连接器还是 MCP？
如果 Power Platform 生命周期、认证、策略和 OpenAPI 动作适配工作流，可用自定义连接器；如果已有可复用 MCP 工具面，且目标 Copilot 环境支持所需连接，则可用 MCP。无论哪种方式，授权都不能交给模型判断。
最适合从哪个 API 开始？
Microsoft 365 工作数据从 Microsoft Graph 开始；外部企业知识从 Copilot connector 开始；业务动作则先检查 Copilot Studio 是否有预置连接器，仅在必要时构建窄范围自定义操作。
精选 Provider
Microsoft Graph
用于 Microsoft 365 数据与权限工作流。