Agentic Engine 接入指南
5步跑通数据采集到分析看板
用 Coding Agent + ae-cli + skill 搭配 Agentic Engine，五步跑通从数据采集、代码埋点、Debug 验证到看板产出的完整链路。
准备接入工具
本地接入需要配合电脑上的 Coding Agent。开始前准备好待接入项目、Node.js 18+ 和可用 AE 账号；AE Host 使用当前页面地址。
安装与授权命令
npm install -g @thinkingai/ae-cli
npx skills add ThinkingAIAgenticEngine/ae-cli -g -y
ae-cli config set-host "{{AE_HOST}}"
ae-cli auth login服务端校验与标准
- 服务端确认当前用户已通过 AE CLI 完成授权。
第一次使用先跑一条 ae-cli auth login 完成登录即可。
生成 AE 埋点方案
在项目目录中使用 ae-generate-tracking-plan Skill，扫描当前代码，识别项目背景与核心场景，生成并上传 AE 规范埋点方案。
你要说的话（Prompt）
请使用 ae-generate-tracking-plan Skill，扫描当前项目代码，生成并上传一份符合 AE 规范的埋点方案。
【目标 AE 项目】
AE Host：{{AE_HOST}}
Project ID：{{AE_PROJECT_ID}}
AE CLI 已完成授权。请直接使用以上 Host 和 Project ID，不要再次要求登录或查找项目 ID。
【业务信息】
项目背景：请结合当前项目代码识别产品形态、目标用户和核心业务，不要要求我再次填写。
必要场景：请结合当前项目代码识别核心功能和实际业务流程，只覆盖真实存在的场景，不要照搬示例或编造功能。
【执行要求】
- 以当前项目代码为主要素材，按 Skill 完成方案生成、确认、校验、归档和上传
- 事件名称使用 snake_case，每个事件注明触发时机和必要属性；所有事件、事件属性、公共事件属性和用户属性都必须填写中文显示名，不允许留空
- 先把事件表和属性表给我确认，确认前不要上传
- 确认后通过 ae-cli 生成并校验 draft/xlsx，再上传到以上 Project ID；上传后使用 ae-cli tracking plan get 回读确认
- 上传成功后执行 ae-cli tracking plan sync-display-names --project-id {{AE_PROJECT_ID}} --draft <实际生成的 draft.json 路径>，只补齐空显示名，不覆盖 AE 中已有显示名
- 如果返回 missing_in_metadata，列出尚未出现的事件或属性，待数据上报后重试；不要把它误判为方案上传失败
- 最后返回 AE 埋点方案页面、本地归档文件路径，以及显示名同步结果Agent 会做什么
- 扫描代码提取业务逻辑，按项目实际形态定口径
- 产出事件表 + 属性表，先给你确认，确认前不上传
- 确认后上传到 AE 指定项目并保存本地归档文件 `.ae-tracking/draft.json`
服务端校验与验收
- 服务端确认目标项目已上传埋点方案。
- AE「数据管理 → 埋点方案」看到全部事件及触发时机标准。
代码埋点
使用 ae-generate-tracking-code Skill 读取已确认方案和当前项目代码，先展示修改预览，确认后配置 SDK、写入埋点并运行构建检查。
你要说的话（Prompt）
请使用 ae-generate-tracking-code Skill，读取当前项目代码和上一步生成的 .ae-tracking/draft.json，完成埋点代码接入。
【AE 接入信息】
AE Host：{{AE_HOST}}
Project ID：{{AE_PROJECT_ID}}
SERVER_URL：{{AE_SERVER_URL}}
APP_ID：{{AE_APP_ID}}
【配置规则】
- SERVER_URL 已按当前 AE 地址推导：仅将域名中的 -web- 替换为 -receiver-，保留协议、其他域名部分和端口
- Project ID 与 APP_ID 是两个不同字段，不要混用
- 当 SERVER_URL 和 APP_ID 不是 UNAVAILABLE 时，它们已经由当前 AE 项目提供并确认；请直接写入 .ae-tracking/draft.json 的 meta.server_url 和 meta.app_id，不要再次询问
- 如果 APP_ID 为 UNAVAILABLE，请优先通过 ae-cli 按以上 Project ID 查询；查询不到时，再提示我前往 AE「项目管理 → 接入配置」复制 APP_ID
- 如果 SERVER_URL 为 UNAVAILABLE，不要使用 AE Host 代替；请提示我从 AE「项目管理 → 接入配置」获取公网数据上报地址
【代码修改要求】
- 优先读取 .ae-tracking/draft.json；不存在时，使用以上 AE Host 和 Project ID 获取已上传的埋点方案
- 先分析当前项目代码，列出准备新增或修改的文件和埋点位置
- 先提供修改预览，确认前不要修改代码
- 确认后完成 SDK 配置和埋点代码修改
- 完成后运行项目构建和相关检查Agent 会做什么
- 先输出插入位置预览（新增文件 + 修改清单），确认后才动代码
- 集中式设计：路由监听 + 事件委托，改动面收敛
- 落地后跑项目构建和类型校验
服务端校验与验收
- 当前版本以本地确认记录完成；后续可结合数据上报状态反证代码已接入。
- 项目 diff 中出现 SDK 封装文件与埋点调用，`npm run build` 构建成功通过。
上报 Debug 验证
继续使用 ae-generate-tracking-code Skill 生成 Debug 校验脚本，添加调试设备并运行脚本，到 AE Debug 页面确认 SDK 配置和上报链路正常。
你要说的话（Prompt）
请继续使用 ae-generate-tracking-code Skill，为当前项目生成 Debug 校验脚本，并指导我完成数据上报验证。
【验证对象】
AE Host：{{AE_HOST}}
Project ID：{{AE_PROJECT_ID}}
平台或 SDK：{{例如 Web JavaScript SDK、Android SDK}}
【验证要求】
- 根据埋点方案选择有代表性的业务事件生成校验脚本
- 生成一个稳定的调试设备 ID，先使用 ae-cli tracking debug-device list 查看已有设备
- 设备不存在时，使用 ae-cli tracking debug-device add 创建；随后使用 ae-cli tracking debug-device select 应用该设备
- 运行校验脚本后，使用 ae-cli tracking debug-data list 查询最近一小时的 Debug 数据；必要时按事件名过滤
- 只有 has_data 为 true，且事件名称、属性结构和错误字段检查通过时，才判定验证成功
- Debug 数据确认到达后，再执行 ae-cli tracking plan sync-display-names --project-id {{AE_PROJECT_ID}} --draft <实际生成的 draft.json 路径>，补齐这批事件和属性的空显示名；不得覆盖已有显示名
- 默认在本地完成验证；仅当 CLI 能力不可用时，再告诉我如何到 AE Debug 页面排查
- 如果验证失败，请说明原因和修复方式
【补充说明】
{{其他验证要求；没有可以删除}}Agent 会做什么
- 选择有代表性的业务事件生成自动化校验脚本
- 指导调试设备添加与运行逻辑，事件名称和属性结构全覆盖比对
服务端校验与验收
- 服务端确认目标项目已经收到测试上报数据。
- 在 AE Debug 页面看到事件实时流入，判定为「正确」。
生成看板报表
使用 ae-analysis Skill，通过 ae-cli 读取当前项目已上传的埋点方案，基于真实事件和属性创建分析报表并加入看板。
你要说的话（Prompt）
请使用 ae-analysis Skill，通过 ae-cli 在当前 AE 项目中完成看板报表创建。
【目标项目】
AE Host：{{AE_HOST}}
Project ID：{{AE_PROJECT_ID}}
【分析目标】
请结合当前项目代码、已经上传的埋点方案和已有数据，识别核心业务目标并完成分析。
【场景示例】
- 核心事件近 7 天趋势
- 核心业务路径转化漏斗
- 新用户次日留存
【执行要求】
- 使用上面的 Host 和 Project ID，读取当前项目已经上传的埋点方案
- 不要猜测或替换 project_id、事件名或属性名，只使用埋点方案中真实存在的事件和属性
- 结合当前项目代码理解真实业务场景，自主选择适合当前项目的分析目标；上面的场景仅供参考
- 创建至少 2 个分析报表，并创建一个与项目和分析目标相符的看板，把已创建的报表加入看板
- 逐个验证报表能够正常查询；如果当前数据不足，请明确说明，不要虚构数据
- 完成后返回看板链接和报表清单Agent 会做什么
- 读取真实埋点方案，准确匹配事件与属性定义
- 创建至少 2 个分析报表并合成看板，完成数据查询合规校验
服务端校验与验收
- 目标项目至少存在 1 个有效看板和 1 个有效报表。
- 看板打开后报表均能正常查询并展示映射依据。
常见问题
- 必须用特定的 Coding Agent 吗？
- 不是。ae-cli 与 skill 在 Codex、Claude Code、Cursor、Trae 等任何支持 Skill 的 Agent 环境里均可使用。
- 无法自动唤起本地 Agent 怎么办？
- 点击"在 Codex 中打开"或"在 Claude 中打开"时，系统已自动将 Prompt 复制到剪贴板，您只需在您的 Agent 对话框中直接按 Ctrl/⌘+V 粘贴即可。
- 演示数据从哪来？
- 本指南里的每一步画面与 Prompt 均来自真实项目实操与 AE 环境。
准备好跑通你的增长链路了吗
立即体验 Agentic Engine，从埋点到看板，让 Agent 替你跑完每一步
