add-data-source

编码 Agent 无法添加数据源、连接和 API 连接器——这些操作必须通过 Power Apps Studio 界面完成。此技能会告知用户这一点，引导他们在 Studio 会话中添加连接，通过 MCP 服务确认连接可用，然后继续处理待办事项。

阶段 0 — 确定连接类型

根据用户的请求，确定他们想要添加什么，以及如何进行验证：

请求类型	使用以下工具验证
数据源（SharePoint 列表、Dataverse 表、SQL 表、Excel 文件、OneDrive 等）	list_data_sources
API / 连接器（Office 365 Users、Teams、自定义连接器等）	list_apis
不明确	同时调用 list_data_sources 和 list_apis

记下用户想要添加的内容，以便在阶段 3 按名称查找。

阶段 1 — 告知用户

说明这一步需要在他们的 Studio 会话中操作。告知用户：

• 编码 Agent 无法通过编程方式添加数据源或连接——必须直接在 Power Apps Studio 中完成。
• 要添加连接，请在已打开的 Studio 会话中按以下步骤操作：
  1. 打开左侧边栏中的 Data 面板
  2. 点击 Add data
  3. 搜索他们想要的数据源或连接器（例如，“SharePoint”、“Dataverse”、“SQL Server”、“Office 365 Users”）
  4. 按照身份验证提示操作，并选择具体的表、列表、文件或数据集
• 添加后，MCP 服务即可使用该连接，你也可以继续处理。

阶段 2 — 等待确认

使用 AskUserQuestion 暂停，直到用户在 Studio 中完成这些步骤：

“请在 Power Apps Studio 会话中添加数据源或连接。准备就绪后，请在此处回复，我会先验证连接，然后再继续。”

在用户确认已添加之前，不要继续。

阶段 3 — 验证连接

用户确认后，调用相应的 MCP 工具，检查连接现在是否可用：

• 如果请求的是数据源：调用 list_data_sources
• 如果请求的是 API / 连接器：调用 list_apis
• 如果类型不明确：并行调用两者

在结果中查找用户添加的连接：

已找到 — 告知用户，该数据源或连接现在已对 Agent 可见。提供 MCP 工具返回的准确名称（在 Power Fx 公式中必须使用此名称引用）。如果是数据源，调用 get_data_source_schema 获取其列名和类型，并在回复中包含架构摘要，以便后续编辑时使用。对于 API / 连接器，同样调用 describe_api 获取可用端点及其参数，并在回复中包含架构摘要。

未找到 — 告知用户当前尚无法看到该连接。请他们：

1. 确认已完成 Studio 中的步骤，并且连接显示在 Studio 的 Data 面板中。
2. 检查 Studio 会话是否仍处于活动状态（MCP 服务必须连接到实时协同创作会话）。
3. 准备就绪后告知你，以便再次尝试。

使用 AskUserQuestion 等待用户回复，然后重新执行阶段 3。

阶段 4 — 继续处理

确认连接后：

• 如果用户还有待办事项（例如，“将 SharePoint 添加为数据源，然后创建图库”），现在使用已验证的连接名称和架构继续处理。
• 如果用户只要求添加连接，则总结已确认的信息（连接名称、类型，以及适用时的架构），并建议自然的下一步操作（例如，创建使用新数据的屏幕或图库）。