用途
本技能用于在画布应用(Canvas App)开发过程中,引导用户添加数据源、连接或 API 连接器。由于编码智能体无法以编程方式添加这些连接,必须由用户在 Power Apps Studio 界面中手动完成,本技能负责告知用户操作步骤、等待确认、验证连接可用性,并继续后续工作。
主要能力
- 识别连接类型:根据用户请求判断要添加的是数据源(如 SharePoint 列表、Dataverse 表、SQL 表、Excel 文件、OneDrive 等)还是 API/连接器(如 Office 365 用户、Teams、自定义连接器等),并确定对应的验证方式。数据源使用 list_data_sources 验证,API/连接器使用 list_apis 验证,类型不明确时两者并行调用。
- 引导用户操作:说明编码智能体无法以编程方式添加数据源或连接,需在 Power Apps Studio 中操作,并给出具体步骤:打开左侧边栏的“数据”面板、点击“添加数据”、搜索所需数据源或连接器、按提示完成身份验证并选择具体的表、列表、文件或数据集。
- 等待确认:通过 AskUserQuestion 暂停流程,直到用户确认已在 Studio 中完成添加。
- 验证连接:用户确认后,调用相应的 MCP 工具检查连接是否已可用。若找到,则向用户确认连接名称(该名称是 Power Fx 公式中引用连接的方式);若为数据源,调用 get_data_source_schema 获取列名与类型并附上架构摘要;若为 API/连接器,调用 describe_api 获取可用端点及其参数并附上摘要。若未找到,则提示用户确认 Studio 步骤是否完成、Studio 会话是否仍处于活动状态(MCP 服务器需连接到实时共同创作会话),并等待用户再次尝试。
- 继续后续工作:连接确认后,若用户有未完成的任务(例如“添加 SharePoint 数据源后构建一个库”),则使用已验证的连接名称和架构继续执行;若添加连接是唯一请求,则总结确认的连接名称、类型及架构(如适用),并建议自然的下一步(例如构建使用新数据的屏幕或库)。
使用方式
该技能以分阶段流程执行:
- 阶段 0 — 识别连接类型:从用户请求中确定要添加的内容及验证方式。
- 阶段 1 — 告知用户:解释需要在 Studio 会话中操作,并给出添加步骤。
- 阶段 2 — 等待确认:使用 AskUserQuestion 暂停,直到用户确认已添加。
- 阶段 3 — 验证连接:调用 list_data_sources 或 list_apis(或两者)检查连接是否可见,并获取架构或端点信息。
- 阶段 4 — 继续:使用已验证的连接继续待办任务或总结并建议下一步。
适用场景
- 用户要求为画布应用添加数据源、连接或 API 连接器。
- 用户希望在添加连接后继续构建使用该连接的应用界面(如屏幕、库等)。
- 需要确认连接在 MCP 服务器中是否可用,并获取其架构或端点信息以便后续编辑。
限制
- 编码智能体无法以编程方式添加数据源或连接,必须由用户在 Power Apps Studio 中手动完成。
- 验证依赖 MCP 服务器连接到活动的共同创作会话;若会话不活跃,连接可能无法被检测到。
- 技能本身不提供数据源或连接器的具体配置细节,仅引导用户完成添加并验证结果。