启用深度链接以访问 Microsoft Teams 中的 Automation Co-Pilot

本主题解释了如何获取所需的标识符并汇编一个 Microsoft Teams 深度链接，该链接可将 Automation Co-Pilot 直接打开到 Microsoft Teams 内的特定请求。

先决条件

要构建一个可用的深度链接，您需要
应用程序 ID
Microsoft Teams 应用程序的 ID（有时在 Teams 应用配置中称为 Microsoft 应用程序 ID）。
实体 ID
个人选项卡的标识符（您想在 Microsoft Teams 内打开的选项卡）。
请求 ID
您希望链接打开的 Automation Co-Pilot 请求参考。

过程

  1. 创建或打开您的 Teams 应用程序（应用程序 ID）。
    1. 打开 Microsoft Teams 开发人员门户。
    2. 选择应用程序。
      如果您已经有一个用于 Automation Co-Pilot 的应用程序，请打开它。 否则，选择创建一个新应用程序并输入所需的详细信息，例如名称、描述、开发人员信息。
    3. 复制为该应用程序显示的应用程序 ID（在深度链接 URL 中使用）。
    您已获得一个应用程序 ID。
    例如：
    https://teams.microsoft.com/l/app/96bfc9ea-ffac-410d-96ca-df449bl83cl3?source=manage-apps-copy-link
    这里，96bfc9ea-ffac-410d-96ca-df449bl83cl3（app/ 之后的部分是应用程序 ID。
    <APP_ID> 已创建。
  2. 配置一个个人选项卡并捕获实体 ID。
    1. 在同一个应用程序的 Teams 开发人员门户中，转到应用程序功能。
    2. 定位个人应用程序（或个人选项卡，具体取决于门户视图）。
    3. 添加一个个人选项卡（如果已拥有，可进行编辑），并输入以下详细信息，例如：
      • 名称：Automation Co-Pilot
      • 内容 URL：您的选项卡加载的网页 URL（由您的 Automation Co-Pilot 配置提供）
      • 网站 URL（可选，但推荐输入）：一个适合浏览器使用的 URL
    4. 保存配置。
    5. 复制该个人选项卡的实体 ID。
    您获得了一个实体 ID。 例如，0eff0783-9304-4daa -9f6e-dfe0e8d0cfb3
  3. 获取请求 ID (Automation Co-Pilot)。

    您可以使用以下方法之一来捕获表示您希望深层链接打开的请求 ID。

    • 从请求页面复制
      • 打开 Automation Co-Pilot 并导航到该请求。
      • 从 UI 中复制请求参考（例如：Request Ref），

        或

      • 如果请求参考出现在路由中，请从 URL 复制。

      路由中常见的格式包括 requests/ref/<REQUEST_ID>。 例如，requests/ref/62-152

    • 从通知有效负载中复制（如适用）

      如果您的流程发送的消息或通知中包含请求参考，请直接从该有效负载中复制请求参考。

    您获取了请求 ID。 例如，requests/ref/62-152
  4. 构建深度链接。
    Teams 个人选项卡深层链接使用以下格式：
    https://teams.microsoft.com/l/entity/<APP_ID>/<ENTITY_ID>?<DEEP_LINK_PARAMETER>

    要在选项卡中打开特定请求，请传递一个 Teams context 参数，并使用 subEntityId 指向该请求路由。 要构建深度链接，

    1. 将子实体路由定义为 subEntityId = "requests/ref/<REQUEST_ID>"。 例如，requests/ref/62-152。
    2. 创建上下文 JSON，例如：{"subEntityId":"requests/ref/<REQUEST_ID>"}。
    3. 对 context 参数进行 URL 编码。

      Teams 要求对查询字符串进行编码。 参数通常为 context=<JSON>。 例如，（编码前）：context={"subEntityId":"requests/ref/62-152"}。

      对整个值进行 URL 编码，并将其附加在 ? 之后。

    4. 最终深层链接的示例（模板）为 https://teams.microsoft.com/l/entity/<APP_ID>/<ENTITY_ID>?<URL_ENCODED_CONTEXT>，其中 <URL_ENCODED_CONTEXT> 是以下内容的编码形式：context={"subEntityId":"requests/ref/<REQUEST_ID>"}
  5. 在 Microsoft Teams 中测试深度链接。
    1. 将深度链接粘贴到 Teams 聊天或频道消息中。
    2. 选择链接。
    Teams 会打开 Automation Co-Pilot 应用程序选项卡，并直接导航到预期请求。