SuperAPI AI 工具集

cordum

Cordum 是面向 AI 智能体的“动作防火墙”与智能体控制平面(Agent Control Plane),为自主 AI 智能体提供确定性的治理层。它可在风险工具调用、Shell 命令、工作流和生产变更执行前强制策略与人工审批,并留下可审计的证据。Cordum 采用 Before/During/Across 框架:执行前定义声明式策略、触发安全内核检查或标记人工审批;执行中实时监控智能体运行、支持步骤级审批与超时/熔断;跨智能体统一管理审计追踪、能力路由与智能体池健康度。产品还包含 Cordum Edge——面向 Claude Code 等本地 AI 智能体动作的合规防火墙,通过命令钩子在风险动作运行前拒绝、对编辑要求审批,并为每次会话导出脱敏证据包。Cordum 实现开放协议 CAP(Cordum Agent Protocol),用于分布式智能体治理,并与 MCP 互补。提供 Go SDK(稳定版)以及 Python、Node SDK,包含 30 多个集成包(Slack、GitHub、AWS、Jira、Terraform、Datadog、PagerDuty 等)。许可为 BUSL-1.1,允许自托管与内部使用、修改与回馈,不允许作为竞争性托管服务提供,2029 年 1 月 1 日转为 Apache 2.0。

访问官网

工具介绍

Cordum 是面向 AI 智能体的动作防火墙(action firewall)与智能体控制平面,定位为针对概率性 AI 的确定性治理层,使团队能够跨任意框架或模型定义、执行并审计自主 AI 智能体的行为。

用途与要解决的问题 企业正在快速部署自主 AI 智能体,但面临风险控制不足的问题。根据资料引用的 Gartner 数据,74% 的企业将 AI 智能体视为新的攻击向量,超过 40% 的智能体 AI 项目将因风险控制不足而被取消。缺少专门的治理层会导致:没有可见性(智能体做了什么只能事后知道)、没有安全护栏(无法在危险操作执行前拦截)、没有人工在环(敏感操作无人工监督)、没有审计追踪(出错后无法还原决策链)。Cordum 通过在风险工具调用、Shell 命令、工作流和生产变更执行前强制执行策略与人工审批,并提供可审计证据来解决这一问题。

治理框架:Before / During / Across

  • BEFORE(治理):定义声明式策略,在智能体执行作业请求之前进行评估;可触发安全内核检查(safety kernel checks)、对风险动作限流,或将操作标记为需要人工审批。
  • DURING(安全):对正在运行的智能体进行实时可见性监控;实时监控进度、处理步骤级审批,并动态执行超时或熔断。
  • ACROSS(可观测性):从单一控制平面管理整个智能体机群;聚合审计追踪、跟踪基于能力的路由,并实时观察智能体池健康状况。

Cordum Edge:AI 智能体的合规防火墙 Cordum Edge 将控制平面扩展到本地 AI 智能体动作。针对 Claude Code,cordumctl edge claude 会启动真实 P0 路径:命令钩子、本地 cordum-agentd、Gateway Edge API、Safety Kernel policy/evaluate、审批、产物指针以及仪表板证据。其行为为:拒绝读取 .env;Edit/Write 需要审批;安全读取直接放行;仪表板在 /edge/sessions 展示实时会话时间线。对于已批准的破坏性操作,Edge 不单独信任审批存储:ProvenanceGate 还要求同一租户、approval_ref 和 action_hash 对应的已解析审批审计事件;仅有“请求审批”事件不满足溯源要求;原始提示、转录和工具负载不会进入审计证据。资料说明:包装器是开发者/演示路径,企业级强制执行需要托管 Claude 设置与端点控制。

安装与运行(Option A:从源码安装) 一条命令即可拉起完整栈——API 网关、调度器、安全内核、工作流引擎、上下文引擎、仪表板、NATS 以及经 TLS 保护的 Redis——自动生成密钥、自动配置证书,并执行部署后冒烟测试以演练真实审批工作流。 前置条件:Docker Desktop v4+(或 Engine v20.10+ 搭配 Compose v2,分配至少 4 GB RAM)、Go 1.26.3+(用于首次证书生成)、curl。Windows 上使用 MSYS2 / Git Bash / WSL。 完成后获得:仪表板位于 http://localhost:8082,使用 admin / ChangeMe123! 登录(默认开发密码,同时保存到 .env 的 CORDUM_ADMIN_PASSWORD,暴露栈前请修改);网关位于 http://localhost:8081,.env 中生成 CORDUM_API_KEY;./certs/ 下包含 TLS CA、服务器和客户端密钥对;内置 platform_smoke.sh 运行验证的可用审批门工作流。

