SuperAPI AI 工具集

teams-app-developer

编程与开发

查看项目

更新于 10-16 01:15

技能介绍

用途:使用 ATK CLI 构建代码型 Microsoft 365 智能体与 Teams 应用,包括自定义引擎智能体(CEA)、机器人、标签页和消息扩展。声明式智能体(DA)不在本技能范围内,需使用 declarative-agent-developer 技能。

主要能力:提供创建项目、本地测试、Teams 测试、预配部署、故障排查、Slack 迁移等子技能,并附带清单与 YAML、命令、模板等共享参考,以及 100 多个微专家文件。

使用方式:先确认 CLI 可用,运行 atk --version,版本需大于 1.1.5-beta;不满足则用 install-atk 技能安装或更新。自动化中始终使用 -i false 避免挂起。执行任何工作流前必须先阅读对应子技能文档。会话开始时设置 export ATK_CLI_SKILL=true 以便遥测标记。本地服务启动命令(如 npm run dev、npm start、python app.py、devtunnel host)会持续运行并挂起终端,必须作为后台进程运行,通过输出中的监听端口或隧道 URL 验证启动。atk new、atk provision、atk deploy 可能耗时数分钟,需等待完成再执行下一步。

适用场景:从零构建 CEA/机器人/标签页/消息扩展、本地测试现有项目、部署到 Azure、修复机器人故障、将 Slack 机器人迁移到 Teams。

限制与注意事项:不要硬编码密钥或编造占位值,需向用户索取真实值。常见问题包括 AADSTS7000229(YAML 缺少 generateServicePrincipal: true)、.localConfigs 缺少 TENANT_ID 导致 401、devtunnel URL 被拉黑等,详见 troubleshoot/troubleshoot.md。配置解析仅在缺失时进行,已存在的值复用。