用途:该技能用于在 Power Apps 代码应用中添加 Microsoft Copilot Studio 连接器,以便调用 Copilot Studio 智能体、向智能体发送提示并集成其返回结果。
主要能力与流程:工作流为检查 Memory Bank、添加连接器、配置、构建、更新 Memory Bank。添加连接器前先运行 /list-connections 技能查找 Microsoft Copilot Studio 连接;若不存在,需按环境 ID 构造连接页面 URL 手动创建。随后执行命令:pa app add data-source --connector microsoftcopilotstudio -c <connection-id>。
配置与调用:需向用户确认要调用的智能体及所需操作。使用前需在 Copilot Studio 中手动完成准备:发布智能体(Channels → Teams → 添加到 Teams → Publish),并从 Web app 的连接字符串中获取智能体名称。调用使用 ExecuteCopilotAsyncV2 操作(路径 /proactivecopilot/executeAsyncV2),这是唯一能同步可靠返回智能体响应的端点,与 Power Automate 的“Execute Agent and wait”动作相同。响应包含 responses 数组、conversationId、lastResponse、completed;智能体常以 JSON 字符串返回,需解析 responses 数组提取字段。
限制与已知问题:ExecuteCopilot(/execute)为即发即忘,仅返回 ConversationId,不要使用;ExecuteCopilotAsync(/executeAsync)会返回 502 错误,不要使用;会话轮次模型仅在 /execute 后可用,而该端点不提供响应,不要使用。响应字段大小写不一致,需检查 conversationId、ConversationId、conversationID 等变体。构建阶段运行 npm run build,先修复 TypeScript 错误,暂不部署。最后更新 memory-bank.md,记录连接器、智能体名称、已配置操作与构建状态。其他细节暂未提供。