营销分析用户旅程时间轴图谱生成

任务目标

输入用户行为分析报告，一键生成带中文标注与情绪曲线的用户旅程时间轴信息图谱
具备意图与需求深度解析、用户旅程结构化提取、时间轴图谱提示词工程、图像生成与状态轮询能力
触发场景：电商营销复盘、用户旅程可视化、行为分析报告配图、转化瓶颈（如支付流失）诊断汇报

能力组成

能力流程描述

该技能以用户行为分析报告原文（report）为核心输入，可选配置图像宽高比（ratio）与构图配色要求（demand），经过五个阶段的流水线处理，最终输出时间轴图谱图像URL、结构化旅程节点数据与生图优化提示词：

意图与需求深度解析（step_1_intent_analyzer）：接收 report、ratio、demand 三个入参，通过提示词引擎对报告进行深度语义分析，提炼报告的核心主题（core_theme）等结构化语义信息，明确用户意图与生成目标，为后续环节提供分析基准。
用户旅程结构化提取（step_2_journey_extractor）：依赖第一步的核心主题，结合报告原文，将非结构化的行为描述转化为结构化旅程节点列表 journey_nodes，每个节点包含步骤序号（step）、用户行为（action）、情绪状态（emotion）、交互触点（touchpoint）四类信息。
时间轴图谱提示词工程（step_3_timeline_prompt_engineer）：将 journey_nodes、demand 中的构图配色要求与核心主题融合，由提示词工程模块生成面向生图模型的专业优化正向提示词 optimized_prompt。
生成时间轴图谱图像（step_4_generate_image）：调用系统生图API，基于 optimized_prompt 与 ratio 生成用户旅程时间轴图谱图像，返回图像任务地址。
轮询图像生成状态（step_5_poll_image_status）：对图像生成任务自动轮询（间隔5秒、超时600秒），直至任务状态为 SUCCEEDED，取得最终图像访问地址 result_url。

数据流转方式：各步骤间通过参数引用（如 {{@step_1_intent_analyzer.result.data...}}）将上游输出注入下游输入，形成全自动链式流水线；用户只需在入口提供报告原文与可选配置，全程无需人工干预。技能整体为异步任务模式：提交任务后返回唯一 task_id，通过轮询查询获取进度与最终结果。

技能能力组成流程图

flowchart TD
    A["用户输入: report 报告原文(必填)<br/>ratio 图像比例(选填,默认16:9)<br/>demand 构图配色要求(选填)"] --> B["step_1 意图与需求深度解析<br/>提炼核心主题 core_theme"]
    B --> C["step_2 用户旅程结构化提取<br/>输出 journey_nodes<br/>步骤/行为/情绪/触点"]
    C --> D["step_3 时间轴图谱提示词工程<br/>生成 optimized_prompt 专业提示词"]
    D --> E["step_4 生成时间轴图谱图像<br/>基于 optimized_prompt 与 ratio 生图"]
    E --> F["step_5 轮询图像生成状态<br/>间隔5秒/超时600秒<br/>直至 SUCCEEDED"]
    F --> G["最终输出:<br/>timeline_image_url 图像地址<br/>journey_nodes 旅程节点<br/>optimized_prompt 优化提示词"]

前置准备

凭证：配置 ShowAPI AppKey，凭证名称：showapi_appkey
鉴权配置：本 Skill 调用需要 AppKey 鉴权。所有 API 请求的 URL 查询参数中需携带 appKey={你的AppKey}。

如何获取 AppKey

如果你还没有 AppKey，请按以下步骤通过手机验证获取：
1. 请用户提供手机号（中国大陆手机号）
2. 调用发送验证码接口：
```
POST https://www.showapi.com/auth/agent_sendCode
Content-Type: application/x-www-form-urlencoded

phone={手机号}
```
  成功响应：{"flag":true,"remark":"发送成功"}
3. 请用户查看手机收到的6位验证码并告诉你
4. 调用验证接口获取 AppKey：
```
POST https://www.showapi.com/auth/agent_verify
Content-Type: application/x-www-form-urlencoded

phone={手机号}&code={验证码}
```
  成功响应：{"flag":true,"app_key":"你的AppKey"}
5. 将获取到的 app_key 保存，后续所有 API 调用 URL 中携带 appKey={app_key} 参数
注意事项
- 验证码5分钟有效，每分钟只能发送1次
- 如果手机号已注册过易源数据平台账户，会直接返回该账户的 AppKey，不会重复注册
- AppKey 获取后请妥善保存，避免重复验证
模拟体验：无 appKey 时，系统自动触发模拟调用，直接返回完整结果，快速预览生成效果
依赖：仅使用 Python 标准库，无需安装第三方包

操作步骤

模拟体验流程（无 appKey）

