用途:配置 Celigo 护栏(Guardrail),对通过集成的数据做安全与合规检查,可跨流程、API 和工具复用。护栏以 adaptorType 为 GuardrailImport 的导入形式存在,通过 /v1/imports API 访问。
主要能力:三种互斥类型——pii(检测邮箱、电话、信用卡、社保号等实体,mask: true 时在 masked 字段返回脱敏副本,但需父级做响应映射回写才生效)、moderation(按sexual、hate、harassment、self_harm、violence、illicit 等固定类别检测)、ai_agent(用 OpenAI 模型按自定义指令评估,输出固定为 {flagged, reasoning})。另有 confidenceThreshold(0-1,默认 0.7)控制灵敏度。
使用方式:用 CLI 管理,如 celigo guardrails list、celigo guardrails create < guardrail.json、celigo guardrails invoke <id> 测试、celigo guardrails enable-debug/disable-debug。必填字段含 name、adaptorType、guardrail.type 及对应类型配置;除非 ai_agent 使用 BYOK,否则无需 _connectionId。
适用场景:源之后提前过滤、AI 智能体前保护输入、写入目标前防止 PII 外泄、智能体输出后做合规校验。需要两个正交检查时应串联两个护栏并通过路由分支。
限制:护栏只产生判定,是否拦截由父级路由决定;返回内容须父级映射才能传到下游;ai_agent 不支持工具、图片或 blob 输出;mask 不会自动替换原字段;pii/moderation 为确定性分类器,ai_agent 每次记录都调用 LLM,有成本与波动。