通过

在开发人员门户中管理应用

在 Microsoft Teams 中上传应用后，可以在开发人员门户中管理应用。 本文提供有关应用配置、分析和验证的综合指南，以增强 Teams 应用体验。
此外，你将了解代理标识蓝图，以创建和管理代理的代理标识。

概述

在 “概述 ”部分中，可以看到用于管理应用的以下组件：

  • 仪表板

    • 在“概述”部分下的“仪表板”中，可以看到应用的以下组件：

      • 建议：应用验证工具根据查看应用时Microsoft使用的测试用例检查应用包。
      • 公告：开发人员门户上应用的最新更新。
      • 活动用户 (预览版) ：显示活动用户计数。
      • 基本信息：显示 应用 ID、 版本、 清单版本和其他基本信息。

      屏幕截图是一个示例，显示你在开发人员门户中创建的应用的“概述”页。

  • 分析

    在“概述”部分的“分析”部分中，可以大致了解应用的使用情况、参与度和其他见解。 有关详细信息，请参阅 如何分析应用的使用情况。

配置

若要在 Teams 中安装和呈现应用，必须包含一组可由 Teams 识别的配置。 若要在 Teams 中上传应用，需要具有应用清单，其中包含在 Teams 中显示应用的所有应用详细信息。 这可以通过开发人员门户中提供的组件和工具来实现。

屏幕截图是一个示例，演示如何配置功能以管理和访问开发人员门户中的应用。

在 “配置” 部分中，可以看到用于管理和访问应用的以下组件：

  • 基本信息：本部分显示并允许编辑 应用名称、 应用 ID、 说明、 版本、 开发人员信息、 应用 URL、 应用程序 (客户端) ID，以及 Microsoft合作伙伴网络 ID (CCP ID) 。

  • 品牌打造：此部分允许你添加格式的.png“颜色”图标和“大纲”图标。

  • 应用功能：此部分允许向应用添加以下功能：

    • 个人应用
    • Bot
    • Connector
    • 现场
    • 组和频道应用
    • 消息传递扩展
    • 会议扩展
    • 活动源通知

    注意

    连接器在政府社区云 (GCC) 中可用，但在 GCC High、国防部 (DoD) 以及由世纪互联环境运营的 Teams 中不可用。

  • 应用包编辑器：此部分允许你为 Teams 创建、管理和自定义应用包。 与 Visual Studio Code 类似，它使你能够无缝编辑应用的组件，包括清单、图标、Copilot 代理文件、场景、JSON 和 YAML 文件。 还可以将声明性代理及其相关文件添加到应用包中。

    屏幕截图显示了 Teams 开发人员门户中的应用包编辑器。

    编辑或将新文件添加到应用包后，可以放弃或更新包。 如果选择“ 更新”，开发人员门户会评审文件并识别错误。 可以保存包含错误的包，但必须在发布之前解决这些问题。

    屏幕截图显示了用于更新 Teams 开发人员门户中新文件的应用包编辑器。

    注意

    如果应用清单版本为 v1.19，可以通过此应用包编辑器添加声明性代理。 若要创建声明性代理，请添加用于定义代理行为的 JSON 文件。 还可以创建 YAML 文件来定义自定义 API，并将其连接到声明性代理。


    使用开发人员门户将声明性代理添加到应用包

    在将声明性代理添加到应用包之前，请确保应用包已更新到最新版本 v1.19。

    1. 在 Teams 开发人员门户中，从左窗格中选择“ 应用 ”，然后选择你的应用。

    2. 转到 “配置>应用包编辑器”。

      屏幕截图显示了 Teams 开发人员门户中的应用包编辑器。

    3. 在“manifest.json文件的作”下选择省略号 (...) ，然后选择“编辑”。

      屏幕截图显示了用于编辑应用包的应用包编辑器。

    4. 添加清单属性 copilotAgents 和子属性 declarativeAgents，并定义所需的详细信息。 选择“保存”。

      屏幕截图显示如何将声明性代理添加到应用包中。

    5. 选择“ 新建文件>JSON 文件 ”并定义代理的行为。

      屏幕截图显示如何将声明性代理行为添加到应用包中。

    6. 选择“更新”。

      屏幕截图显示如何将声明性代理行为更新到应用包中。

      现在，开发人员门户会评审文件并识别任何必须在发布之前解决的错误。

  • 权限：此部分允许你为应用授予 设备权限、 团队权限、 聊天/会议权限和 用户权限 。

    注意

    RSC 权限的最大限制为 16。

  • 单一登录：在 Microsoft Entra ID 上注册的机器人支持单一登录 (SSO) 。 如果在 Bot Framework 门户 (或在“机器人管理) ”下的开发人员门户中注册机器人，则机器人不支持 SSO，并且必须在 Microsoft Entra ID 上注册机器人才能支持 SSO。 对于在 Microsoft Entra ID 上注册的机器人，请添加应用程序 ID URI。 若要从Microsoft Entra ID获取应用程序 ID URI，请参阅如何使用机器人的 SSO 身份验证。

  • 语言：本部分允许设置或更改应用的语言。

  • 域：此部分允许你添加域以在 Teams 客户端中加载应用，例如 *.example.com。

