组织内可能有使用 C#、JavaScript 或 Python 构建的代理，这些代理托管在 Azure 或其他托管基础结构上。 这些代理是专用体验，可能侧重于利用 AI 服务的特定领域，并且已集成到 Web 或自定义应用。 可以使用 Microsoft 365 代理工具包在 智能 Microsoft 365 Copilot 副驾驶® 对话助手 中显示代理。 这允许用户使用统一的智能 Microsoft 365 Copilot 副驾驶® UI 来处理跨企业构建的代理，使代理更易于发现和访问。
使用Microsoft 365 智能体 SDK
若要将代理引入智能 Microsoft 365 Copilot 副驾驶®，请使用 Microsoft 365 代理工具包将代理与Microsoft 365 智能体 SDK集成。 代理 SDK 支持 C#、JavaScript 和 Python。 如果代理是使用这些语言之一编写的，则无需对其进行重大修改。 只需将代理 SDK 代码添加到代理，并使用内置通道适配器将代理部署到智能 Microsoft 365 Copilot 副驾驶®。
Microsoft 365 智能体 SDK中的内置通道适配器支持多种通道，包括智能 Microsoft 365 Copilot 副驾驶®。 通过将现有代理包装到代理 SDK，可以与位于用户图面或通道（如 智能 Microsoft 365 Copilot 副驾驶®）与代码之间的 Azure 机器人服务集成。 Azure 机器人服务将通道发送的内容转换为常见活动，以匹配代码理解的内容（在本例中为接受来自 Azure 机器人服务传入消息的代理 SDK 包装器）。
修改代理的组件
若要将代理引入 Copilot，需要修改代理的某些组件，如本部分所述。
建议从 Microsoft 365 代理工具包开始，并使用 Visual Studio 中的 C# 和 Visual Studio Code) 的 JavaScript 中当前提供的 Echo/Empty 代理示例 (。 若要熟悉代理 SDK 结构，请完成使用代理工具包和 SDK 测试和部署代理的步骤;这些工具简化了所述任务。
创建应用注册和 Azure 机器人服务记录以处理通道通信 - Microsoft 365 智能体 SDK使用 Azure 机器人服务来处理通道与代码之间的通信，管理与这些通道相关的组件。 需要使用在代理中手动引用的应用注册创建 Azure 机器人服务资源。
配置代理事件侦听器 - 使用 Microsoft 365 智能体 SDK 生成的代理被构造为侦听来自通道的事件 - 在本例中，智能 Microsoft 365 Copilot 副驾驶®。 若要开始，请使用 OnActivity。 有关特定事件，请参阅 TurnContext 和 ActivityHandler。
更新代理的结构，以便它可以处理从 智能 Microsoft 365 Copilot 副驾驶® 发送到 Azure 机器人服务 的活动。为此，请将现有代理添加到使用 Microsoft 365 智能体 SDK 生成的代理的结构中。 你不必专门调用许多活动：代理可以使用 OnActivity 方法侦听来自客户端的任何消息。 然后，现有代理可以添加到或引用方法中，该方法是从正在侦听的事件触发的，因此每次发送活动时都会运行。 活动可以是消息或通道中的其他类型的作。 有关事件的详细信息，请参阅 参考文档。
使用代理工具包手动创建或生成 清单文件 。 智能 Microsoft 365 Copilot 副驾驶®需要包含清单文件的 .zip 包。 清单文件包含一组说明，用于指示智能 Microsoft 365 Copilot 副驾驶®在何处查找代理和其他信息。 智能 Microsoft 365 Copilot 副驾驶®需要托管一个代理和一个通过应用注册链接的终结点， (id) 并在清单文件中引用。 如果代理在 Teams 中运行，则可以修改现有清单文件以支持智能 Microsoft 365 Copilot 副驾驶®的最新架构。
连接到智能 Microsoft 365 Copilot 副驾驶®的代理可以选择性地请求用户的权限，以代表他们执行作。 如果选择使用此功能，请在 Azure 机器人服务 中的代理设置过程中对其进行配置。 入门工具
将代理引入 Copilot 所需的工作量因代理复杂性以及是否需要添加令牌管理来使代理能够使用用户标识来限定其知识范围而异。
若要开始，请使用 Microsoft 365 代理工具包和 Echo 代理示例创建代理，并按照 Visual Studio 或 Visual Studio Code 的文档对其进行测试和部署。 这将帮助你熟悉代理工具包、代理 SDK 和智能 Microsoft 365 Copilot 副驾驶®协同工作的方式。