跳到正文
ActWeave

Apache 2.0 · 活跃开发中

织行

ActWeave

面向企业业务系统的 Agent 控制平面与运行接入平台。

将已有 HTTP API 与 OpenAPI 服务治理为可测试、可版本化、可发布的 Tool；编排为 Agent 与 Workflow；再通过独立运行面开放给 Web、App、BFF 与其他 Agent。一次运行，沿 Conversation、模型、委派、工作流与 Tool 全程可追踪。

查看源码本地启动
  • Space
  • Build
  • Connect
  • Run
  • Govern
AAPRuntimeTool

为什么需要

企业接入 Agent 时，缺的不是模型，是治理。

ActWeave 不是又一个聊天后台，也不是 ERP / CRM / CMDB 的替代品。它坐在既有业务系统与智能应用之间：把能力收敛为有契约的 Tool，再以受控运行 API 交给调用方。

  1. 业务 API 分散，模型直接拼 HTTP 调用

    Provider、Connection 与带输入/输出 Schema 的 Tool；OpenAPI 可导入为草稿

  2. 凭证、出站身份和环境散落在调用方

    Service Connection 保存运行连接与身份策略；Provider 声明契约与允许的 scope

  3. 改动 API 后难以知道运行面会受何影响

    Tool 具备草稿、测试、发布、禁用与版本；Agent / Workflow 只绑定已发布能力

  4. 每个应用自己发明一套接入方式

    AAP 提供 OAuth Client、Grant、Conversation、Run、SSE 与 TypeScript SDK

  5. 一次执行跨模型、子 Agent、工作流后难以排查

    审计中心按 Trace 展示步骤与嵌套委派；运行事件可通过 SSE 跟随和重放

如何工作

控制平面配置，运行平面执行。

控制台只是控制平面的一个入口。对外运行接入走与管理面分离的 AAP 路径；第三方不需要、也不应使用管理员的控制台会话来调用 Agent。

Console API /api/v1

控制平面

Workspace、Model、Provider、Connection、Tool、Agent、Workflow。发布的是经过测试的版本与绑定。

AAP /api/agent-access/v1

运行平面

Client 换取令牌，按 workspace、agent、scope 与 grant 创建 Conversation 与 Run，用 SSE 消费事件。

点一个节点，看它连向谁。

核心能力

把业务能力织进可审计的 Agent 运行路径。

  1. 01

    Tool Governance

    Tool 是 Agent 可调用的结构化业务能力，而不是模型任意访问的 URL。OpenAPI 导入或手工创建，带 Schema、超时重试、SSRF 防护与密钥注入。草稿、测试、发布、禁用、版本——正常发布要求最近一次测试通过。

  2. 02

    Agent Control Plane

    在 Workspace 内管理 Agent、模型 API、提示词修订、已发布 Tool / Workflow 绑定。Workflow 有图草稿、编译、试跑与发布。支持同 Workspace 委派，以及 A2A 入站暴露与出站远端。

  3. 03

    Runtime Access

    AAP 是面向业务应用的运行协议：Client 凭证或私钥 JWT 换令牌，按授权创建会话与运行。仓库提供 OpenAPI 契约、协议 schema、TypeScript SDK 与 BFF 聊天演示。

  4. 04

    End-to-End Audit

    审计中心按 Trace 回看发起方、Conversation / Run、模型 turn、委派、Workflow 步骤、Tool 调用、状态与耗时。正文是否可见取决于保留策略、权限与调试配置——审计不是无条件暴露敏感原文的承诺。

  5. 05

    Enterprise Integration

    业务规则、数据主权和最终操作仍在上游系统。ActWeave 管理的是 Agent 如何在已配置的连接与契约下调用这些能力，而不是取代 ERP、CRM、CMDB 或 IoT。

典型闭环

从契约到一次可回放的运行。

  1. 01

    建 Workspace

    注册模型 API、Provider 与 Service Connection。

  2. 02

    治理 Tool

    OpenAPI 导入或手工创建，定义契约与连接，测试后发布。

  3. 03

    配置 Agent

    绑定模型、提示词和已发布的 Tool 或 Workflow；需要时配置委派或 A2A。

  4. 04

    编排 Workflow

    设计、校验、试跑并发布确定性图。生成对话只出草案，不会自动发布。

  5. 05

    运行接入

    控制台试跑，或由外部应用经 AAP 创建 Conversation 与 Run，用 SSE 消费事件。

  6. 06

    按 Trace 回看

    在审计中心沿一次执行排查。可见内容依角色、保留和调试配置而定。

控制台

Space · Build · Connect · Run · Govern

控制台按产品闭环组织。以下画面来自仓库中的 Acme Commerce Demo。

Workspace 主页：Tool、Agent、Workflow 与运行概况。
总览 — Workspace 主页：Tool、Agent、Workflow 与运行概况。

适用场景

把已有接口交给 Agent，而不是重写业务系统。

  • 订单 / 库存 / 工单

    经 Provider、Connection 与 OpenAPI 导入为可发布 Tool，交给业务 Agent。

  • 运维与变更

    把受控诊断、变更与查询 API 编成 Workflow，并保留执行 Trace。

  • 多 Agent 协作

    同 Workspace 委派专业子 Agent，或按 A2A 暴露 / 调用外部 Agent。

  • 嵌入现有应用

    Web、移动端或 BFF 通过 AAP 的 Conversation、Run 与 SSE 维持会话。

  • 高风险 API 治理

    对会影响关键业务的 Tool 保留测试、发布和禁用，并用审计调查调用。

  • 统一运行接入

    用一层 AAP 服务多个调用方，而不是向每个应用分发控制台账号。

边界

支持什么，不支持什么。

协议边界写清楚，避免把尚未交付的能力当成承诺。

  • OpenAPI

    已支持

    导入既有 HTTP API，将 endpoint 物化为 Tool 草稿。

  • AAP

    已支持

    Web / App / BFF / 业务系统的运行接入：会话、运行、SSE。

  • A2A

    已实现

    同 Workspace 委派，以及入站暴露、Agent Card、出站远端。仍需 allowlist 与认证。

  • Workflow

    已实现

    确定性多步图：编译、试跑、发布。

  • MCP

    未支持

    当前仓库不提供 MCP server 或 client 运行面。

开始

一条 Compose 命令，拉起完整栈。

需要 Docker Desktop（或兼容的 Docker Engine）与 Compose v2。首次构建会拉取镜像并启动 PostgreSQL、Redis、MinIO、后端与控制台。

bash
git clone https://github.com/chenow9/act-weave.git
cd act-weave
docker compose up --build

控制台默认在本机 5174 端口。空数据卷会创建一个仅用于本地开发的管理员账号；首次登录后请立刻改密，不要把该口令带进生产。

阅读快速开始阅读架构AAP 接入指南