高级

在 “高级 ”部分中，可以看到以下组件用于在开发人员门户中管理应用：

  • Owners

    每个应用都包含一个 “所有者” 页面，你可以在其中与组织中的其他人共享应用注册。可以添加 管理员 和 作 角色，以管理谁可以更改应用设置。 作角色具有权限，例如更新应用的配置。 管理员角色具有权限，例如更新应用配置、添加或删除所有者以及删除应用。 如果应用没有活动所有者，则管理员可以通过在 Teams 开发人员门户中输入应用 ID 来拥有应用。

    若要添加所有者：

    1. 在 “高级 ”部分中，选择“ 所有者”。
    2. 选择 “添加所有者”。
    3. 输入名称并从下拉列表中选择用户 ID。
    4. 在 “角色”下，选择“ 作” 或“ 管理员”。
    5. 选择“添加”。

  • 应用内容：可以使用以下功能配置应用：

    • 正在加载指示器：显示一个指示器，让用户知道托管的应用内容 (例如， (TeamsJS v1.x) ) 中称为任务模块的选项卡和对话框。
    • 全屏模式：显示不带应用标头的个人应用。 组织发布的应用支持它。
    • 支持的通道类型：列出应用支持的非标准通道类型。
    • 默认组功能：对于支持多个组功能的应用（如团队、群组聊天或会议），请选择默认功能，以便在从 Microsoft Teams 应用商店添加应用时导航用户。

  • 环境

    你可以配置环境和全局变量，以帮助将应用从本地运行时过渡到生产环境。 全局变量将用于所有环境。

    若要设置环境，请执行以下步骤：

    1. 在开发人员门户中，选择正在使用 的应用 。
    2. 转到“高级”部分下的“环境”。
    3. 选择“ + 添加环境>添加”。

    • 全局变量

      1. 选择“ 添加全局变量 ”，为环境创建配置变量。

      若要使用全局变量，请：

      使用变量名称而不是硬编码值来设置应用配置。

      1. 在开发人员门户的任何字段中输入 {{。 此时会显示一个下拉列表，其中包含为所选环境创建的所有变量以及全局变量。
      2. 例如，在下载应用包 (之前，在准备好发布到 Teams 应用商店) 时，请选择要使用的环境。 你的应用配置会根据环境自动更新。

  • 计划和定价：可以链接在合作伙伴中心为应用创建的软件即服务 (SaaS) 产品/服务。

  • 管理员设置：

    • 应用自定义：可以通过选择不同的属性（如 名称、 简短说明、 小图标和其他属性）来自定义应用。
    • 默认情况下阻止应用：在 Teams 管理员选择启用应用之前，可以默认阻止用户的应用。

开发

在“开发”部分中，可以在 Visual Studio Code 和 Visual Studio Microsoft 365 代理工具包 (以前称为 Teams 工具包) 中打开和开发应用。 有关详细信息，请参阅 使用 Microsoft 365 代理工具包开发应用。

发布

在 “发布 ”部分中，可以将应用发布到组织或 Teams 应用商店。

  • 应用包：应用包描述如何配置应用，其中包括清单中的应用功能、所需资源和其他重要属性。 应用定义是指与应用程序关联的配置和设置。 “图标”选项卡显示用于应用的图标。

  • 应用验证：根据Microsoft用于查看应用、应用清单、应用基本信息和机器人功能的测试用例评估应用包。 应用验证工具可识别应用包中的任何错误或警告，并提供解决方法指南。

    屏幕截图显示了 Teams 开发人员门户中的应用验证入门。

    如果应用未通过任何测试用例，你可以查看指南，并根据Microsoft测试用例结果对应用包进行必要的更新。 还可以下载应用包和验证报告。 有关Microsoft测试用例的详细信息，请参阅 Teams 应用商店验证指南和商业市场认证策略。


    验证应用包

    若要确保应用在 Teams 中按预期运行，请使用应用验证工具针对Microsoft的测试用例检查应用包：

    1. 在 Teams 开发人员门户中，从左窗格中选择“ 应用 ”，然后选择你的应用。

    2. 转到 发布>应用验证>入门。

      屏幕截图显示了 Teams 开发人员门户中的应用验证。

    3. 选中 “验证确认” 下的所有复选框，然后选择 “开始验证”。

      屏幕截图显示了应用包的应用验证确认。

      注意

      • 在开始验证之前，请解决任何应用清单错误。
      • 在任何给定时间，只能为特定应用提交一个验证请求。 当前验证完成后，可以启动后续请求。

      Teams 开发人员门户现在开始验证应用包：

      屏幕截图显示正在进行的应用验证。

      应用验证状态更新如下：

      1. 创建：选择“ 开始验证”后。
      2. 正在进行：应用验证已启动。
      3. 已完成：已完成应用验证。

      可以选择“ 刷新状态” ，在验证状态为 “正在进行” 时检索最新验证状态。

      显示应用验证状态的屏幕截图。

    4. 验证后，它会显示应用已通过或失败的测试用例列表。 下面是可用的应用验证测试结果状态：

      状态 Validation 结果 说明
      Success 完成 通过 没有任何问题。
      警告 完成 通过 修复此问题是可选的，但建议这样做。
      错误 完成 失败 若要成功发布应用，需要修复此问题。
      已跳过 不完全的 不适用 我们无法继续验证检查。 这可能是暂时性的问题。 建议稍后重新运行测试。

      屏幕截图显示了应用验证工具结果。

    注意

    • 只有具有机器人功能的应用才支持应用验证。
    • 应用验证工具根据在提交到 Microsoft Teams 应用商店之前用于应用评审的测试用例Microsoft评估应用包。 在提交应用之前，请解决错误或警告并阅读应用 提交清单 。

  • 发布到组织：

    1. 在开发人员门户中，选择正在使用 的应用 。
    2. 转到 “发布” 下的“ 发布到组织”。
    3. 选择 “发布应用”。

  • 发布到应用商店：

    1. 在开发人员门户中，选择正在使用 的应用 。
    2. 转到 “发布” 下的“ 发布到应用商店”。
    3. 选择“发布”。

    可以通过从“发布到应用商店”页中选择“下载应用包”按钮来下载应用包。

直接在 Teams 中测试应用

开发人员门户提供用于测试和调试应用的选项：

  • 在“概述”页上，可以看到快照你的应用是否已配置并针对 Teams 应用商店测试用例进行验证。
  • “Teams 中的预览”按钮会在 Teams 客户端中快速启动应用，以便进行调试。

使用工具创建应用功能

开发人员门户还包括有助于构建 Teams 应用的关键功能的工具。 以下是工具：

  • 场景工作室： 在 Teams 会议中设计自定义的一起模式场景 。
  • 自适应卡片编辑器 (预览) ：创建和预览要包含在应用中的自适应卡片。
  • 标识平台管理 (预览版) ：使用 Microsoft Entra ID 注册应用，以帮助用户登录并提供对 API 的访问权限。
  • Teams 应用商店应用验证：根据Microsoft用于查看应用的测试用例检查应用包。 建议在 “发布 ”部分下的应用中使用最新的应用验证工具。
  • 代理标识蓝图：创建、配置和管理可重用蓝图，用于定义Agent 365及其后端连接详细信息。 有关详细信息，请参阅 代理标识蓝图。
  • 机器人管理：向应用添加对话机器人，以便与用户通信、回答其问题，并主动通知他们更改和其他事件。

添加机器人：

  1. 在开发人员门户中，选择左窗格中的“ 工具 ”。

  2. 选择 “机器人管理”。

    屏幕截图是一个示例，其中显示了开发人员门户中的工具，可帮助你生成关键功能。

  3. 在“机器人管理”页中，选择“ + 新建机器人”。

  4. 输入名称，然后选择“ 添加”。

    使用机器人管理选项添加新的机器人。

注意

  • 默认情况下，使用 Microsoft Teams 开发人员门户 创建的机器人是 单租户 。

  • 多租户 机器人已弃用，但已创建为 多租户 的机器人将继续按预期工作。

  • 使用开发人员门户创建机器人时，会在Microsoft Entra ID租户中自动创建相应的 servicePrincipal。

  • 在具有工作或学校帐户的委派方案中，必须为管理员分配受支持的Microsoft Entra角色或具有受支持角色权限的自定义角色。 此作支持以下最低特权角色。

    • 对于多租户应用：

      • 应用程序管理员
      • 云 应用程序管理员

    • 对于调用用户是非管理员用户但支持应用程序的所有者的单租户应用，用户必须具有 应用程序开发人员 角色。

在开发人员门户中，可以转到 Bot Framework 门户，将机器人配置为更新图标和其他属性。

注意

机器人 ID 不支持环境变量。

代理标识蓝图

代理标识蓝图为 Agent 365 中的代理提供可重用配置，可以执行任务并与用户或Microsoft 365 服务进行交互。 每个蓝图都充当模板，指定如何配置代理并将其连接到后端服务。

代理标识蓝图在开发人员门户中创建和管理，而从它们派生的代理标识在 Microsoft 365 管理 中心进行管理。 若要开始并获取有关将代理扩展到 Agent 365 的完整端到端指南，请使用 Microsoft Agent 365 SDK。

查看和使用现有的代理标识蓝图

开发人员门户中的代理标识蓝图工具显示租户中可用的现有蓝图列表。

可用代理蓝图列表

可以使用代理标识蓝图来：

  • 查看现有蓝图的配置详细信息，包括其类型和蓝图 ID。
  • 编辑或更新蓝图的配置。

如果尚不存在合适的蓝图，可以创建一个新蓝图。

创建新的代理标识蓝图

  1. 在 Teams 开发人员门户中，转到 “工具” 部分，然后选择“ 代理标识蓝图”。

    代理蓝图

  2. 选择“ + 新建蓝图”。

    创建新的代理蓝图

  3. 输入名称，然后选择“ 创建”。

    创建新的代理蓝图窗口

    将自动生成唯一的 代理蓝图 ID 。 基于此蓝图创建代理标识时使用此 ID。

配置代理标识蓝图

每个蓝图包括两个关键配置区域：

  1. 基本信息：可以查看蓝图的以下基本配置：

    1. 代理蓝图 ID：系统为蓝图生成的唯一标识符。
    2. 名称：创建蓝图时分配的名称。

    代理蓝图中的“基本信息”选项卡

  2. 配置：在此选项卡中，可以指定代理与其服务的通信方式。

    1. 在“ 配置 ”选项卡中，转到“ 代理类型”。

      • 选择代理连接到后端服务的方式。

      • 选择下列选项之一：

        代理类型 说明
        无 默认) (没有机器人或 API 关联。
        基于机器人 使用在 Teams 中注册的现有机器人。
        基于 API 使用自定义 API 终结点定义代理行为。

    2. 根据所选代理类型输入以下选项之一：

      • 机器人 ID：如果选择了“基于机器人”，请提供已注册的 Teams 机器人的 ID。
      • 后端 URL：如果选择了“基于 API”，请提供后端服务终结点的 URL。

    3. 选择“ 保存” 以应用配置。

    4. 选择“ 还原” 以放弃更改。

    代理蓝图中的“配置”选项卡

另请参阅

  • Last updated on