连接并配置代理 Microsoft Teams
发布代理后，您可以向 Teams 中的用户提供代理。 通过这种方式，您、您的队友以及您更广泛的组织都可以与之互动。 您必须先 至少发布一次 代理，然后用户才能在 Teams 中与代理交互。
您可以：
- 在 Teams 中自定义代理的外观
- 在 Teams 中为自己安装代理
- 与其他用户共享代理的安装链接
- 在 Teams 应用商店中显示代理。
- 通过将代理 添加到 Teams 应用商店 代理扩展部分，向共享用户 显示 #。
- 通过提交代理以供管理员批准，向组织共享代理以在 为 Teams 应用商店的组织部分构建。
- 将代理添加到团队渠道。
- 下载代理的应用清单，以便在 Teams 租户中分发它。
当您向 Teams 添加代理时，您的一些数据（例如代理内容和最终用户聊天内容）将与 Teams 共享。 您的数据可能会超出您的组织的合规性以及地理或区域界限。 有关更多信息，请参阅了解 Teams 应用程序的权限和访问的信息。
先决条件
- 与其他用户 共享代理，以便他们可以在 Teams 中安装代理并与之聊天。
- 您的组织必须允许 Microsoft Power Platform 将应用程序添加到 Teams，然后您或其他用户才能直接在 Teams 中安装代理或在 Teams 应用商店的代理扩展 部分找到它 。 如果您的组织已禁用它，请与您的管理员一起在 Microsoft Teams 管理中心管理 Microsoft Power Platform 应用。
- 出现在 为您的组织 构建部分（由管理员批准）的代理由 Teams 管理中心的 管理应用程序页面中的管理员单独管理。
- 在为自己安装代理或与他人共享之前，您应该 至少发布一次代理 。
连接频道的代理 Microsoft Teams
至少发布一次代理后，您可以将其连接到频道， Microsoft Teams 以允许用户在 Teams 中与它聊天。
备注
我们建议您 为为 Teams 或内部员工使用的代理启用安全设置 ，以防止组织外部的个人使用这些代理。
选择启用 Teams。
备注
如果未看到此选项，可能由于 Microsoft Teams 渠道已启用。
自定义 Teams 的代理的外观
在将代理提供给其他用户之前，提供正确的描述和外观非常重要，因为它可以告知他们代理的用途和品牌（如果适用）。
选择 编辑详细信息 以更改代理的图标、颜色和描述。 这些属性在 Teams 应用商店和用户安装代理后在应用的 About 选项卡上可见。 查看 Teams 应用程序图标格式指南。
重要提示
对于已从共享链接或 Teams 应用商店的代理扩展 部分安装代理的用户，无法更改代理的详细信息。 用户必须重新安装代理才能获取更新。
对于已获得 管理员批准的代理，您必须重新提交代理以供审批。
选择更多以添加以下信息：
- 开发人员姓名
- 网站
- 隐私声明
- 使用条款
您应该提供此信息以告知用户您的代理。 有关更多信息，请参阅在 Microsoft Teams 中创建隐私声明和使用条款。
选择保存。 您对颜色、图标和简短描述的更改现在可以在配置面板上看到。
备注
本节中的图标自定义仅适用于管理员批准的代理 的代理头像，不适用于通过直接 安装链接 或从 Teams 应用商店 代理扩展 部分安装代理 的用户。 您可以在自定义代理 的外观中自定义代理头像。
在 Teams 中将代理安装为应用程序
发布代理后，您可以直接将 Copilot Studio 代理添加到您自己的 Teams 个人资料中。
重要提示
新发布的代理中的新内容不会显示在当前正在进行的对话中。
您可以在现有对话中键入“重新开始”以立即开始新对话并查看代理的最新更新。
我们建议您先将代理添加到 Teams 中您自己的个人资料中，然后再与他人共享。
选择 打开代理 以在 Teams 中启动安装提示。 选择添加将其添加为 Teams 中的应用。 此操作仅为您安装代理。
共享链接，以便其他人可以安装代理
选择可用性选项。
选择复制链接。
共享用户链接，以便他们可以在 Teams 中安装代理。
重要提示
只有可以访问代理的用户才能使用安装链接安装代理。 您可以 共享代理 以授予用户对代理的访问权限。
无法在 Teams 移动应用程序中使用安装链接。 要确保您的代理可供 Teams 移动用户使用，请将其 配置为在 Teams 应用商店中显示。
在 Teams 应用商店中显示代理
发布代理后，您可以在 Teams 应用商店中显示它，以便用户可以找到并安装它。
向共享用户显示
您可以通过将代理添加到 Teams 应用商店的代理扩展 部分来共享它。 只有 共享用户 才能在那里找到代理。
重要提示
只有共享用户才能在 Teams 应用商店的代理扩展 部分中找到和安装代理。 即使代理配置为允许所有人使用代理，也不会对组织中的每个人显示 #。 要 向组织显示代理，请提交代理以供管理员批准，以在 Teams 应用商店的 Built for your organization（为您的组织 构建）部分中显示它 。
如果共享用户总数不超过 Teams 应用商店发现策略 对租户施加 的限制，则代理只能显示在 Teams 应用商店的代理扩展 部分中。 要向更多用户提供代理，请与您的管理员合作，向 组织显示代理。
选择可用性选项。
选择 向我的团队成员 显示并查看谁有权访问代理。
确认 Visible in 代理 extensions 复选框已选中，然后选择 共享。
您的代理将在 Teams 应用商店的代理扩展部分中可用 ，并且绿色 的“已添加到 Teams ”标签将显示在可用性选项页面 中。
备注
如果您的应用程序未显示在 代理 extensions 部分中，则您的 Teams 应用程序可能正在缓存信息。
请尝试注销，然后重新登录（如果您使用的是 Teams 桌面应用）或刷新您的浏览器（如果您使用的是 Teams Web 应用）。
从代理 extensions 部分中删除代理
您可以从代理 extensions 部分删除代理 。 从那里删除代理不会影响安装了代理的用户。
选择可用性选项。
选择 Show to my teammate（向我的团队成员显示）并清除 Visible in 代理 extensions（在 # 扩展 中可见） 复选框。
选择共享。 代理不再显示在 Teams 应用商店的代理扩展 部分中。
向组织显示
您可以通过提交 # 以供管理员批准来与您的组织共享代理在 Teams 应用商店的为您的组织 构建部分中展示 。 在“为您的组织 构建”中 展示您的应用程序是一种广泛分发代理的好方法，方法是与管理员合作，将其推广给组织中的每个人或一部分用户。
管理员还可以使用 应用设置策略 为组织中的用户自动安装和固定代理，以便他们可以直接从 Teams 中的应用栏访问它。
在向组织提交代理之前，请确保：
- 您的代理已准备好发布并符合公司标准、规则和政策。
- 您与其他代理经理协调。 提交代理后，其他用户无法重新提交，直到管理员批准或拒绝之前的提交。
- 如果适用，您可以从 Teams 应用商店的代理扩展 部分中删除代理 。 否则，如果您提交代理以供管理员批准，它最终可能会显示在两个位置。
备注
管理员批准代理后，为您的 组织 构建部分中的代理可用性将由您的管理员管理。只有管理员才能从 Built for your organization（为您的组织 构建）部分中删除代理。
为 Built for your organization 部分提交代理
选择可用性选项。
确认代理未向团队成员或共享用户显示。 如果显示 Added to Teams ，请将其删除。
选择对我组织中的所有人显示。
查看提交要求，然后选择提交以供管理员审批。
备注
确保您查看了内容，已经准备好供管理员审核。 您必须提交新的批准请求，以 更新之前批准的代理的图标和描述 。
获得批准后，Teams 中代理的所有新用户和现有用户都会收到更新。
这仅适用于代理详细信息。 您仍然可以对代理进行内容更新，并根据需要随时发布。 发布此类内容更改后，您无需再次提交代理以供审批。
系统会显示最终确认提示。
选择是继续。 代理将发送给您的管理员 进行审批，您可以看到一条说明，指示您的提交状态。
备注
提交代理以供管理员审批后，您不应将代理的访问权限设置更改为少于组织中的每个人。
设置为 less than everyone 会导致组织中的用户在从 Teams 应用商店的 Built for your organization 部分安装代理后无法与 #聊天。
与管理员一起处理 Microsoft Teams 应用程序策略 ，以确定谁可以找到并安装代理。
等待管理员审批。 您可以通过选择 Refresh 或从 Publish页面打开 Make the 代理 available to others 窗口 来 检查最新状态。
管理员批准代理后，状态将更新为 Approved（已批准）。 您可以直接打开代理并与其他用户共享已批准版本的链接。
（可选）要求管理员 使用应用程序设置策略 为组织中的用户自动安装和固定代理，以便他们可以直接从 Teams 中的应用栏访问它。
备注
如果即使已标记为已批准，您的应用仍未出现在为组织构建部分，这可能是由于您的 Teams 应用正在缓存信息。
请尝试注销，然后重新登录（如果您使用的是桌面应用）或刷新您的浏览器（如果您使用的是 Teams Web 应用）。
允许用户在 Teams 中向团队添加代理
在 Teams 中，用户可以 向特定团队添加代理。 一旦代理可用于团队，团队成员就可以在任何团队频道中“@mention”它，并且所有团队成员都能看到代理的响应。 此功能对于以下示例非常有用：
- 您的代理支持协作，例如与销售团队的其他成员共享最新的销售报告见解。
- 您希望允许所有团队成员在团队频道中或通过私人聊天与代理互动，而无需自己手动安装代理。
两个选项确定用户是否可以将代理添加到他们所属的任何团队，或者添加到 Teams 中的群组和会议聊天。 选择这些选项后，代理可以从团队频道、群聊或会议聊天访问对话历史记录，这有助于代理提供更适合对话上下文的答案。
当用户从 Teams 应用商店 或使用安装链接 安装代理时，他们可以看到以下选项之一，具体取决于您为代理设置的协作范围：
- 将代理添加到团队渠道
- 将代理添加到 Teams 中的群组和会议聊天
团队成员还可以 从团队中删除代理。
重要提示
应将代理配置为允许组织中的每个人都与它聊天。 这可确保所有团队成员都有权与代理聊天。 我们建议在启用此功能后不要更改代理的安全设置。 否则，当用户尝试在 Teams 频道或群聊中与代理交互时，可能会看到权限错误。
要允许用户向团队添加代理：
选择编辑详细信息。
选择 允许用户将此代理添加到团队。
选择保存。
Teams 会缓存信息，因此用户可能需要一段时间才能看到将代理添加到团队或群组聊天的选项。 用户可以刷新浏览器（或退出 Teams 桌面客户端，然后重新登录）以获取最新的更改。
如果您之前 提交了代理以供管理员审批，则必须在启用此选项后再次提交。 管理员必须先批准您的更改，然后用户才能从 Teams 应用商店的 Built for your organization（为您的组织 构建）部分将代理添加到他们的团队。
阻止用户将代理添加到团队或群组和会议聊天
禁用此选项会阻止用户将代理添加到新的团队、群组或会议聊天中。 如果您已将代理添加到对话中，则禁用此选项不会将其删除。 您必须手动 删除 代理。
要阻止用户向团队添加代理：
选择编辑详细信息。
清除 Allow your users to add this 代理 to a team 复选框。
选择保存。
配置私人问候行为
当您希望团队成员与代理进行一对一对话，而无需自己安装代理时，来自代理的私人问候非常有用。
备注
私人问候配置仅适用于经典聊天机器人。
启用后，您的代理会自动开始与团队成员的对话。 要自定义代理的问候消息， 请修改 Greeting 系统主题。
考虑代理与团队成员的相关性。 确保代理的问候有助于他们了解如何使用它，描述其局限性，最重要的是，让他们能够舒适地与它互动。
要配置代理发送私人问候语的时间：
选择设置。
配置私人问候选项。
选择保存。
下载代理（高级）的 Teams 应用清单
您可以下载代理的 Teams 应用程序清单，以直接对清单进行详细更改，并与租户中的管理员或用户共享。 如果您的组织的策略允许您上载自定义应用程序，您还可以将应用清单直接上载到 Teams。
选择可用性选项。
选择下载 .zip。
清单将生成为 .zip 文件，根据浏览器的保存设置进行保存。
断开代理与 Teams 的连接
您可以将代理脱机，这样用户就无法再在 Teams 中与代理聊天。 当您的代理离线时，它不会响应任何尝试与它聊天的人。 在执行此操作之前，您应该彻底考虑是否需要断开代理。
断开连接的代理不会显示在 Teams 应用商店的代理扩展 部分中，并且无法从共享链接安装。 如果用户已在 Teams 中安装了此类代理，则在用户卸载它之前，它一直可用。
断开管理员批准的代理后，它将继续显示在 Teams 应用商店的“为你的组织 构建”部分中。 您必须要求您的管理员删除。
选择与 Teams 断开连接。
查看有关断开代理的信息，然后选择 断开连接 以继续。
您始终可以通过在 Publish（发布 ）页面上的 Make the the 代理 available to others（使 # 对其他人 可用）窗口中 选择 Turn on Teams（打开团队 ）来重新连接您的代理。
打开 Microsoft Teams 渠道的配置面板
打开你的代理 Copilot Studio。
在顶部菜单栏上，选择渠道。
选择 Microsoft Teams 磁贴。 将显示配置面板。
已知限制
- 使用升级后的 统一创作画布 的代理不支持私人问候语配置。
- 在详细信息页面上设置代理头像图标 不会显示给管理员批准的代理。管理员批准的代理使用应用程序图标作为代理头像。
- Teams 对代理有 速率限制 。 根据您的业务需求，您可能希望为添加到 Teams 的代理保持代理内容简洁。
- 目前，如果您的代理支持 最终用户身份验证，则用户无法显式注销。如果您在卖家控制面板中发布代理，则此行为将无法通过 Microsoft Teams AppSource 认证。 此限制不适用于代理的个人或租户使用。 了解有关如何将您的应用发布到 Teams 商店以及 AppSource 认证政策的更多信息。
- 断开代理与 Microsoft Teams 频道的连接后，Teams 中的用户可能需要几分钟时间才能无法访问代理。
- 群聊和会议聊天不支持配置为 使用 Teams 单点登录（SSO）进行手动身份验证 的代理。 根据您的业务需求，您可以通过 Microsoft 进行身份验证，或者从您的手动身份验证中删除 Teams 的 SSO。