SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场segment-automation

segment-automation

数据与分析

查看项目

更新于 10-15 10:22

技能介绍

Segment Automation via Rube MCP 是一套通过 Composio 的 Segment 工具包、经由 Rube MCP 来自动化 Segment 客户数据平台操作的工作流。它把 Segment 的常见数据写入操作封装为一组可调用的工具，便于在支持 MCP 的客户端中以工具调用的方式执行。

用途 该工具主要用于自动化 Segment 客户数据平台的运营操作，包括发送事件数据、设置用户属性与身份、管理用户与组织（分组）的关系、记录页面浏览、关联匿名与已识别用户身份，以及在单个请求中批量发送多条调用。

前置条件 使用前需要满足以下条件：Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）；需通过 RUBE_MANAGE_CONNECTIONS 并指定 toolkit segment 建立活跃的 Segment 连接；并且应始终先调用 RUBE_SEARCH_TOOLS 以获取当前的工具架构。

安装与设置 获取 Rube MCP 的方式是在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器，无需 API 密钥，添加端点即可工作。随后需确认 RUBE_SEARCH_TOOLS 有响应以验证 Rube MCP 可用；调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit segment；若连接状态不是 ACTIVE，则按照返回的授权链接完成 Segment 身份验证；在运行任何工作流之前，确认连接状态显示为 ACTIVE。

主要能力与核心工作流

  1. 跟踪事件（Track Events）：用于向 Segment 发送事件数据以供下游目标使用。主要工具为 SEGMENT_TRACK。关键参数包括 userId（用户标识，在没有 anonymousId 时必填）、anonymousId（匿名标识，在没有 userId 时必填）、event（事件名称，如 'Order Completed'、'Button Clicked'）、properties（包含事件特定属性的对象）、timestamp（ISO 8601 时间戳，可选，默认使用服务器时间）、context（包含 IP、用户代理等上下文元数据的对象）。注意事项：userId 或 anonymousId 至少需要一个；event 名称必填且应遵循一致的命名规范；properties 为自由格式对象，需确保跨事件的架构一致；timestamp 必须为 ISO 8601 格式（如 '2024-01-15T10:30:00Z'）；事件为异步处理，API 响应成功仅表示已接收，而非已投递。
  2. 识别用户（Identify Users）：用于将属性与 Segment 中的用户画像关联。主要工具为 SEGMENT_IDENTIFY。关键参数包括 userId、anonymousId、traits（包含 email、name、plan 等用户属性的对象）、timestamp、context。注意事项：userId 或 anonymousId 至少需要一个；traits 会与现有属性合并而非替换；要移除某个属性可将其设为 null；对新用户应先进行 identify 再 track；除非目标端已配置，否则避免在 traits 中发送 PII。
  3. 批量操作（Batch Operations）：用于在单个请求中发送多条事件、identify 或其他调用。主要工具为 SEGMENT_BATCH。关键参数为 batch，即消息对象数组，每条消息包含 type（消息类型，'track'、'identify'、'group'、'page'、'alias'）以及 userId / anonymousId，并按类型附带 event、properties、traits 等相应字段。注意事项：批中每条消息必须有有效的 type 字段；存在最大批量大小限制，需查看当前架构确认；批中所有消息独立处理，单条失败不影响其他；每条消息须独立满足其类型的要求（例如 track 需要事件名称）；批量是发送多条调用的最高效方式，优先于单条调用。
  4. 分组用户（Group Users）：用于将用户与公司、团队或组织关联。主要工具为 SEGMENT_GROUP。关键参数包括 userId、anonymousId、groupId（分组/组织标识，必填）、traits（包含 name、industry、size、plan 等分组属性的对象）、timestamp。注意事项：groupId 必填，用于标识公司或组织；分组属性会与该组的现有属性合并；一个用户可属于多个分组；分组属性更新的是分组画像而非用户画像。
  5. 跟踪页面浏览（Track Page Views）：用于记录 Segment 中的页面浏览事件。主要工具为 SEGMENT_PAGE。关键参数包括 userId、anonymousId、name（页面名称，如 'Home'、'Pricing'、'Dashboard'）、category（页面类别，如 'Docs'、'Marketing'）、properties（包含 url、title、referrer 等页面特定属性的对象）。注意事项：userId 或 anonymousId 至少需要一个；name 与 category 可选但建议提供以获得正确的分析；标准属性包括 url、title、referrer、path、search；页面调用通常自动化，手动使用多用于服务端页面跟踪。
  6. 关联用户身份与管理来源（Alias Users and Manage Sources）：用于合并匿名用户与已识别用户，或管理来源配置。主要工具包括 SEGMENT_ALIAS（连接两个用户身份，可选）、SEGMENT_LIST_SCHEMA_SETTINGS_IN_SOURCE（查看来源架构设置，可选）、SEGMENT_UPDATE_SOURCE（更新来源配置，可选）。ALIAS 的关键参数为 userId（新的用户标识，即已识别 ID）与 previousId（旧的用户标识，即匿名 ID）；来源操作的关键参数为 sourceId。注意事项：ALIAS 是单向操作，不可撤销；previousId 是匿名/旧 ID，userId 是新的/已识别 ID；并非所有目标端都支持 alias 调用，需查看目标端文档；ALIAS 应在用户首次识别（如注册）时调用一次；来源更新可能影响数据收集，需谨慎审查变更。

