lytics-agent

Lytics Agent Router

目的

Lytics CDP 操作的顶层意图分类器和分发器。分析用户请求，并将其路由到相应的专用技能。

环境

需要经过身份验证的 API 访问权限。有关凭据解析和预检，请参阅 ../references/auth.md。

意图分类

根据关键词和意图进行路由：

受众 / Segment 操作

触发词：“create audience”“build segment”“find users who”“people that”“customers who”“target audience”“audience of” 路由到：audience-builder skill

触发词：“list segments”“show audiences”“get segment”“segment details”“delete segment”“update segment” 路由到：segment-manager skill

受众分析 / 快照

触发词：“describe audience”“audience snapshot”“what does segment look like”“audience breakdown”“analyze segment”“audience profile”“audience analytics”“audience demographics”“who is in this segment” 路由到：audience-snapshot skill

受众策略 / 顾问

触发词：“best audience for”“optimize audience”“help me target”“who should I target”“improve my segment”“audience strategy”“what audience should”“right audience for”“how to reach”“better audience”“refine segment” 路由到：audience-advisor skill

个人资料诊断

触发词：“why is user in”“why isn't user in”“why not in segment”“diagnose profile”“what happened to user”“debug segment membership”“explain segment”“trace user” 路由到：profile-investigator skill

个人资料 / 实体探索

触发词：“look up user”“find profile”“who is”“show me user”“profile for”“entity lookup” 路由到：profile-explorer skill

架构 / 数据模型

触发词：“what fields”“schema”“data model”“field types”“available data”“what data do we have” 路由到：schema-manager skill

架构优化

触发词：“optimize schema”“unused fields”“schema cleanup”“field usage”“schema health”“improve schema”“inert fields”“missing mappings” 路由到：schema-optimizer skill

架构发现（用于字段映射）

触发词：“find field for”“what field matches”“map to field” 路由到：schema-discovery skill

集成策略 / 顾问

触发词：“connect to”“set up integration”“export to”“import from”“sync with”“send data to”“pull data from”“best way to connect”“how do I integrate” 路由到：integration-advisor skill

数据集成 / 作业（现有）

触发词：“list jobs”“job status”“pause job”“resume job”“bounce job”“kill job”“job logs” 路由到：job-manager skill

Campaign / Journey 构建器

触发词：“create flow”“build campaign”“set up journey”“welcome series”“nurture campaign”“email sequence”“multi-step campaign”“A/B test flow” 路由到：campaign-flow-builder skill

Flows CRUD

触发词：“list flows”“get flow”“delete flow”“flow status”“update flow”“pause flow” 路由到：flow-manager skill

导出调试

触发词：“why wasn't user exported”“export debug”“not showing up in”“didn't sync to”“missing from export”“why no export”“trace export”“export failed” 路由到：export-debugger skill

数据健康状况

触发词：“data health”“is my data flowing”“health check”“any data issues”“pipeline status”“what's broken”“data problems”“check my data”“how's my data” 路由到：data-health-monitor skill

Streams / Events

触发词：“stream”“events”“data flowing”“incoming data”“event log” 路由到：stream-inspector skill

连接 / 身份验证

触发词：“connection”“auth”“credentials”“provider” 路由到：connection-manager skill

Webhook 模板

触发语：“webhook 模板”、“发送到 webhook”、“自定义 webhook 目标”、“Qualtrics webhook”、“Slack webhook”、“将用户档案转换为 webhook 负载”、“构建 webhook 负载”、“为……配置 webhook 集成”、“将用户档案发送到自定义 URL” 路由至：webhook-template-builder skill

跨账户同步／推广

触发语：“从沙盒复制到生产环境”、“推广到生产环境”、“同步到生产环境”、“将细分复制到另一个账户”、“沙盒到生产环境”、“推广受众”、“推广流程”、“在账户之间复制架构”、“将细分从 X 移至 Y”、“将 从 同步到 ”、“复制账户设置”、“推广设置”、“在账户之间同步设置”、“复制 idconfig”、“同步账户配置”、“推广账户设置”、“在账户之间复制字段排名” 路由至：account-sync skill

多意图处理

有些请求会结合多种意图。按顺序调用技能：

• “创建一个受众并导出到 Facebook”

  1. audience-builder skill -> 创建细分
  2. integration-advisor skill -> 使用新细分设置导出

• “在高价值细分中查找用户，并给我看一个”

  1. segment-manager skill -> 获取细分详情
  2. profile-explorer skill -> 查找一位成员

• “我们有哪些购买数据字段？用这些字段构建一个细分”

  1. schema-discovery skill -> 查找购买字段
  2. audience-builder skill -> 使用发现的字段构建细分

• “在沙盒中构建一个细分，并将其推广到生产环境”

  1. audience-builder skill -> 在沙盒中创建细分
  2. account-sync skill -> 将新细分从沙盒复制到生产环境

意图消歧

如果意图不明确：

1. 提出澄清问题
2. 给出最可能的理解
3. 提供其他选项

示例：“向我展示数据”可能指：

• 架构／字段 -> schema-manager
• 流事件 -> stream-inspector
• 用户档案数据 -> profile-explorer

询问：“您想查看架构字段、最近的流事件，还是查找特定用户档案？”

通用约定

所有技能均遵循以下约定：

• 身份验证：有关凭据解析，请参阅 ../references/auth.md
• 基础 URL：有关 URL 构建，请参阅 ../references/api-client.md
• 读取操作：立即执行并显示结果
• 写入操作：始终使用确认门模式（摘要 + 负载 + 批准）
• 错误：解析 API 错误并建议修复方法，绝不静默失败