用途
Wanaku 是面向 AI 智能体的受治理操作代理(Governed Action Proxy)。它位于智能体与其所操作的系统之间,拦截 Model Context Protocol(MCP)工具调用、智能体间(agent-to-agent)消息以及推理流量。项目在 0.2.0 版本之前名为 Wanaku MCP Router,后更名为 Wanaku Governed Execution Proxy,以反映其扩展后的范围。
主要能力
- 智能体隔离(Agent Isolation):智能体通过 Wanaku 调用工具,从不直接触达后端系统。
- 策略执行(Policy Enforcement):由 LLM 驱动的评估器(LLM-powered evaluators)与 WASM 动作脚本(WASM action scripts)在代理层对工具调用进行分类、过滤和阻断。
- 身份与认证(Identity & Auth):通过 oauth2-proxy 和 Keycloak 进行认证与授权,并在操作到达后端之前强制执行。
- 工具发现(Tool Discovery):从上游 MCP 服务器自动发现工具;集成开发者可将 Camel 路由发布为工具。
- 命名空间隔离(Namespace Isolation):按团队、租户或环境在隔离的命名空间中组织工具与资源。
- 可扩展架构(Extensible Architecture):通过 feature crates 提供插件系统,并具备可组合的过滤管道(composable filter pipeline)。
- 管理仪表盘(Admin Dashboard):提供 Web UI 以管理工具、资源、提示词和转发(forwards)。
- 容器就绪(Container-Ready):自动发布多架构镜像(x86_64、aarch64)。
使用方式
在 Linux 或 macOS 上下载最新的早期访问(early-access)构建版本。安装程序会检测宿主平台、校验发布版本校验和,并将 wanaku-server 安装到 $HOME/bin。可通过 WANAKU_INSTALL_DIR 覆盖目标目录。
运行 wanaku-server,并访问 http://localhost:8080 进入仪表盘:
若偏好文本界面,也可从 Wanaku Barn 项目下载并使用 Wanaku CLI。
学习 Wanaku 最简单的方式是跟随引导式教程(guided tutorial)。包含完整安装与配置说明的参考文档见 usage guide。
远程服务器的所有工具随后都会出现在本地目录中,客户端并不知道它们是被转发的。
Wanaku 文档网站包含完整的项目文档。
参与项目的贡献者可能希望参考开发文档:Getting Started(开发环境搭建指南)、Architecture(系统架构与组件)、Configuration(环境变量与配置参考)、Management API(API 参考)、Admin UI(管理仪表盘开发)、Features / Plugins(feature crate 系统)、Plugin Catalog(发布与配置可用的 UI 插件)、Plugin Development(编写新 feature crate 的指南)、Evaluator Engine(基于 WASM 的评估器)、Action Policies(确定性 MCP 动作规则)、Governance Posture(执行模式与故障安全行为)、Contributing(贡献指南)、Security(安全策略)、GitHub Issues(缺陷报告与功能请求)、Discussions(提问与分享想法)。
适用场景
Wanaku 适合需要将企业系统与 AI 智能体集成、并希望在不允许智能体直接访问后端系统的情况下进行受控操作的组织。它支持与 Apache Camel 和 Quarkus 等企业框架的一等集成,例如集成开发者可构建 Apache Camel 路由,并通过 Camel Integration Capability 将其发布为工具,智能体带参调用这些工具,但实际工作由 Wanaku 执行。它也适用于需要按团队、租户或环境进行命名空间隔离的工具管理场景,以及需要策略执行、身份认证和审计要求的环境。
限制
当前资料未提供有关具体定价、收费模式、性能指标或部署规模限制的信息。资料提到提供的是最新的早期访问(early-access)构建版本,未说明功能何时或是否会进入正式版本。
相关项目
- Wanaku Barn:Wanaku 项目的实用工具,包括 OpenShift/Kubernetes operator、CLI 客户端等。
- Camel Integration Capability:构建 Apache Camel 路由并将其发布为工具,供智能体通过 Wanaku 调用。
本项目基于 Apache 2.0 许可证发布——详见 LICENSE 文件。