Databox Custom Integrations

什么是 Databox Custom Integrations？

Databox Custom Integrations 让您连接 Databox 原生集成中不可用的数据源。它专为需要从几乎任何 REST API 拉取数据并将 API 响应转化为结构化数据集以在 Databox 内分析的团队设计。

连接后，您可以使用 Databox 工具（包括 Genie）探索和分析生成的数据集，并在支持的情况下，将数据用于支持 MCP 的 AI 工具。其核心目的是减少因缺失或难以访问的报告数据造成的空白。

主要功能

• 连接几乎任何 REST API：构建连接到返回 JSON 的数据源，即使它们未获原生支持。
• 支持常见认证方法：设置连接时使用 OAuth2、Basic、Token 或 API 密钥认证。
• 自动分页处理：Databox 处理各种分页方式，确保同步时接收完整数据集。
• 从 API 响应创建结构化数据集：定义响应如何结构化为可过滤和分段的数据集。
• 同步期间数据标准化：处理时区、日期格式和动态值，使数据集更干净、一致，便于分析。
• 一个连接复用于多个数据集：连接一次源，即可创建多个数据集，无需重新配置连接。
• 从 API 选择性提取值：仅拉取所需值创建专注数据集，而非摄入全部。
• 查询您的数据：使用 Genie 以自然语言提问连接数据集，或使用通过 MCP 集成的 AI 工具。

如何使用 Databox Custom Integrations

1. 连接您的源：在 Databox 中粘贴 API 凭据，为要拉取的 API 创建自定义连接。
2. 定义并构建数据集：同步期间，Databox 拉取数据并结构化为可探索、过滤和分段的数据集。
3. 使用 Genie 或 MCP 分析：在 Databox 内用 Genie 提问，或将数据集发送至 MCP 兼容 AI 工具分析。

如果 API 设置更复杂，页面指出您可以将 API 文档粘贴至 AI 工具（例如 Claude 或 ChatGPT）生成配置，然后将该配置粘贴至 Databox。

使用场景

• 报告利基或内部系统：如果工具不在 Databox 原生集成列表中（例如内部 API 或利基平台），创建自定义 API 连接并与其他源一起分析。
• 消除仪表板中缺失数据：当报告因手动导出或脆弱管道而不完整时，使用 Custom Integrations 定期将数据同步为结构化数据集至 Databox。
• 代理客户跨不同技术栈报告：通过自定义集成连接每个客户的独立工具，从而交付反映完整客户数据源的报告。
• 从 API 数据构建指标和 KPI：使用同步数据集创建指标，并将其纳入 Databoards、Goals 或警报。
• 无需电子表格进行动手分析：通过将 API 输出结构化为数据集取代手动电子表格导出，用户可直接过滤、分段和查询。

常见问题

Databox 中的 Custom Integration 是什么？

Custom Integration 是连接几乎任何通过 API 返回 JSON 的工具或数据源的方式——即使它未作为 Databox 原生集成可用。您定义连接，将数据同步为结构化数据集，并使用 Genie 或 MCP 兼容 AI 工具分析。

如何将自定义 API 连接到 Databox？

在 Databox 中添加 API 凭据并定义 Databox 如何拉取数据。对于更复杂的设置，页面建议使用 AI 工具将 API 文档转为即用配置，然后将该配置粘贴至 Databox。

我能从带分页的 API 拉取完整数据集吗？

是的。Databox 在同步期间自动处理分页，包括 API 使用各种分页方案的情况，从而接收完整数据集。

我能将同一 API 连接用于多个数据集吗？

是的。页面指出，您可连接一次源，并在多个数据集间复用，无需每次重新配置连接。

支持哪些认证类型？

页面列出 OAuth2、Basic、Token 和 API 密钥认证方法，用于自定义 API 连接。

替代方案

• 无代码/自动化工具用于移动数据（例如，电子表格或数据库同步工作流）：当您主要需要将数据复制到其他系统时有用，但工作流可能更手动，与Databox托管的数据集同步相比，可能需要持续的管道维护。
• 构建自定义应用或中间件：为边缘情况提供最大控制，但需要更多工程努力来维护连接、分页和数据标准化。
• 原生BI/ETL工具摄取REST API：将API数据转换为分析就绪表格的替代方法；区别在于，您可能需要在Databox的数据集 + Genie工作流之外设置定期摄取和建模。
• 使用带MCP的AI工具和您自己的数据管道：如果您已有MCP就绪的数据流，可以直接将数据集馈送到AI工具；这将集成和数据准备工作转移到您现有的管道，而不是使用Databox Custom Integrations来结构化和同步数据。