示例连接器（预览）

重要提示

[本文为预发布文档，可能会发生变化。]

您可以使用基于 Contoso 中心 - 连接器的认证连接器操作来查看 Microsoft 365 销售用 Copilot 中可用的可扩展性点。

要尝试认证连接器操作，请按照管理销售用 Copilot 的扩展中的说明操作，并为销售用 Copilot 启用 Contoso 中心连接器操作。

您可以通过编辑示例连接器和操作来快速开始。在编辑或创建连接器或连接器的操作时，请参考以下指南：

示例连接器包含 API 路径的占位符。您可以将这些占位符替换为实际的 API 路径。
HTTP 方法应与示例 OpenAPI 定义中指定的方法匹配。
连接器返回的 OpenAPI 定义用于根据说明映射输入和输出参数。示例 OpenAPI 定义中的所有必需参数必须存在于实际的连接器定义中，并且必须有正确的描述。
输入参数类型应与 OpenAPI 定义中指定的类型匹配。
OpenAPI 定义描述的 API 不应包含示例 OpenAPI 定义中不存在的任何必需参数。否则，销售用 Copilot 不会调用 API，会发生失败，出现内部错误。
不要将 connectorId 用作 OpenAPI 定义中的输入参数，它是保留参数。
在 OpenAPI 定义中标记为必需的输出对象的属性必须存在于 API 响应中。
每个连接器 API 应在五秒内完成执行，尤其是增强现有功能的连接器操作。
身份验证预计由 Microsoft Power Platform 连接器中的构造处理，不在每个 API 的范围内。
当前用户的语言在请求标头中传递时为 Accept-Language。将它用于任何特定于语言的操作。
从连接器的请求中读取以下标题，并将其发送到后端以进行更好的诊断：
- x-ms-client-request-id：传入请求的唯一标识符。
- x-ms-user-agent：值为“sales-copilot”。

反馈