生成适用于 Microsoft Copilot 的高质量插件

重要

• 适用于 Microsoft 365 Microsoft Copilot 的插件以公共预览版提供，仅在 Microsoft Teams 中的 Copilot 聊天中工作。
• 默认情况下，所有 Microsoft 365 个 Copilot 许可租户中都启用此功能。 管理员可以基于用户和组禁用此功能，并控制各个插件的批准使用方式以及启用哪些插件。 有关详细信息，请参阅： 在集成应用中管理 Copilot 的插件。

生成插件时，用户可以通过 Microsoft Copilot 使用自然语言与 Web 服务进行交互。 插件扩展 Copilot 的技能，以代表用户完成任务。 他们特别擅长：

• 访问实时信息，
• 检索关系数据，以及
• 跨应用执行操作

良好插件的品质

对于 Copilot 识别其功能并将其与相应的用户任务相匹配，必须明确简洁 地描述插件 。 通过使用以下特征设计插件，可以确保插件在运行时提供最佳用户体验。

支持搜索

预测和支持用户将执行的最常见搜索。

检索深层内容

与周围段落的搜索匹配。 提供自适应卡片响应以及附加信息。

显示可操作结果

包括一种让用户执行操作的方式，例如指向您的网站的深层链接或模式对话。

提供预览

引导用户完成内容预览。

插件最佳做法

本文的其余部分介绍了生成高质量插件的最佳做法。

构建安全且负责任的 AI

• 反竞争：避免在简短和完整说明中使用任何其他插件的名称。
• 负责任的 AI：避免使用不当或冒犯性的关键字。
• 提示注入：确保文本不会导致提示注入。 此外，说明不得包含指示它们可用作提示注入代码的符号或文本。 避免使用以递归方式调用应用的短语、函数和代码。

支持多参数搜索查询

若要支持复杂提示，请在插件应用清单中启用多参数支持，以扩展搜索支持的范围，以同时处理三个或更多搜索查询parameters。

确保搜索参数具有良好的说明以及显式输入类型和输出格式。

避免对插件、其技能和参数进行泛型说明

精确描述插件的作用和不执行哪些操作。 虽然添加额外信息以尝试提高 Copilot 使用插件的可能性很诱人，但这可能会导致以下关键问题：

• 泛型插件说明可防止选取作业的相应插件，如果这种情况经常发生，用户可能会禁用该插件。

• 选择错误时，插件执行或响应失败可能是结果。 Copilot 不会显示错误率较高的插件，并且用户对插件的信任可能会削弱。

不要假设 Copilot 可以猜测所需的输入

只有在有限的情况下，Copilot 才能够猜测用户提示的输入。 大多数情况下，需要在用户提示 Copilot 中明确说明插件查询所需的输入。 最佳做法是使用不同的提示测试插件，以便 Copilot 预测预期行为。

验证 Copilot 可以针对插件响应进行推理的操作

虽然 Copilot 提供对插件响应输出进行推理的基本功能，但结果因方案而异。 最佳做法是使用需要后期处理以预期行为的不同提示测试插件。

为用户查询提供视觉丰富的响应

使用结构化、可操作且视觉丰富的 自适应卡片响应用户输入。 确保自适应卡片响应信息密集，除了应用徽标、标题、缩略图和信息) 标题外， (至少提供一个操作按钮和两条附加信息。 作为其他信息，提供最常搜索的属性（如 状态、 日期或 分配给 字段）非常有用。

另请参阅

创建或升级 Copilot 扩展的指南

发布适用于 Copilot 的插件和图形连接器