用于智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®的插件

插件使 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 中的声明性代理能够与具有 OpenAPI 说明的 MCP) 服务器或 REST API (模型上下文协议进行交互。 通过使用插件，用户可以要求声明性代理不仅查询 MCP 服务器或 REST API 以获取信息，还可以创建、更新和删除数据和对象。 MCP 服务器或 REST API 可以执行的任何操作都可以通过自然语言提示进行访问。

插件提供插件清单，Copilot 使用该清单了解插件的 MCP 服务器或 API 的功能。 然后，Copilot 可以决定何时安装并启用的插件适合回答任何给定的提示。 若要详细了解插件所需的清单文件，请参阅智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®的插件清单架构。

插件示例

POST /mcp
Content-Type: application/json

{
  "method": "tools/call",
  "params": {
    "name": "get-budgets",
    "arguments": {
      "budgetName": "contoso travel"
    }
  }
}

POST /mcp
Content-Type: application/json

{
  "method": "tools/call",
  "params": {
    "name": "get-budgets",
    "arguments": {
      "budgetName": "contoso travel"
    }
  }
}

POST /mcp
Content-Type: application/json

{
  "method": "tools/call",
  "params": {
    "name": "charge-budget",
    "arguments": {
      "budgetName": "contoso travel",
      "amount": 500,
      "description": "Megan's airline ticket"
    }
  }
}

GET /budgets?name=contoso%20travel

POST /budgets/charge
Content-Type: application/json

{
  "budgetName": "Contoso travel",
  "amount": 500,
  "description": "Megan's airline ticket"
}

插件的工作原理

1. 用户询问代理“第四咖啡大厅装修预算还剩多少？”

2. 代理从具有 MCP 服务器工具或 API GetBudget 的可用插件中标识与预算相关的插件，以获取预算详细信息。 它将用户问题的部分映射到函数的参数： budgetName=""。

3. 代理 要求用户 允许其发送到 Fourth Coffee lobby renovation 插件。

4. 用户选择允许与插件共享数据一次，或者选择始终允许共享此函数的数据。

5. 如果插件的 MCP 服务器或 API 需要 身份验证，插件会从令牌存储中请求令牌或 API 密钥。

6. 令牌存储返回令牌或密钥。 如果需要，令牌存储会导致代理提示用户登录。

7. 代理将请求发送到插件的 MCP 服务器或 API，该服务器或 API 托管在 Microsoft 365 之外。

8. MCP 服务器或 API 返回响应。

   {
     "name": "Fourth Coffee lobby renovation",
     "availableFunds": 5000.00
   }
   

9. 代理基于 MCP 服务器或 API 响应生成响应。

10. 代理发出回应：“第四咖啡大厅装修预算中留下的可用资金是5,000美元。

确认操作

Copilot 在首次将任何数据发送到插件之前询问用户。

用户确认连接后，仅检索数据的 MCP 服务器工具和 API 不需要确认，而修改数据的工具和 API 则不需要确认。 插件开发人员可以替代这些默认值。 有关详细信息，请参阅 MCP 的确认提示和用于智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®的 API 插件。

自定义响应演示文稿

Copilot 使用来自 MCP 服务器或 API 响应的数据生成对话响应。 插件可以通过提供自适应卡片模板以结构化方式显示数据来自定义这些响应。

操作响应中的 URL 处理

作为操作响应的一部分返回的 URL（无论是来自 API 插件、连接器还是流）可能会在智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®聊天体验中呈现为可单击的链接。 此行为由 Copilot 运行时控制，不会根据 OpenAPI 规范 servers 部分中定义的域进行评估。

操作响应的 URL 呈现行为受平台安全性、信任和策略规则的约束，并且可能会随时间而更改。 对于生产关键型方案，不要依赖操作响应中的可单击 URL。

针对 Copilot 业务流程协调程序优化插件

智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®可以从其剧目中的许多技能中独一无二地选择正确的技能。 但是，如何确保 Copilot 选择 你的插件 来提供正确的技能呢？

答案在于如何描述插件、其技能和启动技能的参数。 在插件清单中指定简洁准确的说明，以便最好地确保 Copilot 业务流程协调程序知道何时以及如何调用插件。

向业务流程协调程序描述插件的方式取决于生成的插件类型，如下表所述。

生成插件包

开发人员可以使用两种工具来生成 API 插件包。

• Visual Studio 或 Visual Studio Code 中的 Microsoft 365 代理工具包可以根据现有的 MCP 服务器或 OpenAPI 说明创建插件包。 代理工具包还具有具有示例 API 和相应插件包的初学者项目。
• Kiota 是一个命令行工具和Visual Studio Code扩展，可以根据现有的 OpenAPI 说明生成插件包。

限制

声明性代理插件

当声明性代理包含声明 性代理清单中定义的最多五个插件时，代理始终会将插件注入提示。 当代理包含五个以上的插件时，它将使用语义匹配。 语义匹配基于插件的说明，而不是插件本身中的任何单个函数。

插件可以包含无限数量的函数。 即使只匹配一个函数，也会返回所有函数。 但是，由于令牌窗口限制，如果包含 10 个以上的函数，响应的质量可能会降低。

插件输入和输出的令牌窗口截断大型内容。 功能限制可能会随着模型改进而变化，具体取决于任何系统开销。 针对较小的令牌长度进行优化，或根据需要选择允许流式传输大型内容的扩展性选项。

相关内容

• 从现有 API 生成 api 插件，用于智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®
• 使用适用于 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 的新 API 生成 API 插件
• 从 MCP 服务器生成用于智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®的插件
• 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®的插件清单架构
• 使用 API 插件编写声明性代理的有效说明