当用户在 智能 Microsoft 365 Copilot 副驾驶® 对话助手中与声明式代理交互时,它可以连接到其他代理以检索额外信息或执行操作。 可以通过在属性中 worker_agents 列出代理游戏 ID 在代理清单中声明这些连接。 在运行时,Copilot 对话助手充当调解交互的代理,用户可以看到代理到代理的交换,但不需要自己选择连接的代理。
注意
清单声明的连接代理是独立于 Copilot 对话助手 API 的机制,后者可在自己的自定义应用程序中实现由智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 支持的对话体验。
注意
用户必须先获取每个连接的代理,然后才能使用它们。 有关详细信息,请参阅将 连接的代理部署到组织中的用户。
当用户与声明式代理交互时,代理可以将部分任务委托给连接的代理。 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 评估清单中声明的已连接代理,并根据当前任务和已连接代理的名称、说明和示例提示选择一个代理。 Copilot 向所选的连接代理发送文本请求,接收文本响应,并将该响应合并到声明式代理与用户的持续交互中。
何时使用连接的代理
使用连接的代理来拆分或组合跨职能或开发团队的代理。
扩展到一个代理所能完成的范围
大型语言模型 (LLM) 具有有限的有用上下文窗口和一组功能。 随着 检索到更多文档 或 启用工具,单个 LLM 代理的可靠性开始下降。 如果代理在添加更多知识或功能后质量较低,请将其中一些功能拆分为另一个代理并连接到它。 现有代理仅发送有关已连接代理完成其部分所需的任务的信息。 连接的代理在自己的上下文窗口中工作,不受用户对话中的其他文档或功能的影响。
与外部开发的代理集成
声明式代理可以更轻松地与其他开发团队合作。 每个开发团队都可以专注于其代理的功能和质量,使用连接的代理与其他代理集成。 与微服务一样,可以在不影响其他代理的情况下开发每个代理。 与微服务不同,即使界面发生变化,代理也可以继续相互交互。
将代理功能共享到多个方案
代理可能适用于一组文档和操作,但对用户来说仍然很困难。 考虑一个了解客户和销售关系数据库的表和数据的代理。 此代理可能对商店主管管理库存和业务分析师向高管报告都很有用。 如果该代理可以连接到为存储主管量身定制的代理,提供对话开场白和说明,也可以连接到为业务分析师量身定制的代理。 这两种类型的用户都可能从使用针对其场景定制的代理中获得更多价值。
启用已连接的代理
必须在 Microsoft Agent 365 代理注册表中注册已连接的代理。 通过在现有 声明性代理的清单中包含代理的游戏 ID 来连接到其他代理。 另一个代理人必须是声明性代理人或拥有注册的 Agent2Agent 代理人卡。
首先,获取要连接的代理的游戏 ID。 代理的游戏 ID 是由单个字母、下划线和 GUID 组成的字符串。 对于声明性代理,请在 Microsoft 365 代理工具包中的 “预配 ”命令的输出中或在 开发人员模式下找到它。 对于 Microsoft 365 代理注册,它是 idagentRegistration 对象的属性。
将游戏 ID 作为 worker_agents 属性添加到 id. 该 worker_agents 属性已添加到声明性代理架构版本 1.6 中。
身份验证和授权
连接到声明性代理依赖于用户的现有身份验证来智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®,因为声明性代理在 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 对话助手 中运行。 对于在 Microsoft Agent 365 中注册的外部代理,代理注册必须声明智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®如何向外部代理进行身份验证。 注册不是直接在代理注册中嵌入身份验证配置,而是通过 authorizationagentRegistration. 这种分离允许独立于代理定义管理身份验证配置。 该设计镜像 了 API 插件清单的设计。
语法
{
"type": "None | OAuthPluginVault",
"referenceId": "{string}"
}
该 type 属性指定外部代理使用的身份验证方案。
OAuthPluginVault使用 Microsoft Entra SSO 注册。 这是 referenceId 在 Teams 开发人员门户中生成的 Microsoft Entra SSO registration ID 值。 有关更多详细信息,请参阅使用 Teams 开发人员门户 。
用户是否可以使用连接的代理与身份验证分开确定。 用户必须有权访问连接的代理,可以通过自己获取或通过管理员部署来获取它。 管理员必须为用户安装在 Microsoft Agent 365 中注册的外部代理。
最佳做法
声明式代理根据已连接代理的 name、 description和示例提示选择要连接到的代理。 对于声明性代理,示例提示是 text 清单中的字段 conversation_starters 。 对于 agentRegistration,它是examples代理卡中对象的AgentSkill属性。 代理的描述应向人类和代理描述代理可以做什么。 例如,对于处理有关视频游戏销售的结构化数据的代理,请考虑此说明。
A comprehensive video game sales analytics agent that provides detailed insights into
gaming industry data across multiple dimensions.
Analyze top-performing games, consoles, genres, and publishers with regional breakdowns
for North America, Europe, Japan, and global markets.
Discover best-selling titles of all time, platform-specific performance metrics, genre
popularity trends, and yearly sales patterns.
Compare sales figures across different publishers, identify market leaders by region,
and explore gaming industry evolution over time.
Whether you need to understand which games dominated specific platforms, analyze
publisher market share through visualizations like histograms, or track sales performance
across different years and regions, this agent delivers comprehensive gaming market
intelligence with precise data-driven answers.
示例提示应告知用户和代理代理可以处理的提示类型。 由于用户可能对同一概念使用不同的术语,因此请考虑改变对话发起者的措辞。 例如,在处理法律案件时,好的对话开场白还可能使用“事项”、“案例”、“客户”和“问题”术语。
text连接的代理仅使用对话启动器的字段。
限制
活动代理仅向连接的代理发送文本。 声明性代理返回文本或自适应卡。 具有 Agent2Agent 代理卡的代理将返回文本、Base64 图像二进制文件和 Base64 文件二进制文件。
当系统提示用户确认已连接代理的 API 插件调用时,任何 自适应卡 都将发送到活动代理。 用户看不到自适应卡或无法使用对话框。 但是,活动代理会处理自适应卡的数据内容。