add-connector

📋 共享说明：shared-instructions.md - 跨领域注意事项。

添加连接器（通用）

适用于未由特定 /add-* 技能覆盖的连接器的备用技能。对于常见连接器，请优先使用专用技能：

• /add-dataverse -- Dataverse 表
• /add-azuredevops -- Azure DevOps
• /add-teams -- Microsoft Teams
• /add-excel -- Excel Online (Business)
• /add-onedrive -- OneDrive for Business
• /add-sharepoint -- SharePoint Online
• /add-office365 -- Office 365 Outlook（日历、电子邮件、联系人）
• /add-workiq -- Work IQ（M365 Copilot Search）

工作流

1. 检查 Memory Bank → 2. 识别连接器 → 3. 添加连接器 → 4. 检查并配置 → 5. 构建 → 6. 更新 Memory Bank

---

步骤 1：检查 Memory Bank

按照 shared-instructions.md 检查是否存在 memory-bank.md。

步骤 2：识别连接器

如果提供了 $ARGUMENTS，或调用方已指定连接器，请直接使用并跳过下面的问题。

否则，询问用户想添加哪个连接器。浏览可用连接器：连接器参考

继续之前，检查该连接器是否有专用技能。如果有，请立即委派并停止：

连接器 API 名称	委派给
shared_a365copilotchatmcp	/add-workiq
sharepointonline	/add-sharepoint
teams	/add-teams
excelonlinebusiness	/add-excel
onedriveforbusiness	/add-onedrive
azuredevops	/add-azuredevops
office365	/add-office365
commondataservice	/add-dataverse

使用相同的 $ARGUMENTS 调用相应的技能，不要继续执行此技能的工作流。

常见连接器 API 名称：

• sharepointonline、teams、excelonlinebusiness、onedriveforbusiness
• azuredevops、azureblob、azurequeues
• office365、office365users、office365groups
• sql、commondataservice

步骤 3：添加连接器

首先，查找连接 ID（参见 connector-reference.md）：

运行 /list-connections 技能。在输出中查找该连接器。如果没有现有连接，请引导用户使用特定于环境的 Connections URL 创建连接——根据上下文中的活动环境 ID（来自 power.config.json 或先前步骤）构建该 URL：https://make.powerapps.com/environments/<environment-id>/connections → + 新建连接 → 搜索连接器 → 创建。

# Non-tabular connectors (Teams, Azure DevOps, etc.)
pa app add data-source --connector <connector-api-name> -c <connection-id>

# Tabular connectors (SharePoint, Excel, SQL, etc.) -- also need dataset and table
pa app add data-source --connector <connector-api-name> -c <connection-id> -d '<dataset>' --table '<table>'

参数参考：

• --connector (apiId) -- 连接器名称（例如，sharepointonline、teams）。在扁平化的 power-apps 二进制文件中，此参数为 --api-id/-a。
• -c (connectionId) -- 所有非 Dataverse 连接器都必须提供。通过 /list-connections 获取。
• -d (dataset) -- 表格型数据源必需（例如，SharePoint 站点 URL、SQL 数据库）。Dataverse 不需要。
• --table (table) -- 表格型数据源的表/列表名称（例如，SharePoint 列表、Dataverse 表逻辑名称）。在扁平化的 power-apps 二进制文件中，此参数为 --resource-name/-t。

第 4 步：检查与配置

添加后，检查生成的文件。生成的服务文件可能非常大——请使用 Grep 查找特定方法，而不是读取整个文件：

Grep pattern="async \w+" path="src/generated/services/<Connector>Service.ts"

需要检查的文件：

• src/generated/services/<Connector>Service.ts —— 可用操作及其参数
• src/generated/models/<Connector>Model.ts —— TypeScript 接口（如果已生成）
• .power/schemas/<connector>/ —— 连接器架构和配置

对于用户需要的每个方法：

1. 搜索方法名称以查找其签名
2. 只读取该方法对应的部分（在 Read 上使用 offset 和 limit 参数）
3. 确定必需与可选参数以及响应类型

帮助用户使用生成的服务方法编写代码。

第 5 步：构建

npm run build

继续之前，请修复 TypeScript 错误。暂时不要部署。

第 6 步：更新 Memory Bank

更新 memory-bank.md，记录：添加的连接器、已配置的操作、构建状态。