用途:这是 agentic-analytics 插件安装后的首次运行引导,让用户通过聊天完成初始设置,从而直接访问其 Parse.ly Data Pipeline(DPL)原始事件数据。v1 仅支持 DPL 数据源。
主要能力:引导流程会询问存放 DPL 事件的 bucket 名称(通常形如 parsely-dw-<publisher>),引导用户通过 aws configure 配置 AWS 凭证,验证 S3 连通性,并将运行时配置持久化到 bucket.json。可选地配置邮件活动 join key(如 ?pid=...),用于在 cohort CSV 中输出可回传 CRM 的标识符。
使用方式:流程依次为:简短问候;读取或询问 bucket 名称;检测平台与前置条件(uname -s、python3 --version、aws --version);创建隔离的 Python venv 并安装 DuckDB(运行 scripts/ensure_venv.sh);创建数据目录;设置 AWS 区域与输出格式并检查凭证;验证连通性(aws --profile agentic-analytics s3 ls "s3://<bucket>/by-apikey/");可选配置 join key;写入 bucket.json。完成后可使用 /agentic-analytics:staircase 与 /agentic-analytics:journey 报告,或直接在聊天中请求运行。
适用场景:Parse.ly 客户首次配置插件、重新运行初始化(幂等)、切换 bucket(清除已保存配置后重跑)。
限制:v1 无合成数据回退,需真实 DPL 访问;仅支持 S3 直连交付格式;不支持多 bucket 同时配置;原生 Windows 未正式支持(WSL 可走 Linux 路径);macOS 为主要支持平台。凭证存于 ~/.aws/credentials,不在聊天中索取。