SuperAPI AI 工具集

setup

部署与运维

查看项目

更新于 10-16 00:31

技能介绍

用途:帮助非技术用户完成 Power Automate 插件的首次配置,一步一步引导,避免要求用户熟悉终端命令。

主要能力:

  1. 检查 Node.js:运行 node --version,若失败或低于 18,按操作系统给出安装建议(Windows 从 nodejs.org 下载 LTS 安装包;Mac 可用 brew install node 或访问 nodejs.org)。
  2. 检查 Azure CLI:运行 az --version,缺失时 Windows 可用 winget install Microsoft.AzureCLI 或访问 https://aka.ms/installazurecliwindows,Mac 用 brew install azure-cli。
  3. Azure 登录与令牌验证:用 az account show --output json 确认账号;未登录运行 az login。随后用 az cloud show --query name -o tsv 确认云类型,再按对应资源请求令牌,例如商业云:az account get-access-token --resource https://service.flow.microsoft.com --output json。不同云对应资源不同:GCC 为 https://gov.service.flow.microsoft.us,GCC High 为 https://high.service.flow.microsoft.us,DoD 需要运营方核实的 PA_FLOW_RESOURCE。可用 PA_CLOUD=commercial|gcc|gcchigh|dod 覆盖自动检测。AADSTS 报错通常意味着账号可能没有 Power Automate 访问权限,建议联系 IT 管理员确认许可证。
  4. 账号与连接管理:连接管理使用独立 MSAL 会话与令牌缓存,az login 不会切换它。可用 list_accounts 查看缓存账号与有效连通身份,switch_account 保存或清除首选用户名,whoami / doctor 对比连通身份与 Azure CLI 身份。交互式登录默认强制显示账号选择器;可用 PA_LOGIN_HINT=<upn> 预选账号,或用 PA_NO_ACCOUNT_PICKER=1 恢复普通浏览器 SSO。优先级为 PA_LOGIN_HINT、switch_account 偏好、PA_NO_ACCOUNT_PICKER、选择器。
  5. 检查 FlowAgent 工具:插件通过 .mcp.json 中注册的 flowagent MCP 服务器与 Power Automate 通信。若工具缺失,可用资料中的 node 脚本定位 power-automate 插件目录下的 mcp.mjs,再写入 ~/.copilot/mcp-config.json 的 flowagent 条目,之后重启代理(Copilot CLI 用 /restart,Claude Code 重启进程)。插件未安装时先运行 /plugin marketplace add microsoft/power-platform-skills,选择 power-automate 后重跑 /setup。
  6. 冒烟测试:首选调用 list_environments 工具列出环境;成功则用表格展示名称和位置,多个环境可询问默认环境并用 set_current_env 设置。若失败:认证错误回到第 3 步,工具缺失回到第 4 步,网络错误询问是否处于企业代理或 VPN 后。

可提及的相关技能命令:/browse-flows、/create-flow、/debug-flow。

限制与注意事项:DoD 端点必须由运营方核实 PA_FLOW_RESOURCE,不能凭主机名猜测;switch_account 不会改变 Azure CLI 身份;缓存清理失败属于错误,不应假设凭据已切换;未提供价格、收费或平台支持范围等事实。