integration-setup

集成设置

目的

指导用户完成完整的数据集成设置——从创建身份验证凭据，到配置连接和创建作业。支持导入（数据流入 Lytics）和导出（数据流向外部平台）。

环境

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

输入

• 所需集成的描述（平台、方向、数据类型）
• 可选：凭据、要导出的细分、计划偏好

设置流程

步骤 0：考虑使用 Integration Advisor

如果用户的请求涉及选择工作流、映射字段，或从头开始设置新的集成，建议先从 integration-advisor skill 开始：

“对于新的集成，我可以帮你选择合适的工作流、映射字段并优化所有配置。你想先获取策略指导吗？”

如果用户有明确且具体的设置请求（例如，“使用工作流 X 和身份验证 Y 创建作业”），则直接继续。

步骤 1：确定集成类型

解析用户的描述以确定：

• 平台：Facebook、Google、Salesforce、Klaviyo 等
• 方向：导入（进入 Lytics）或导出（从 Lytics 导出）
• 数据类型：受众、事件、用户档案、转化

步骤 2：检查可用的提供方

curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/provider" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

查找与目标平台匹配的提供方。

步骤 3：检查现有身份验证

curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

检查目标平台是否已有有效的身份验证。

步骤 4：创建身份验证（如有需要）

使用 connection-manager skill 创建身份验证凭据。指导用户了解其平台所需的凭据。

步骤 5：创建或选择连接

# Check existing connections
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

如果已有连接，则使用现有连接；否则创建新连接。

步骤 6：配置作业

使用 job-manager skill 创建作业，包含：

• 与集成类型匹配的工作流
• 特定于平台的配置
• 关联凭据的身份验证 ID
• 细分 ID（用于导出）

步骤 7：确认关卡

展示完整的集成设置：

• 身份验证提供方详情（类型，不包括凭据）
• 连接配置
• 作业设置（工作流、计划、细分）
• 每个待创建资源对应的原始 API 负载

步骤 8：获批后执行

按顺序创建资源：

1. 身份验证（如为新建）
2. 连接（如为新建）
3. 作业

报告成功，并附上每个已创建资源的链接。

常见集成模式

受众导出

1. 用户选择或创建细分
2. 使用 segment_id 配置导出作业
3. 设置计划（持续运行、每日等）

数据导入

1. 配置与数据源的连接
2. 扫描连接以发现可用数据
3. 创建导入作业并映射字段

转化 API（CAPI）

1. 配置广告平台的身份验证
2. 创建转化导出作业
3. 将 Lytics 事件映射到平台转化事件

错误处理

• 缺少凭据：指导用户在目标平台中查找凭据
• 身份验证无效：建议重新创建凭据
• 找不到工作流：列出该平台可用的工作流
• 找不到细分：先使用 audience-builder 帮助创建细分

依赖项

• 组合使用：connection-manager skill、job-manager skill、../references/confirmation-gate.md
• 参考：../references/auth.md
• 相关：audience-builder skill（用于创建要导出的细分）