自动触发模拟调用 系统检测到未配置 appKey 时，自动向 https://www.showapi.com/_nuxt3/api/2405-105 发送 POST 请求（body: {"flow_id":"6a3cc2ea3c51f2c20901657d"}），直接获取完整模拟生成结果。此过程为一次性返回，不执行 execute_task.py 和 query_task.py。
可视化预览 将返回的 JSON 结果以 HTML 形式可视化展示，重点呈现时间轴图谱图像内容。
引导真实调用 提示用户当前为无 appKey 的模拟运行结果。如需真实调用，请通过手机验证获取 AppKey（步骤见「前置准备-鉴权配置」），并在后续所有 API 调用 URL 中携带 appKey={app_key} 参数。

标准流程（有 appKey，强制异步执行）

收集用户需求 收集用户行为分析报告原文（必填），确认图像宽高比（选填，默认16:9，可选1:1、3:4、4:3、16:9、9:16）与构图配色要求（选填，如科技感、蓝色调、横向时间轴）。

异步提交生成任务 调用脚本异步执行意图解析、旅程提取、提示词工程与图谱图像生成任务，仅返回唯一 task_id，不阻塞等待。调用示例：

python scripts/execute_task.py --report "【20:00 前后 · 旅程启动 — 进入活跃高峰】数据显示……" --ratio "16:9" --demand "科技感，蓝色调，横向时间轴" --async

轮询查询任务结果（必选） 使用 task_id 循环查询任务状态，每一轮轮询后，即时将当前返回的核心资料同步反馈给用户，直至获取完整结果。调用示例：
```
python scripts/query_task.py --task-id "返回的task_id值"
```
等待结果完成 必须轮询直到完成。
结果解析与落地应用 提取 timeline_image_url 图像地址、journey_nodes 旅程节点（步骤/行为/情绪/触点）、optimized_prompt 优化提示词，用于营销复盘汇报、转化断点定位与汇报物料制作。
生成html页面 生成一个简单的html页面来融合返回的主要信息，特别是时间轴图谱图像。

使用示例

示例1：电商晚间黄金时段旅程复盘

输入：一份电商用户晚间活跃行为分析报告
流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
产出：横向时间轴图谱，标注活跃、浏览、加购、支付等节点及情绪曲线
配置要点：ratio=16:9，demand 可填"科技感，蓝色调，横向时间轴"

示例2：支付流失断点诊断汇报

输入：支付转化率偏低的归因分析报告
流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
产出：突出"旅程断点"的时间轴图谱 + 结构化旅程节点数据
配置要点：demand 可强调"突出支付受阻节点、警示色调"

示例3：营销周报/月报配图

输入：周期性行为分析报告，需要信息图配图
流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
产出：适配汇报文档的旅程时间轴信息图谱
配置要点：汇报PPT建议 ratio=16:9，长图海报建议 ratio=9:16

生成效果示例

描述

技能运行成功后，典型输出包含三部分：

timeline_image_url：一张带中文标注与情绪曲线的用户旅程时间轴信息图谱图像，按指定宽高比生成。图中按时间顺序排布各旅程节点，直观呈现"活跃 → 浏览 → 加购 → 支付"的行为路径与情绪起伏，并对断点环节做视觉强化。
journey_nodes：结构化旅程节点数组，每个节点包含 step（节点步骤序号）、action（用户行为描述）、emotion（用户情绪状态）、touchpoint（交互触点）四个字段，可直接用于数据表格或二次加工。
optimized_prompt：面向生图模型的专业优化正向提示词，记录本次生图使用的完整提示词，便于复现或微调后再次生成。

可视化呈现方式：将时间轴图谱图像嵌入 HTML 页面居中展示，配合旅程节点表格（步骤/行为/情绪/触点）与优化提示词折叠区块，形成完整的分析交付物。

输出案例

说明：若输出结果包含图片，优先插入对应图片资源，之后再输出 JSON / Markdown 格式的文本内容。

生成效果案例1

生成效果案例2

生成效果案例3

接口返回 JSON 实际形态示例：

