本资料是 Celigo 集成的入门定位文档,用于帮助使用者理解集成体系的核心概念、构建顺序与操作纪律。
用途与核心概念:Celigo 集成通过少量资源类型在外部系统间搬运数据,包括连接(外部系统的凭据与配置)、导出(数据源步骤)、导入(数据目标步骤)、流程(连接导出与导入的管线,可含分支、转换与脚本)、集成(分组相关流程与资源的命名容器)、脚本(在 preSavePage、preMap、postMap、postSubmit、postResponseMap 等点位运行的 JavaScript 钩子)、API(对外同步消费的自定义 HTTP 端点)、工具(可被流程、API、AI Agent、MCP 服务器复用的构建块)、AI Agent(以导入形式存储的 LLM 处理步骤)、护栏(PII、内容审核、AI 评估等安全检查,仅标记记录,由父管线决定处置)、查找缓存(账号级键值存储)。
主要能力与构建顺序:流程由 cron 调度、监听器/webhook 或其它流程触发,支持运行时控制;API 由外部 HTTP 调用触发,错误落在失败响应,重试由调用方负责;工具由消费者调用,错误行为由消费者决定。构建必须自底向上:先建连接,再建导出与导入,最后建流程;API 与工具同理先建其依赖资源。每个层级应优先匹配目标应用专用适配器,其次使用预置 HTTP 连接器(celigo http-connectors list),最后才手写 HTTP 配置。
使用方式:可选 CLI 或 MCP 服务器,两者操作可相互对应。CLI 配置包括 celigo config set api_token <token>、celigo config set base_url <url>、celigo config show。CLI 每个账号或环境保留一个配置文件,解析顺序为 --profile > CELIGO_PROFILE > 活动配置文件,写操作前应运行 celigo profile whoami 确认目标,不应在报错时擅自设置 token 或切换 profile。可构建本地账号索引:celigo account snapshot、celigo account search、celigo account dependencies、celigo account lint、celigo account stats,索引默认 4 小时过期(可用 CELIGO_INDEX_STALE_HOURS 配置),依赖索引的命令会自动刷新,除非传入 --no-refresh。新建前先发现已有资源。
规划与限制:需区分修改既有资源配置、修改流程结构与新建构建,存在歧义时先做设计检查,明确源与目标系统、数据方向、触发频率、失败处置、响应映射、是否模板化以及沙箱或生产。沙箱与生产严格隔离,sandbox 连接只能被 sandbox 流程使用,混用会引发运行时错误;测试应先用 disabled: true。文档还给出各任务对应的技能入口表,并说明参考模式未覆盖时依次以真实资源、开发者文档(页面 URL 追加 .md、https://developer.celigo.com/llms.txt、https://developer.celigo.com/readme.md?ask=<question>)和已发布 schema 为准。文档未提供的具体字段或功能细节暂未提供。