常见模式 用户生命周期：标准的 Segment 用户生命周期为：1）匿名用户访问，使用 anonymousId 发起 PAGE 调用；2）用户交互，使用 anonymousId 发起 TRACK 调用；3）用户注册，执行 ALIAS（anonymousId 到 userId），随后使用 traits 进行 IDENTIFY；4）用户执行操作，使用 userId 发起 TRACK 调用；5）用户加入组织，使用 GROUP 调用将 userId 关联到 groupId。 批量优化：用于批量数据摄取时，先在内存中收集事件（消息对象数组），每条消息包含 type、userId/anonymousId 及类型特定字段，然后以收集到的消息调用 SEGMENT_BATCH，最后检查响应中是否有单条消息的错误。 命名规范：Segment 建议一致的事件命名——事件使用“对象 动作”格式（如 'Order Completed'、'Article Viewed'）；属性使用 snake_case（如 'order_total'、'product_name'）；traits 使用 snake_case（如 'first_name'、'plan_type'）。

已知陷阱与限制 身份解析方面：每次调用都应包含 userId 或 anonymousId；每个用户身份合并只使用一次 ALIAS；先 identify 再 track 以确保正确的用户关联。 数据质量方面：事件名称应在所有来源中保持一致；属性应遵循已定义的架构以兼容下游；除非目标端已配置，否则避免发送敏感 PII。 速率限制方面：批量操作使用 BATCH 以保持在速率限制内；单条调用按来源受速率限制；批量调用更高效且更不易被限流。 响应解析方面：成功响应表示已接收而非已投递到目标端；响应数据可能嵌套在 data 键下；批响应中需检查错误字段以发现单条消息失败。 时间戳方面：必须为带时区的 ISO 8601 格式（如 '2024-01-15T10:30:00Z'）；省略 timestamp 则使用服务器接收时间；历史数据导入应包含显式时间戳。

快速参考 跟踪事件：SEGMENT_TRACK，关键参数 userId、event、properties。识别用户：SEGMENT_IDENTIFY，关键参数 userId、traits。批量调用：SEGMENT_BATCH，关键参数 batch（消息数组）。分组用户：SEGMENT_GROUP，关键参数 userId、groupId、traits。页面浏览：SEGMENT_PAGE，关键参数 userId、name、properties。关联身份：SEGMENT_ALIAS，关键参数 userId、previousId。来源架构：SEGMENT_LIST_SCHEMA_SETTINGS_IN_SOURCE，关键参数 sourceId。更新来源：SEGMENT_UPDATE_SOURCE，关键参数 sourceId。仓库：SEGMENT_LIST_CONNECTED_WAREHOUSES_FROM_SOURCE，关键参数 sourceId。

适用场景 适用于需要通过 MCP 工具调用方式自动化 Segment 数据写入的各类场景，包括服务端事件跟踪、用户属性与身份管理、组织级分组维护、页面浏览记录、匿名与已识别用户身份合并，以及批量数据摄取。

限制 资料未提供除上述内容之外的功能、收费、价格、平台、效果或使用步骤信息。