{
  "showapi_res_body": {
    "timeline_image_url": "https://oss.showapi.com/.../journey_timeline_16x9.png",
    "journey_nodes": [
      {
        "step": 1,
        "action": "晚间20:00结束一天工作后进入平台，开启活跃高峰，购物意愿与浏览耐心同步攀升",
        "emotion": "身心放松、注意力回收，期待感萌芽",
        "touchpoint": "App首页推荐"
      },
      {
        "step": 2,
        "action": "在首页推荐、分类频道与搜索结果间穿梭，高频点击、长停留反复比对商品",
        "emotion": "兴趣被逐步唤醒，沉浸于逛与种草",
        "touchpoint": "首页推荐/分类频道/搜索结果"
      },
      {
        "step": 3,
        "action": "将心仪商品加入购物车，购买意向由隐性转为显性",
        "emotion": "价值认同后的期待感增强，距成交仅一步之遥",
        "touchpoint": "商品详情页/购物车"
      },
      {
        "step": 4,
        "action": "进入支付环节，因支付页面加载缓慢，流畅体验被打断",
        "emotion": "焦虑与犹豫滋生，放弃意愿上升",
        "touchpoint": "支付页面"
      },
      {
        "step": 5,
        "action": "关闭页面流失，高意向流量在最后一环损耗",
        "emotion": "遗憾流失，可被限时优惠与提醒重新激活",
        "touchpoint": "关闭页面/挽回推送"
      }
    ],
    "optimized_prompt": "信息图谱设计，横向时间轴布局，深蓝科技感背景……（面向生图模型的专业优化正向提示词全文）"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

资源索引

scripts/execute_task.py：异步提交用户旅程时间轴图谱生成任务（真实调用时使用）
scripts/query_task.py：轮询查询异步任务结果（真实调用时使用）

响应数据结构

1. 异步任务提交响应

{
  "showapi_res_body": {
    "task_id": "唯一任务ID",
    "status": "pending",
    "msg": "任务已提交，正在异步处理中"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

2. 任务查询响应（单轮轮询返回数据，需实时同步给用户）

{
  "showapi_res_body": {
    "timeline_image_url": "最终生成的用户旅程时间轴图谱图像URL",
    "journey_nodes": [
      {
        "step": 1,
        "action": "用户行为描述",
        "emotion": "用户情绪状态",
        "touchpoint": "交互触点"
      }
    ],
    "optimized_prompt": "面向生图模型的专业优化正向提示词"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

入参说明

| 参数名 | 类型 | 必填 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | report | string | 是 | - | 用户行为分析报告原文，用于提取旅程节点与情绪曲线 | | ratio | string | 否 | 16:9 | 生成图像的宽高比例，可选值：1:1、3:4、4:3、16:9、9:16 | | demand | string | 否 | "" | 对生成图的构图和配色要求（非必填），如：科技感、蓝色调、横向时间轴 |

出参说明

| 参数名 | 类型 | 说明 | | --- | --- | --- | | timeline_image_url | string(url) | 最终生成的用户旅程时间轴图谱图像访问地址 | | journey_nodes | array | 结构化的用户旅程节点数据列表，元素含 step(整数)、action(行为描述)、emotion(情绪状态)、touchpoint(交互触点) | | optimized_prompt | string | 面向生图模型的专业优化正向提示词 |

异常说明

| 异常场景 | 现象 | 处理建议 | | --- | --- | --- | | AppKey 缺失或无效 | 脚本提示 "AppKey 不能为空"，或接口返回鉴权错误 | 按「前置准备-鉴权配置」通过手机验证获取 AppKey；检查环境变量 SHOWAPI_APP_KEY 是否正确设置 | | report 为空 | 提交任务时返回参数校验错误 | 提供非空的用户行为分析报告原文后重新提交 | | 图像生成超时 | 轮询超过600秒仍未出现 SUCCEEDED 状态 | 稍后使用 query_task.py 重新查询；多次失败可重新提交任务 | | 网络异常 | 抛出 "HTTP请求失败" / "请求失败" / "请求异常" | 检查网络连通性后重试；持续失败请联系平台支持 | | 余额/计费不足 | 接口返回计费相关错误码 | 确认账户余额与计费配额（单次预估 0.24 计费单位，含模型推理价格） |

注意事项

report 为必填项，需提供完整的用户行为分析报告原文，内容越具体（时间分段、行为描述、情绪变化），生成的旅程图谱越精准。
所有任务强制异步执行，不支持同步模式。
轮询查询过程中，每次获取接口返回数据后，立即将主要内容反馈给用户。
图像生成环节内置自动轮询（间隔5秒、超时600秒），若超时未完成，请稍后重新查询任务状态。
模拟运行说明：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请通过手机验证获取 AppKey 并配置。
单次调用预估消耗 0.24 计费单位（含模型推理价格），以实际计费为准。

营销分析用户旅程时间轴图谱生成-万维易源

营销分析用户旅程时间轴图谱生成

任务目标

能力组成

能力流程描述

技能能力组成流程图

前置准备

如何获取 AppKey

注意事项

操作步骤

模拟体验流程（无 appKey）

标准流程（有 appKey，强制异步执行）

使用示例

示例1：电商晚间黄金时段旅程复盘

示例2：支付流失断点诊断汇报

示例3：营销周报/月报配图

生成效果示例

描述

输出案例

资源索引

响应数据结构

1. 异步任务提交响应

2. 任务查询响应（单轮轮询返回数据，需实时同步给用户）

入参说明

出参说明

异常说明

注意事项