SuperAPI AI 工具集

add-data-source

编程与开发

查看项目

更新于 10-16 00:31

技能介绍

用途:这是 Microsoft Managed Apps 中所有连接器绑定技能的单一规范实现,用于向应用添加数据源。专用 /add-* 技能(如 /add-office365、/add-workiq)会带预设委托给它;若由包装技能调用则不再回委托,若直接调用则独立完成流程。

主要能力与流程:先校验工作区与认证(test -f ms.config.json、ms auth status),再解析 api-id、mode 与参数。api-id 解析顺序为包装预设、调用方传入、用户直接给出、或通过 ms connector list --search "<term>" 发现候选并让用户选择,随后用 ms connector list-actions 校验。mode 为 action 或 table,决定 --as 标志。执行命令:action 模式为 ms app add data-source --connector <api-id> --as action;table 模式为 ms app add data-source --connector <api-id> --as table --dataset "<dataset>" --table "<table>"。连接器通过 --connector 传入,无 --api-id 标志;ms app add connector 为已弃用别名。

共享连接策略:添加后需检查共享连接并声明 allowedActions(连接器级或按表级),否则部署会失败;无应用代码时可暂缓并在 memory-bank.md 记录。之后运行 npm run build,并在 memory-bank.md 存在时记录绑定信息。

限制:无 procedure 模式,CLI 无 ms app add procedure 命令,也不接受 --sql-stored-procedure,绑定特定 SQL 存储过程暂不支持;SQL 数据源仍可作为 table 添加。Work IQ 涉及 MCP 有状态协议,建议改用 /add-workiq。非交互模式下省略 --connection-id 会报错;Dataverse 表格模式无需 --connection-id。