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

任务目标

深度解析用户行为分析报告，自动提取关键旅程节点与情绪曲线
生成带有中文标注和时间轴脉络的信息可视化图谱
触发场景：用户行为周期分析、流失断点定位、体验优化方向报告梳理、汇报演示材料制作

能力组成

能力流程描述

该技能以用户的「行为分析报告」为核心输入，通过自动化的多阶段AI处理，最终生成一张包含时间节点、行为轨迹、触点与情绪曲线的高质量信息图表。全链路包含以下步骤：

意图与需求深度解析：AI分析报告原文，提取核心主题和语义结构，理解报告针对的业务场景。
用户旅程结构化提取：基于核心主题，从报告中抽取时间维度上的步骤、行为动作、交互触点以及用户当下的情绪状态。
时间轴图谱提示词工程：将提取的结构化节点数据与用户的构图配色要求融合，生成用于驱动图像生成的专业优化提示词。
生成时间轴图谱图像：根据提示词调用图像生成模型，产出符合宽高比例要求的初始图像。
轮询图像生成状态：异步等待图像生成完毕，获取最终可访问的图像URL。

技能能力组成流程图

前置准备

凭证：配置 ShowAPI AppKey，凭证名称：showapi_appkey
- 获取方式：访问 https://www.showapi.com 注册账号，登录后进入 https://www.showapi.com/console#/myApp 获取 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 的模拟运行结果。如需真实调用，请前往 ShowAPI 注册账号（注册即送2元余额），并在 https://www.showapi.com/console#/myApp 获取 appKey。

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

收集用户需求 梳理用户的行为分析报告原文。可选提供对生成图的构图和配色要求（如：科技感，蓝色调，横向时间轴）及宽高比例。

异步提交生成任务 调用脚本异步执行用户旅程提取及图像绘制任务，仅返回唯一 task_id，不阻塞等待。调用示例：

python scripts/execute_task.py --report "用户行为分析报告原文" --demand "科技感，蓝色调，横向时间轴" --ratio 16:9 --async

轮询查询任务结果（必选） 使用 task_id 循环查询任务状态，每一轮轮询后，即时将当前返回的核心资料同步反馈给用户，直至获取完整结果。调用示例：
```
python scripts/query_task.py --task-id "返回的task_id值"
```

4.等待结果完成必须轮询直到完成。

结果解析与落地应用 提取生成的时间轴图谱图像URL、结构化旅程节点等基础信息，并呈现生成该图所使用的专业优化提示词，供汇报和分析使用。
生成html页面生成一个简单的html页面来融合返回的主要信息，特别是图片。

使用示例

示例1：电商夜间消费旅程图谱绘制

输入：一份描述20:00至22:00用户活跃、浏览、加购及最终支付受阻的旅程分析报告
流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
产出：一张展示晚间黄金两小时旅程断点的信息图谱，包含情绪起伏曲线
配置要点：ratio 设置为 16:9 适合宽屏汇报展示，demand 可输入“信息图谱风格，扁平化设计”

示例2：APP新用户引导流失分析图谱

输入：新用户注册到首次使用的漏斗分析报告，要求科技感配色
流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
产出：包含触点分析和情绪低谷的新手引导时间轴图谱
配置要点：demand 设置为“科技感，深蓝色调”

生成效果示例

描述

技能运行完毕后，将输出一张包含节点步骤、用户行为、交互触点和情绪状态的时间轴图谱图像。此外还会返回结构化的旅程节点数组以及用于生图的优化提示词，方便后续二次调整或深入分析。

输出案例

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

生成效果示例图1 生成效果示例图2 生成效果示例图3

{
  "showapi_res_body": {
    "timeline_image_url": "https://oss.showapi.com/example/timeline_graph_123.png",
    "journey_nodes": [
      {
        "step": 1,
        "action": "进入活跃高峰，开启浏览探索",
        "touchpoint": "首页推荐 / 搜索结果",
        "emotion": "身心放松，兴趣被唤醒"
      },
      {
        "step": 2,
        "action": "加购决策，意向显性化",
        "touchpoint": "商品详情页 / 购物车",
        "emotion": "期待，购买意愿攀升"
      },
      {
        "step": 3,
        "action": "支付受阻，旅程断点出现",
        "touchpoint": "支付页面",
        "emotion": "焦虑与犹豫，情绪跌入低谷"
      }
    ],
    "optimized_prompt": "A user journey timeline infographic, 16:9, technology style, blue tone, horizontal timeline, with emotion curve, showing steps from browsing to payment failure, detailed annotations in Chinese..."
  },
  "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": "节点步骤序号",
        "action": "用户行为描述",
        "touchpoint": "交互触点",
        "emotion": "用户情绪状态"
      }
    ],
    "optimized_prompt": "用于生图的专业优化提示词"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

注意事项

report (用户行为分析报告原文) 为必填项，需包含时间或逻辑推进的步骤描述以保证旅程提取的准确性。
所有任务强制异步执行，不支持同步模式。
轮询查询过程中，每次获取接口返回数据后，立即将主要内容反馈给用户。
模拟运行说明：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请注册 ShowAPI 账号并配置 appKey。