跳到主要内容

原生 Agent 系统 · C++20

构建真正属于你运行时的 Agent。

Wuwe 将模型访问、类型化工具、推理、规划、记忆、检索、MCP 与受控执行组合进一套原生 C++ 框架。

阅读文档在 GitHub 查看
语言
C++20
版本
0.1.0
构建平台
Windows · Linux
模型
可组合 · 可审计

一个运行时，明确的边界

组合需要的部分，继续拥有整个系统。

每个子系统都有聚焦的契约，可以独立使用。上层推理与规划 API 负责组合它们，但不会隐藏状态、策略或执行轨迹。

  1. 01

    模型访问

    OpenAI 兼容接口，以及 Anthropic、Gemini 与 Ollama

  2. 02

    推理与规划

    ReAct、反思、计划执行、预算与审批

  3. 03

    工具与协议

    类型化分发、MCP 服务端与客户端、HTTP 和 stdio 适配器

  4. 04

    状态与知识

    记忆、Embedding、混合检索、引用与 Qdrant

  5. 05

    执行与证据

    能力检查、策略钩子、审计事件与轨迹

可组合模块

使用一个能力，或组合出完整运行时。

十六个聚焦模块共享事件、状态、策略与执行契约。可以独立采用，再只按产品需要进行组合。

模型与编排

  • LLM Provider

    统一支持 OpenAI 兼容接口、Anthropic、Gemini、Ollama 与 OpenRouter。

  • 工具

    类型化定义、分发、结构化结果以及面向模型的工具调用。

  • 推理

    具有预算、工具使用和执行轨迹的可观察推理循环。

  • 反思

    基于可替换存储的批评、评估与迭代改进。

  • 规划

    计划生成、持久化、反思与受控步骤执行。

  • 编排

    在不隐藏控制权的前提下组合运行时操作的 Flow 原语。

状态与知识

  • 记忆

    策略驱动的记忆能力，支持内存、文件、SQLite 与 Qdrant 后端。

  • 知识 / RAG

    加载、切分、索引、检索、重排、Grounding 与引用。

协议与传输

  • MCP

    客户端、服务端、Gateway、宿主运行时，以及 HTTP、stdio 和进程传输。

  • 网络

    可选择的 HTTP 后端、流式事件解析和类型化传输错误。

治理

  • 能力策略

    在运行时边界显式声明能力并执行策略检查。

  • 审批

    为需要宿主授权的操作提供审批服务契约。

  • 审计

    结构化审计事件、可配置 Sink 与宿主持有的留存策略。

  • 可观测性

    公共事件 Sink、模块 Observer、轨迹与遥测适配器。

执行

  • 受控执行

    执行注册表、策略、路径检查与受控进程工具。

  • 沙箱

    后端执行契约与明确的平台能力报告。

从一个小接口开始

从 Provider 选择到原生代码中的一次响应。

同一套 Provider 抽象可以继续扩展到流式输出、工具调用、推理策略和宿主持有的状态。

开始使用
main.cppOpenAI-compatible provider
#include <iostream>
#include <wuwe/wuwe.h>

int main() {
  wuwe::llm_config config{.model = "gpt-4.1-mini"};

  wuwe::llm_client_factory factory;
  auto client = factory.create_shared("OpenAI", config);
  const auto response = client->complete("Explain RAII briefly.");

  if (!response) return 1;
  std::cout << response.content << '\n';
}

适用场景

为重视原生集成的产品而构建。

Wuwe 不规定唯一的应用形态，而是提供运行时组件，让宿主继续拥有最终体验。

桌面应用

加入上下文助手、文档工作流或操作工具，同时让核心状态留在进程内。

后端服务

在既有服务边界和可观测体系内运行工具调用与有状态 Agent 工作流。

开发者工具

组合规划、MCP、检索和受控执行，服务自动化与工程工作流。

私有部署

根据产品部署模型选择本地 Provider、持久化方式和外部服务。

文档

从一个模块开始，逐步构建 Agent 运行时。

文档遵循同一条路径：先完成构建，再组合推理、状态、协议与受控执行。

开始构建