安装与运行(Option B:运行已发布镜像) 前置条件:Docker Desktop v4+ 或 Docker Engine v20.10+ 配合 Compose v2(至少 4 GB RAM)、jq(推荐,用于解析 API 响应)、Go 1.26.3+(用于一次性本地证书生成——docker compose 会挂载 ./certs 但不会创建它)。 仪表板:http://localhost:8082。此路径默认关闭用户认证,请在仪表板使用 CORDUM_API_KEY 登录。若要改为管理员密码登录,在 .env 中设置 CORDUM_USER_AUTH_ENABLED=true 以及符合策略的 CORDUM_ADMIN_PASSWORD(至少 12 字符,含大写字母、数字和特殊字符),然后执行 docker compose up -d(Option A 的快速开始脚本会自动完成)。 可通过导出 CORDUM_VERSION=1.2.3 后再 docker compose pull 固定特定版本;默认 :latest,仅在稳定发布标签时移动(-rc.1 等预发布后缀不会提升 :latest)。每个发布标签镜像都使用 cosign keyless OIDC 签名;资料要求在生产部署前对全部七个 Cordum 镜像逐一验证,验证一个镜像不等于证明其余镜像。容器镜像为多架构:linux/amd64 + linux/arm64。 Helm:资料提到 --set 值会进入 Helm release 的存储值(以及 shell 历史),适合快速评估,但生产环境建议使用 redis.auth.existingSecret 而非 redis.auth.password,并通过带外方式将 secrets.apiKey 修补进渲染后的 Secret,而不是在命令行传入;该 chart 目前没有针对 API key 的 existingSecret 等价项。Helm chart 也可在 Artifact Hub 获取。

演示与 Edge 快速开始 栈启动后,安装 demo-quickstart 包并运行治理演示:单个 hello, operator! 工作流会扇出到三个主题,并在 30 秒内演练每一种安全内核决策类别。 Edge 快速开始:平台栈启动后,将 Claude Code 指向 Cordum。包装器会渲染临时 settings.json,在本地回环 nonce 上生成 cordum-agentd,并以已安装命令钩子启动 Claude Code。完整 30 分钟走查见 docs/quickstart-edge.md,参考 docs/edge/README.md。

开发者路径 已发布镜像路径从 ghcr.io 拉取 Cordum 二进制。需要从源码重建的贡献者使用开发覆盖文件:docker-compose.dev.yml 会将每个 Cordum 服务重新固定到本地 cordum/<name>:dev 标签并强制 build: 上下文,使源码变更在下一次 --build 时生效;上游镜像(NATS、Redis)不受影响。

协议:CAP 与 MCP Cordum 实现 CAP(Cordum Agent Protocol),这是一个专为分布式 AI 智能体治理设计的开放协议,为定义智能体能力、提交作业以及在异构智能体池中执行安全策略提供统一接口。CAP 与 MCP 互补:MCP 位于智能体内部,定义模型如何调用本地工具;CAP 位于智能体之上,定义整个智能体机群的治理控制平面。高层编排与安全门控用 CAP,细粒度工具集成在智能体内用 MCP。 Cordum 包含 MCP 服务器框架:通过 cmd/cordum-mcp 的独立 stdio 模式(用于 Claude Desktop/Code 本地集成);当 mcp.enabled=true 时通过 /mcp/message 和 /mcp/sse 的 Gateway HTTP/SSE 模式。

SDK 与集成 SDK:Go(稳定版,本仓库)、Python(pip install cap-sdk-python)、Node(npm install cap-sdk-node)。稳定版 CAP Go、Python 和 Node 运行时实现相同的已认证 protobuf worker-trust 契约。旧的 capability handshake 或 heartbeat 属于遥测,除非绑定到已接受的会话,否则不构成身份证明。部署在配置 worker 证明密钥和控制平面签名权威之前,保持显式兼容默认 CORDUM_SDK_HANDSHAKE=off + CORDUM_HEARTBEAT_MODE=authority;启用 warn 或 enforce 前遵循已认证 worker 信任指南。 集成包:30 多个集成包,覆盖 Slack、GitHub、AWS、Jira、Terraform、Datadog、PagerDuty 等。每个包都是 CAP 原生 worker,带有策略门控工作流。

企业功能(核心中已交付,通过许可证权益解锁) SSO/SAML/OIDC 集成 + SCIM 预配;带角色层级的高级 RBAC;SIEM 导出(webhook、syslog、Datadog、CloudWatch);法律保留 + 速率规则 + 智能体身份;优先支持。原独立的 cordum-enterprise 仓库已于 2026-04-23 退役。

治理与许可 Cordum 采用透明治理模型,包含协议稳定性承诺、维护者结构和明确决策流程。协议稳定性:CAP v2 线格式冻结至 2027 年 2 月。版本化采用语义化版本与弃用政策。 许可为 Business Source License 1.1 (BUSL-1.1):允许自托管和内部使用;允许修改并回馈;不允许作为竞争性托管服务提供;变更日期 2029 年 1 月 1 日——自动转为 Apache License 2.0。

限制与注意事项 默认开发密码和密钥必须在暴露栈前更改;生产部署需逐一验证全部镜像的 cosign 签名;Edge 包装器为开发者/演示路径,企业级强制执行需要托管 Claude 设置与端点控制;审批溯源仅认可已解析的审批审计事件;启用 warn 或 enforce 前需完成 worker 信任配置。