SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场dev-environment-deprecation-report

dev-environment-deprecation-report

部署与运维

查看项目

更新于 10-26 09:00

技能介绍

用途

该技能针对 Microsoft 逐步淘汰非托管开发者环境以及 Power Apps 开发者计划非托管模式的计划，为 Power Platform 管理员生成一份“开发者环境弃用报告”（HTML）。报告回答的核心问题是：哪些开发者环境将被暂停、将因此失去哪些应用、流和智能体、还有多少天到期，以及存在哪些代他人创建、超出配额的情况。

主要能力

  • 通过 Power Platform for Admins 与 Power Platform for Admins V2 管理连接器，收集租户内全部环境，并筛选出 environmentSku == "Developer" 的开发者环境。
  • 解析环境的 createdBy、usedBy 用户 ID（这两个字段的显示名返回为空），再通过用户查询接口补全显示名。
  • 按类型统计各环境中的资源数量：应用（canvasapps、modeldrivenapps、codeapps、apps）、流（cloudflows、agentflows、m365agentflows）、智能体（copilotstudio/agents）。
  • 运行 scripts/build_report.py 生成统一版式的 HTML 报告，同时输出 summary.json 供聊天答复引用。
  • 报告包含：红色倒计时横幅（基于 data-target，打开页面时实时重算）、里程碑信息块、KPI 指标块、按风险资源排序的非托管环境行动表（含优先级：High ≥40、Medium 1–39、Low 0）、托管与非托管环形图、暂停前待办清单、每位制作者环境配额表、代他人创建环境的柱状图、托管开发者环境表。

关键日期

技能内置的默认日期为：停止创建新的非托管开发者环境 2026-11-15（--create-cutoff）、现有非托管开发者环境被暂停 2026-12-15（--suspend-date）、被暂停环境被删除 2027-01-15（--delete-date）。要求每次运行开始时重新抓取 Microsoft Learn 的“Important changes (deprecations) coming in Power Platform”页面确认日期；若日期变化，通过对应参数传入并告知用户；若页面无法访问，则使用默认值并说明未重新确认。该页面说明：自创建截止日起，每位用户只能创建一个托管开发者环境，已有多个托管开发者环境时予以保留；但未说明将多余的非托管环境转换为托管环境是否计入该限额。

使用方式

  1. 确认日期；2. 选择可用的管理连接器连接（缺失时创建连接）；3. 调用 Get-AdminEnvironment（api-version 2020-10-01，$top 250）并按 $skiptoken 翻页，结果保存至 working/devenv/envs.json；4. 收集并解析用户显示名，保存至 working/devenv/users.json；5. 在 V2 连接器上按类型调用 QueryResources，结果保存至 working/devenv/resources.json 并记录扫描 UTC 时间；6. 执行：
python <skill-dir>/scripts/build_report.py \
  --envs working/devenv/envs.json --resources working/devenv/resources.json \
  --users working/devenv/users.json --today <YYYY-MM-DD> --scan-time <scan UTC ISO time> \
  [--create-cutoff …] [--suspend-date …] [--delete-date …] \
  --out working/Developer-Environments-Report.html --summary-json working/devenv/summary.json
  1. 用 validate.py 校验 HTML，修复错误后通过 host-CopyArtifact 发布，并确认复制数量为 1。不要手工编辑 HTML。

适用场景

管理员需要了解哪些开发者环境将被暂停、距离暂停还有多少天、哪些环境是非托管的、谁代其他制作者创建了环境、谁超出了每位制作者一个开发者环境的限制，以及每类环境中分别有多少应用、流和智能体面临风险。

限制与注意事项

  • 仅覆盖开发者环境，不涉及生产、沙箱、默认或 Teams 环境；一般清单、使用量、DLP 或容量问题应使用 ask-power-platform-advisor* 系列技能。
  • 只读：不启用或禁用托管环境、不删除、不移动或修改环境，也不主动发送邮件或 Teams 消息（除非用户另行明确要求）。
  • 不硬编码租户数据，连接 ID、环境 ID 和用户名均来自当次运行。
  • 若查询失败或在拆分后仍受限（1000 条上限），需说明哪类数据不完整，不得虚构数量。
  • 无 Power Platform 管理员权限的用户无法获得有效结果。
  • 用户名称与环境详情属内部数据，仅保留在报告与聊天答复中。

暂未提供

官方文档未说明该技能的收费、授权方式或除上述运行环境（脚本目录、校验脚本路径等，如 /opt/workspace-config/.github/skills/html/scripts/validate.py）之外的具体部署要求。