mcpField
F
flow-manager

flow-manager

github.com/lytics营销与增长449 次安装3 周前更新
代码仓库

关于 flow-manager

flow-manager 用于通过 Lytics API 管理客户旅程和营销活动，适合维护流程及其步骤的团队。它支持条件分支、延迟、导出、A/B 测试和亲和度路由。

主要功能

  1. 01创建、查看、更新和删除流程
  2. 02配置延迟与导出步骤
  3. 03设置条件分支和亲和度路由
  4. 04管理 A/B 测试及流程状态

适用场景

  1. 01调整客户旅程中的步骤和分支
  2. 02查看流程版本与当前状态

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/lytics/agent-skills --skill flow-manager

安装后在 Claude Code 中输入/flow-manager确认已加载。

详细介绍

流程管理器

用途

管理流程（客户旅程／营销活动）——创建、更新和删除流程，并管理流程步骤，包括延迟、导出、条件分支、A/B 测试和亲和度路由。

环境

需要经过身份验证的 API 访问权限。凭据解析方式请参阅 ../references/auth.md。

API 端点

列出流程
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/flow/ui" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
获取流程
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/flow/ui/${FLOW_ID}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
获取流程版本
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/flow/ui/${FLOW_ID}/${VERSION}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
创建流程
curl -s -X POST "${LYTICS_API_URL:-https://api.lytics.io}/v2/flow/ui" \
  -H "Authorization: ${LYTICS_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{ ... flow payload ... }'
更新流程
curl -s -X POST "${LYTICS_API_URL:-https://api.lytics.io}/v2/flow/ui/${FLOW_ID}" \
  -H "Authorization: ${LYTICS_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{ ... updated flow payload ... }'
删除流程
curl -s -X DELETE "${LYTICS_API_URL:-https://api.lytics.io}/v2/flow/ui/${FLOW_ID}" \
  -H "Authorization: ${LYTICS_API_TOKEN}"
为流程步骤创建作业
curl -s -X POST "${LYTICS_API_URL:-https://api.lytics.io}/v2/flow/ui/${FLOW_ID}/step/${STEP_ID}/work" \
  -H "Authorization: ${LYTICS_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{ ... work config ... }'
列出流程状态
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/flow/state" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

流程载荷

{
  "id": "flow_name",
  "label": "Display Name",
  "description": "What this flow does",
  "entry_segment_id": "segment_id",
  "entry_condition": "on_segment_entry",
  "reentry_allowed": false,
  "reentry_delay": "24h",
  "state": "draft",
  "steps": [
    {
      "id": 1,
      "label": "Step 1",
      "type_hint": "work_export",
      "slug": "step_1",
      "next": 2,
      "work_id": "work_id",
      "work_config": {}
    },
    {
      "id": 2,
      "label": "Wait 24 hours",
      "type_hint": "delay",
      "slug": "delay_step",
      "next": 3,
      "delay": "24h"
    }
  ]
}

流程状态

状态描述
draft可编辑，尚未处理
running正在处理用户
draining正在平稳停止，继续处理剩余用户
deleted软删除

进入条件

条件描述
in_segment对当前位于该细分受众群中的用户触发
on_segment_entry仅在用户进入该细分受众群时触发

步骤类型

类型描述关键字段
work_export导出到外部系统work_id、work_config
delay等待后再执行下一步骤delay（时长字符串）
conditional按 FilterQL 条件拆分split_conditions
affinity按内容亲和度路由split_affinities、affinity_config_id
ab_testing按概率随机拆分split_probabilities
work_export_exit退出流程时导出work_id、work_config

行为

读取操作

立即执行，并以可视化步骤链的形式展示流程结构。

写入操作

使用确认门模式。对于状态更改（draft -> running、running -> draining），明确警告相关影响。

错误处理

  • 进入细分受众群无效：先确认该细分受众群是否存在
  • 步骤引用无效：确保 next ID 指向现有步骤
  • 状态转换错误：只有 draft->running、running->draining 是有效转换

依赖项

  • 使用：../references/auth.md、../references/api-client.md、../references/confirmation-gate.md
  • 相关：segment-manager skill（用于进入细分受众群）、job-manager skill（用于作业步骤）

评论

支持 Markdown