用途:在 Celigo 流程中配置 AI 导入步骤。AI 智能体是一种由 LLM 驱动的导入步骤,记录流入后由模型按指令处理,再以结构化输出回流到管道,可用于分类、抽取、摘要、翻译、生成、校验等。护栏则用于对数据做安全与合规检查。
主要能力: AI 智能体支持两类提供商。OpenAI(provider: "openai")经 Responses API 调用 GPT 模型,支持推理强度控制、结构化 JSON 输出、web_search、MCP、Celigo Tools 与图像生成;Gemini(provider: "gemini")经 LiteLLM 代理,支持 thinking 配置、Google Search grounding、urlContext、fileSearch、MCP 与 Celigo Tools。 输入字段仅有 text、record、files、conversationHistoryId 四个;未配置输入映射时默认收到整个在途记录。 输出格式决定返回内容与响应变量:text 对应 _text,json_schema 对应 _json(strict: true 时不符合模式则失败),blob 对应 blobKey。 护栏有三种子类型:ai_agent(用 AI 模型按自定义指令评估数据)、pii(检测并可选掩码邮箱、SSN、信用卡等)、moderation(按仇恨、暴力、骚扰等类别检查内容)。confidenceThreshold 取值 0 到 1,默认 0.7。
使用方式:智能体必填 name、adaptorType: "AiAgentImport" 与提供方配置块;护栏必填 name、adaptorType: "GuardrailImport"、guardrail.type 及子类型配置。默认使用平台托管凭据,无需 _connectionId;BYOK 则需在连接上配置自己的 API 密钥,或用 celigo ai-agents replace-connection <agentId> <connectionId> 切换。常用命令:celigo ai-agents list / get / create / update / set / delete / invoke,celigo ai-agents clone、enable-debug、disable-debug;护栏对应 celigo guardrails 同名子命令。可用 echo '[{"text":"classify this"}]' | celigo ai-agents invoke <id> 做测试。
限制:护栏只做标记(flagged: true|false 加理由),不会自行阻断,需由父级流程、API 或 Tool 决定后续处理。默认无状态,需映射 conversationHistoryId 才有对话记忆,且历史按用户与智能体隔离、有 TTL 过期、无法通过公开 API 或界面浏览。Celigo AI 可选模型受其精选列表限制并计入账户月度 token 配额;BYOK 模型限制取决于提供商。切换 Celigo AI 与 BYOK 或更换模型可能使 serviceTier、reasoning.effort、图像模态等配置失效。构建前应逐项核对需求动作是否有模型原生能力、已接入工具或下游步骤支撑。其余细节暂未提供。