用途:将 Power Pages 生成式 AI 摘要 API 接入 SPA 站点,只负责 AI 层(摘要服务代码与 Summarization/* 站点设置);Web API 前置条件(Webapi/<table>/enabled、字段、表权限、Web 角色)交由 /integrate-webapi 与 /create-webroles 处理。
覆盖两个接口:搜索摘要 POST /_api/search/v1.0/summary,请求体 { userQuery },返回 { Summary, Citations };数据摘要 POST /_api/summarization/data/v1.0/<entitySet>(<id>)?$select=...&$expand=...,请求体 { InstructionIdentifier } 或 { RecommendationConfig },返回 { Summary, Recommendations }。
主要能力:按目标顺序调用 ai-webapi-integration 智能体生成摘要服务代码,再由 ai-webapi-settings-architect 注册 AI 提示词;请求需附带 __RequestVerificationToken 与 X-Requested-With: XMLHttpRequest,不走 OData 包装。
使用方式:前置条件为已通过 /create-site 创建的 Power Pages SPA 站点、Dataverse 数据模型,且站点至少部署过一次(存在 .powerpages-site 文件夹)。工作流分 8 个阶段:检查站点、探索 AI 集成点、确认要添加的内容、配置数据访问、添加摘要代码、注册提示词、验证(header 契约、$select、npm run build、校验脚本)、审查与部署。首次运行后,仅调整 UI 的后续请求走迭代模式:本地编辑并 npm run build,不自动上传或提交,会话结束时批量询问部署与提交。
限制:AI 摘要 API 为预览功能,不适合生产使用,功能可能受限;受租户 PowerShell 设置、Copilot Hub 环境/站点治理、站点级开关三级管理,上级覆盖下级;搜索摘要被禁用时返回 HTTP 200 内嵌 { Code: 400, Message: "Gen AI Search is disabled." },数据摘要返回 HTTP 400 错误码 90041001 或 90041003。若站点使用微软自带搜索控件,只需工作区开关与内容片段,无需本技能。其余细节资料未提供。