Copilot Studio代理生成器提供了一个简单的界面，可用于使用自然语言或手动快速轻松地生成声明性代理。
若要开始使用Copilot Studio代理生成器，请打开Microsoft 365 Copilot 应用，然后在右侧选择“创建代理”。 还可以选择“从Teams 中的 Microsoft 365 Copilot创建代理。
注意
Copilot Studio代理生成器的功能因用户的许可证而异。 有关详细信息，请参阅 Microsoft 365 用户的代理功能。
可以通过两种方式创作声明性代理：
- 使用自然语言通过“ 描述 ”选项卡
- 通过“ 配置 ”选项卡，可在其中手动生成
这两个选项卡均可无缝工作，以提供丰富的创作体验。
注意
仅当Microsoft 365 语言设置为可用语言之一时，“描述”选项卡才可用。 如果首选语言不支持“描述”选项卡，可以通过“配置”选项卡生成代理。
描述代理
“描述” 选项卡允许使用纯语言创建代理。 当你以对话方式提供信息时，代理的名称、说明和说明会不断更新，以优化代理的行为。 此体验提供了一种丰富而简单的自然语言方法来创建自定义代理。 创建代理后，可以返回到代理，并使用“ 描述 ”选项卡使用自然语言对其进行更新。
通过回答代理生成器提出的问题，以纯语言生成代理。 生成器会在对话的每一轮中逐步更新代理，并自动保存更改。 可以在对话的任何轮次中对代理进行更新。 对代理名称、说明和说明的更改会自动更新。 但是，不能直接从“ 描述 ”选项卡添加图标或知识源。使用“ 配置 ”选项卡可添加图标、知识源或功能。
配置代理
除了使用“ 描述 ”选项卡外，还可以使用“ 配置 ”选项卡直接配置代理的行为。
“ 配置 ”选项卡使你能够查看和编辑有关代理的信息，从而提供更多的控制和更精确的信息。 “ 描述 和 配置 ”选项卡处于同步状态。“配置 ”选项卡中的字段 更新以反映“ 描述 ”选项卡中的最新更改。你可以在选项卡之间切换，以使用最适合你创作代理的体验。
下表描述了构成代理的字段。
| 字段 | 说明 |
|---|---|
| Name | 代理的名称。 使用描述性且独特的名称。 字符限制为 30 个字符。 |
| Icon | 你可以手动上传图像来表示代理并赋予其独特个性。
|
| 说明 | 该说明可帮助大型语言模型 （LLM） 识别并使用代理执行特定任务或情况。 使其尽可能简短、精确和简单。 它还显示在应用文件中，以便在应用目录中使用。 字符限制为 1,000 个字符。 |
| 说明 | 你希望用于扩展智能 Microsoft 365 Copilot 副驾驶® 功能的 LLM 的具体说明。 这些说明指导代理的行为，包括其任务及其完成方式。 如果你使用的是“ 描述 ”选项卡，系统会为你自动生成它们。 字符限制为 8,000 个字符。 有关详细信息，请参阅 编写有效说明。 |
| 知识 | 最多可以指定 20 个知识源 (包括 SharePoint 网站、文件夹和文件) 或 Copilot 连接器。 有关详细信息，请参阅添加知识源部分。 |
| Capabilities | 你可以通过添加功能来增强声明性代理的用户体验。 有关详细信息，请参阅 添加功能。 |
| 初学者提示 | 初学者提示可帮助其他用户了解代理通常支持的方案。 每个初学者提示都附带一个名称和说明。 没有初学者提示的最小数量。 |
试用代理
右窗格中的代理是代理的临时实例，在创作体验中显示为并排屏幕。 可以在创建代理或对其进行更新时使用它来测试代理。 可以在测试窗格中测试代理，以与最终用户类似的方式体验代理。 在代理具有名称、说明和说明后，将启用测试窗格。 它的行为与完全启动的代理类似这些说明，包括能够响应指定知识范围内的复杂查询。 每次会话期间，代理都会更新，因为新信息将添加到“ 描述 ”或“ 配置 ”选项卡中。
在测试窗格中看到的代理尚未创建，因此某些功能不可用。 例如，不能使用它在Microsoft 365 Copilot 应用中共享提示、@mention提供反馈或其他代理。 创建代理后，这些功能将变为可用。
测试窗格最初显示有建议的初学者提示，单击该提示时会调用提示并启动对话。 可以选择“ 新建聊天 ”以与代理开始新的对话，以便再次查看初学者提示。
添加知识源
代理生成器允许配置代理要引用的特定知识源。 若要生成上下文感知代理，可以引用 SharePoint 项或任何公共网站。 如果用户具有智能 Microsoft 365 Copilot 副驾驶®加载项许可证，还可以将代理放在个人工作信息（如 Teams 聊天消息和 Outlook 电子邮件）中，或使用预生成的智能 Microsoft 365 Copilot 副驾驶®连接器 (以前Microsoft Graph 连接器) 在你的租户中启用。
若要添加知识源，请在代理生成器的“ 配置 ”选项卡上：
在搜索栏中搜索项。
在搜索栏中粘贴或键入 URL。
单击搜索栏并使用选取器选择项目。
网站
SharePoint 文件、文件夹和网站
从设备上传的嵌入文件
智能 Microsoft 365 Copilot 副驾驶®连接器 (以前Microsoft Graph 连接器)
网站
可以将特定公共网站添加为代理知识源，使代理上下文感知。 引用网站作为知识源时，以下限制适用：
- 公共网站 URL 必须只有两个级别：例如，
https://example.org/a/b/c是无效的 URL，因为它超过两个级别。 - URL 不能包含查询参数;例如，
https://example.org?test=1无效。 - 最多可以添加四个 URL。
若要将代理配置为使用任何 Web 数据作为知识，请在“ 配置 ”选项卡上单击“ 知识 ”框，然后选择“ 所有网站”。
SharePoint 内容
可以将特定的 SharePoint 网站、文件和文件夹引用为代理知识源。 从 SharePoint 引用源时，请考虑以下限制：
- 每个代理总共可以选择 20 个知识源(包括、文件夹和文件)。
- 已上传到 SharePoint 的文件可能具有现有的权限和 敏感度标签，在代理生成响应时会遵循这些标签。
有关 SharePoint 知识文件大小限制的信息，请参阅 文件大小限制。
重要
如果 启用受限的 SharePoint 搜索 ，则无法将 SharePoint 用作知识源。
输入 SharePoint 网站、文件夹或文件的 URL
您可以输入 SharePoint 网站、文件夹或文件的 URL，例如 contoso.sharepoint.com/sites/policies。 代理会搜索 URL 和子路径。 例如，如 的 contoso.sharepoint.com/sites URL 还包括子路径，例如 contoso.sharepoint.com/sites/policies。 代理使用相关信息提供目标响应。
提供 SharePoint URL 后，按 Enter 将其添加为知识源。
SharePoint 文件选取器
还可以通过选择 “知识 ”部分中的云图标，从 SharePoint 文件选取器中选择文件或文件夹。 选取器上的左窗格显示最近访问的 SharePoint 网站。 若要查看更多 SharePoint 网站，请选择“更多位置”。 如果最近创建了一个网站，它将在几分钟后显示。
注意
SharePoint 选取器可能不会显示你有权访问的所有通信网站。 通信网站仅显示在 SharePoint 选取器的“快速访问”和“最新动态”部分中。
选择网站后，可以选择多个文件和文件夹。 这样做会将 SharePoint 文件或文件夹添加到代理的知识源。 当同一网站包含多个文件夹时，选择文件夹名称旁边的按钮以查看其他文件夹。
还可以使用选取器将文件上传到 SharePoint。 文件在完成上传后会显示在同一文件夹中，可供代理生成器使用。
文件就绪情况
将新文件上传到 SharePoint 时，可能需要几分钟时间才能让代理将其包含在响应中。 如果源未就绪，仍可在测试窗格中测试代理。 但是，在准备就绪之前，响应不包括新上传的文件中的信息。
可以通过查看“配置 ”选项卡中的 “知识 ”部分来检查文件准备情况;文件旁边有“正在准备”一词。 重命名或删除上传到 SharePoint 的基础文件时，代理会选取更改。 还可以选择 “知识 ”部分顶部的“重新加载”按钮，手动重新加载状态。
Teams 聊天消息
可以在 Teams 频道、组和会议聊天消息中对代理进行地面处理。 若要添加 Teams 聊天消息，请在“ 配置 ”选项卡上的“ 知识 ”部分中，单击搜索栏。 在“ 聊天 ”选项卡上，可以包括要添加为知识的特定聊天。
重要
最多可以添加五个聊天源。
如果你不想将代理的知识范围限定为特定聊天，请在 “Teams 聊天”下，选择“ 我的 Teams 聊天来自群聊、频道和会议 ”，以使用你有权访问的所有聊天消息作为知识。
Outlook 电子邮件
可以在 Outlook 电子邮件中设置代理。 若要添加电子邮件作为知识源，请在“ 配置 ”选项卡上的“ 知识 ”部分中，单击搜索栏，然后选择 “我的电子邮件”。
注意
- 无法确定电子邮件知识的范围。 添加电子邮件时，代理将使用邮箱中的所有电子邮件作为知识。
- 与你共享代理的用户无权访问你的电子邮件作为知识。
嵌入的文件内容
可以直接从设备上传文件，供代理用作知识。 上传的文件将成为代理中的嵌入内容。 若要上传文件，可以从设备拖放到“ 描述 ”选项卡或 “配置 ”选项卡。还可以选择“ 配置 ”选项卡上的箭头图标，从设备上传文件。 可以从设备上传单个文件，但不能上传文件夹。
最多可以添加 20 个文件作为知识源。
嵌入文件显示在“ 配置 ”选项卡上的“ 上传的文件”下。 文件可能需要几分钟时间才能上传，并在完全上传之前显示为灰色。 上传时间可能因文件大小和 Internet 速度而异。 有关嵌入文件的大小限制的信息，请参阅 文件大小限制。
若要删除已上传的文件，请选择该文件旁边的 X，然后选择 “删除”。
不支持具有以下任何特征的文件：
- 双密钥加密。
- 具有用户定义的权限的敏感度标签。 如果上传具有用户定义权限的文件，则代理创建会失败。
- 禁用了提取权限的敏感度标签。 如果上传这些文件，代理创建将失败。 如果代理用户没有对嵌入文件的提取权限，则用户无法访问该代理。
- 来自另一个启用了加密的租户的文件。
- 密码保护。
有关详细信息，请参阅 不支持的敏感度标签方案。
警告
将文件作为代理的知识源上传时，有权访问代理的任何用户都有权访问文件中的信息。 如果用户对文件上的任何敏感度标签没有提取权限访问权限，则对代理的访问将受到限制。
有关嵌入文件内容索引和检索的信息，请参阅 优化内容检索。
代理嵌入内容的敏感度标签
如果上传的任何文件具有敏感度标签，或者租户具有默认敏感度标签策略，则敏感 度标签 将应用于代理嵌入内容。 应用于代理嵌入内容的敏感度标签可确保代理符合组织的Microsoft Purview 策略。
应用于嵌入内容的敏感度标签是以下标签的更高优先级：
- 应用于任何嵌入文件的最高优先级敏感度标签。
- 组织应用 的默认敏感度标签策略 。
例如，如果代理中嵌入了带有“常规”标签和“机密”标签的文件，则会将机密敏感度标签应用于嵌入的内容。
注意
敏感度标签仅适用于嵌入内容;它不适用于代理引用的其他知识源，例如 SharePoint 文件或 Copilot 连接器内容。
只有对应用于嵌入内容的敏感度标签具有提取权限的用户才能访问和使用代理。 标签不会显示在智能体商店列表中。 对嵌入内容没有提取权限的用户可以查看代理和代理说明，但无法安装和使用该代理。
敏感度标签也应用于代理响应。 此标签是以下标签的较高优先级：
- 嵌入内容的敏感度标签
- 任何其他代理知识源（如 SharePoint 和 OneDrive 文件）的敏感度标签。
目前，代理生成器无法对代理设置敏感度标签。
不受支持的敏感度标签方案
下表列出了当前不支持的敏感度标签方案，描述了生成器将文件上传到代理时的行为，并为生成器提供了建议的作。
| 应用场景 | 行为 | 操作 |
|---|---|---|
| 启用了双密钥加密 (DKE) 的敏感度标签 | 该文件已嵌入，但未用作知识。 生成器在上传文件时看不到错误消息。 | 建议避免使用 DKE 上传文件，因为它们不能用作知识。 |
| 启用了用户定义的权限的敏感度标签 | 文件已上传，但代理创建失败，没有错误消息。 | 删除具有用户定义的权限的所有上传的文件。 |
| 为用户启用了提取权限的敏感度标签 | 文件已上传，但代理创建失败，没有错误消息。 | 删除启用了提取权限的所有上传文件。 |
| 具有来自另一个已启用加密的租户的敏感度标签的文件 | 该文件嵌入代理中，但不用作知识。 | 建议避免从启用了加密的租户上传具有敏感度标签的文件，因为它们不能用作知识。 |
| 具有密码保护的文件 | 文件已上传，生成器在上传的文件旁边看到一条错误消息。 | 使用密码保护删除所有上传的文件。 |
使用嵌入文件共享代理
使用嵌入文件共享代理时，文件也会共享，代理用户可以基于这些知识源从 Copilot 获取响应。 可以使用以下选项将代理与嵌入式文件共享为知识：
- 组织中的任何人
- 组织中的特定用户
- 只有你
注意
目前不支持将代理与嵌入文件共享到组。
共享代理时，如果在嵌入内容上设置了敏感度标签，敏感度标签将显示在“共享”屏幕上。
文件大小限制
下表列出了可作为知识添加到代理的文件类型，以及每种文件类型的大小限制。
| 文件类型 | SharePoint Online 限制 | 嵌入文件限制 |
|---|---|---|
| .doc | 150 MB | 30 MB |
| .docx | 512 MB | 30 MB |
| .html | 150 MB | 不适用 |
| 512 MB | 30 MB | |
| .ppt | 150 MB | 30 MB |
| .pptx | 512 MB | 30 MB |
| .txt | 150 MB | 30 MB |
| .xls | 150 MB | 30 MB |
| .xlsx | 150 MB | 30 MB |
Copilot 连接器
Copilot 连接器允许代理包含来自外部存储库或系统（如客户帐户、事件票证和知识文章）的知识。 管理员必须在Microsoft 365 管理中心中启用和配置 Copilot 连接器。 最初，连接器可能会在知识源的“从组织”部分中折叠。
如果至少已启用一个连接器，则可以将其添加到代理。 代理能够回答与该连接器相关的问题。 根据连接器的配置方式对从连接器检索到的信息进行索引和刷新。 代理可以引用索引数据中的相关信息，并将最终用户链接到数据源。
添加功能
在“配置”选项卡的“功能”部分中，可以选择将以下功能添加到代理：
若要向代理添加一个或多个功能，请选择要启用的功能旁边的切换开关。
从模板生成
Copilot Studio代理生成器包括可用于针对特定用例生成代理的模板。 模板已预先配置说明、说明和提示。 可以按原样使用模板，也可以根据特定需求自定义模板，包括添加知识源和功能。 有关详细信息，请参阅 代理生成器模板概述 或选择代理生成器中 “描述 ”或“ 配置 ”选项卡上的模板之一。