Note
本文介绍了由 标准线束驱动的代理或代理流中使用的功能。
工具是构建模块,让你的代理能够与外部系统交互。 工具扩展了代理的功能,代理可以响应用户请求或自主触发执行各种操作。 每个工具都表示代理可执行的特定功能。 例如,你可以为你的代理人配备执行以下任务的工具:
- 使用Office 365 Outlook连接器发送邮件
- 查看当前的天气状况和预报
- 从 Dataverse 读取和写入数据
- 读取并发布消息到 Teams
是代理里的工具还是插件里的功能?
你在Copilot Studio中添加的工具属于你的智能体。 你的代理决定何时使用它们,而你在 Copilot Studio 中管理它们。 智能 Microsoft 365 Copilot 副驾驶®插件则不同:它将技能、工具(如 MCP 服务器)和代理打包在一起,使人们能够在支持的Copilot体验中一起查找、安装和管理它们。
| 问题与示例 | 代理中的工具 | 一个 智能 Microsoft 365 Copilot 副驾驶® 插件 |
|---|---|---|
| 什么时候用? | 你设计的是单一的代理体验,工具只有在其中才有意义。 | 你希望用户能直接在他们已经参与的 Copilot 体验中使用某个能力。 |
| 谁决定工具何时运行? | 您的代理的编排、主题和设置。 | Copilot,在每一种受支持的体验中。 |
| 人们在哪些地方使用它? | 你将代理发布到的渠道,例如 Teams。 | 支持的 Copilot 体验。 每个体验都会使用它所支持的插件部分。 |
| 谁来管理它? | Copilot Studio 中的制作者。 Power Platform 数据策略控制制作者可以添加哪些工具。 | 管理员,在 Microsoft 365 管理中心 中。 |
| Example | Contoso的IT帮助台代理负责创建工单并在Teams中重置密码。 | Contoso的客户账户插件包含了准备客户简报的技能和一个MCP服务器,用于查找公司CRM中的账户。 销售人员要求Copilot“为Fabrikam准备一份简报”。 |
示例:代理中的工具(Contoso IT 帮助台代理)
Contoso IT 在 Copilot Studio 中构建代理,并将其发布到 Teams。 代理使用ServiceNow连接器查找并创建工单,使用一个在经理批准后重置密码的代理流程,以及一个总结工单历史的提示。 代理的主题和编排决定每个工具何时运行,密码重置会先要求用户确认。 IT 团队在 Copilot Studio 中管理代理,Power Platform 的数据策略控制制造商可以使用哪些连接器。 代理中的工具之所以适合这里,是因为它们只在 Contoso 从头到尾设计的帮助台对话中才有意义。
示例:一个插件(Contoso 客户账户插件)
Contoso Sales 打包了一个插件,其中包含一项技能,可以根据团队模板编写客户简报,一个 MCP 服务器,可在 Contoso CRM 中查找账户,并且还可选择提供一个用于客户账户评审的声明式代理。 Contoso 将插件发布到其组织中,管理员则在Microsoft 365 管理中心中向销售团队提供该插件。 在支持的体验中,卖家要求 Copilot“为 Fabrikam 准备一份简报”。Copilot 会使用该技能和 CRM 工具,卖家无需打开单独的代理。 第一次,他们连接了他们的 CRM 账户。 插件适合这里,因为这项功能应该出现在卖家已经使用的 Copilot 体验中,管理员可以集中管理。
要了解更多关于插件的信息,请参见 “插件”。
向代理添加工具的机制
Note
如果你预期的工具在 “添加工具 ”面板中没有,你组织的政策可能会限制你可用的工具。 请与管理员联系以获取帮助。
您的代理人可以通过两种方式使用工具:
生成编排(自动):生成编排默认开启。 你的智能体会为每个请求选择最合适的工具、主题或知识来源。
示例:用户输入“我的笔记本电脑无法连接到 VPN”,代理选择了 ServiceNow 工具来开启工单。
从主题(显式)中:你从主题中的某个节点调用该工具。 如果您关闭生成式编排(经典模式),您的代理仅通过主题响应,但主题仍可调用工具。
您可以添加以下类型的工具:
| 工具类型 | 它的作用是什么 |
|---|---|
| 预构建连接器 | 通过 Power Platform 连接器连接到数千个 Microsoft 和非 Microsoft 服务之一。 |
| 自定义连接器 | 通过您定义的 Power Platform 连接器连接到您自己的服务。 要让您的代理使用它,连接器必须在整个组织中可见并共享。 |
| 代理流程 | 运行包含一个或多个操作的流程。 |
| Prompt | 运行单回合模型提示。 它可以利用你提供的知识生成代码来分析数据。 |
| REST API | 调用您从 REST API 中选择的端点和方法。 |
| 模型上下文协议 (MCP) | 连接到 MCP 服务器并使用其工具和资源。 |
| 计算机使用 | 通过用户界面操作网站和桌面应用:选择按钮、选择菜单并输入文本。 |
另外两个选项能让你的代理具备类似工具的行为:
Azure 机器人服务技能会让你的代理获得一套来自Azure 机器人服务机器人的相关工具。 客户端工具向客户端应用发送事件活动,客户端应用执行操作并返回响应。
Note
由标准 harness 驱动的代理中的技能属于 Azure 机器人服务 技能。 它们不同于代理技能,后者可以添加到由 GitHub Copilot 驱动的代理中。
在代理级别创建和添加新工具
当您向代理添加工具时,代理可以在任何对话中自动使用它。
在 Copilot Studio 中,选择 Agents,然后选择您的代理。
转到代理的工具页面。
选择 “添加工具”。
选择工具类型。 要查看所有类型,包括 REST API 和自定义连接器,请选择 “查看全部”。
Note
如果您的组织阻止了某种工具类型,您无法选择该工具。 有关更多信息,请参阅 “被贵组织策略阻止的工具”。
配置该工具。 步骤取决于类型。 例如,对于提示工具,编写提示说明,选择模型,并通过选择 + 添加内容来添加输入参数。 你可以从提示助手那里获得帮助,或者从提示模板开始。
选择 “保存”,然后选择 “添加并配置”。
工具的配置页面打开,工具现在显示在代理的 工具 页面上。
Note
如果你的组织因为数据政策而屏蔽了某个工具,你就无法选择它。 了解更多内容,请参阅 被贵组织政策阻挡的工具。
执行特定于所选工具类型的配置步骤。 例如,如果你选择 提示,请执行以下步骤:
- 定义提示指令
- 选择模型
- 通过选择 + 添加内容来指定输入参数
你也可以通过输入 提示助理 字段获得帮助。
作为替代方案,使用预定义模板通过选择 提示模板来创建提示。
选择 “保存” 以创建新工具。
选择添加并配置。 工具已添加至您的代理程序。 工具配置页面随即显示。 可在此处查看并更改您的工具配置。
你的新工具会出现在代理 的工具 页面上。
被组织政策阻挡的工具
管理员可以使用治理策略限制 Copilot Studio 中可用的工具和连接器。 当数据策略阻止某个工具时,该工具在“添加工具”窗格中显示为不可用。 要查看哪个策略阻止了它,请点击工具旁的信息图标。 如果您需要使用被阻止的工具,请联系管理员。
管理员在Microsoft 365 管理中心中管理插件,包括其中的技能和 MCP 服务器。 Power Platform 的数据策略仍然控制着创建者可以在 Copilot Studio 中添加哪些工具。
在 配置代理的数据策略中了解详细信息。
查看和更改工具配置
要查看或更改工具设置,请转到代理的 工具 页面并选择该工具。 配置页面包含三个部分:详细信息、输入和完成。
MCP 服务器有不同的配置页面。 它没有“输入”和“完成”,而是有“工具”和“资源”部分,列出了 MCP 服务器提供的内容。 有关详细信息,请参阅“将您的代理连接到现有的 MCP 服务器”。
Details
| 设置 | 要了解的事项 |
|---|---|
| Name | 显示在代理工具列表中。 使用一个能说明工具功能的名字。 |
| Description | 生成式编排利用描述来决定何时使用该工具。 说明这个工具的作用以及何时使用。 |
| 允许代理动态决定何时使用该工具 | 选中后,您的代理可以自行选择此工具。 未选中时,您的代理仅在主题调用该工具时使用该工具。 当生成式编排开启时默认选中。 |
| 运行前请先询问最终用户 | 在工具运行前要求用户确认。 默认设置为“否”。 |
| Authentication | 使用用户凭据(默认为终端用户)或制作者凭据(由制作者提供)运行该工具。 |
| 身份验证描述 | Optional. 告诉用户他们被要求登录的内容。 |
示例:Contoso IT 将密码重置流程描述为“在用户经理批准后重置用户密码。 当用户被锁定或请求重置其密码时使用。它还会将 在运行前询问最终用户 设置为 是。
输入
输入就是你的工具所需的数值。 每个输入以表格中的一行形式显示。
默认情况下,“使用填充”设置为“使用 AI 动态填充”。 您的代理会尝试查找对话中的每个值,例如用户的消息。 如果找不到该值,它会询问用户。
要控制输入的收集方式,请选择 “自定义”。 可以设置:
- 显示名称 和 描述:向用户显示的方式。
- 识别为:如何解读用户的回答,例如以文本形式或预定义实体。
- 重试逻辑:如果代理不识别答案,是否再次询问。
- 输入验证:在实体类型默认值之外进行额外检查。
要跳过询问用户,请将 “使用填充 ”设置为 自定义值,然后输入数值、选择变量或编写 Power Fx 公式。
Note
刷新连接器操作后,其输出类型可能会保持未解析,直到您输入所有必需输入。 输入数值,保存主题,然后再次检查输出变量。
Completion
选择工具运行后的结果。 在 运行后,选择以下选项之一:
- 不响应 (默认):您的代理会在其自己的响应中包含该工具的输出。
- 用生成式人工智能写回应:AI会根据工具的输出写出回应。
- 发送特定响应:编写响应模板并插入输出变量。 你可以用 Power FX 格式化它。
- 发送自适应卡片:您发送带有按钮和操作的交互卡片。
您还可以选择代理和其他工具可以使用的输出变量。
工具选择和输入收集
您的代理人根据以下因素决定是否使用某项工具:
- 工具名称和描述。
- 到目前为止的对话。
- 用户所要求的内容。
- 工具所拥有的输入和输出。
- 这些工具它已经在对话中用过。
Note
如果响应必须完全复制工具输出,例如链接或卡片内容,请使用“发送带有变量插入 的特定响应 ”或 “发送自适应卡片”。 仅在工具已发送用户可见信息时使用 “不响应 ”。 用生成式AI写回复, 可以重新表述工具输出,可能无法完全保留链接或卡片内容。
配置哪些输出变量可以提供给代理和其他工具。
你的代理还会利用工具的描述来写出收集缺失输入的问题,这样你就不需要为每个输入添加问题节点。
默认情况下,工具会将其结果返回给您的代理,然后您的代理会写出响应。 你可以让工具直接响应用户。
Tip
当你的客服人员提出AI生成的问题时,要让用户知道对话的部分内容是AI写的。 例如,向“ 会话开始 ”系统主题添加一条消息。
从主题中调用现有工具
当你希望某个工具在对话的特定时刻运行时,就使用某个主题。
在 Copilot Studio 中,进入你代理人的“主题”页面。
创建一个主题并命名,例如, 创建工单。
添加触发短语,如“开启工单”、“报告问题”和“我需要IT帮助”。
选择 “添加节点 ”(+),然后选择 “添加工具”。
选择该工具。 工具分组在 “基本工具”、“ 连接器”和 “工具 ”选项卡上。
选择“保存”。
MCP 连接器信息
对于MCP连接器,您可以查看MCP连接器提供的MCP工具和资源的名称和描述。 工具和资源的信息以表格形式显示,每个工具用一行表示。
工具的身份验证注意事项
一些工具,比如提示程序或调用 Dataverse 的工具,需要身份验证。 您的代理会在用户上下文中运行工具,而工具在未开启身份验证时不会运行。 选择以下方法之一:
- 终端用户凭证:用户只获得他们被允许查看的数据。
- Maker 提供的凭据:工具使用您的凭据。 对于共享资源,或当用户不需要自己的访问权限时,请使用此方法。
测试您的工具
通过使用 生成式编排,您的代理在判断该工具符合请求时使用该工具。 要测试它,请问一个工具应该能处理的问题。 在下面的示例中,Contoso IT 输入“我被锁出账户”,并检查代理是否要求确认,然后运行密码重置流程。 你也可以通过从主题调用某个工具来测试它。
在代理中启用或禁用工具
默认情况下,新工具已开启。 关闭某个工具会阻止你的代理使用它,但会保持连接,方便你稍后重新开启。
前往你的智能体的工具页面,然后选择该工具。
在配置页面顶部,使用“启用”切换开关。
选择“保存”。
从代理中删除工具
转到你的代理的工具页面。
将鼠标悬停在工具上,然后选择三个点(...)。
选择“删除”,然后再次选择“删除”进行确认。
Tip
您只能在代理的工具页面删除工具,不能从主 Copilot Studio 工具页面删除工具。
智能体中工具的限制
- 通过使用生成式编排,一个代理最多可以拥有 128 个工具。 为了获得最佳效果,建议使用25到30。
- 在多代理编排中,每个子代理可以拥有自己的 128 个工具。