认识白泽
白泽（Baize）是一套 Server–Client 模式的多语言 Agent 运行时平台。Java Server 管理 Agent 与资源，Client 在业务应用、服务进程或桌面环境中执行任务。
你可以先在管理端配置模型、工具和知识库，再把 Agent 分发到合适的执行端。Client 主动连接 Server，两者通过 NARP v2 的 gRPC 双向流交换任务与事件。
从这里开始
白泽包含什么
| 组件 | 作用 | 入口 |
|---|---|---|
| Java Server | 管理 Agent、客户端应用、模型、MCP、Skill、RAG、资源与执行调度 | 部署 Server |
| 管理前端 | 配置与发布 Agent，管理资源和执行记录 | 创建与发布 Agent |
| Agent Client | 连接 Server，执行 Agent 循环、模型调用与客户端工具 | Java · Python · Node.js |
| 客户端业务工具 | 在业务进程里声明方法，连接和重连时上报，校验后进入本轮目录 | 嵌入业务工具 |
| Agent Trace | 按 Trace、执行、Agent 和状态回看路径、工具与用量 | 执行路径与运维 |
| Web / Desktop Chat | 面向用户的独立会话入口，支持流式对话与已授权 Agent | Web 对话端 · 桌面客户端 |
| Conformance | 三端共用的模型兼容规则、错误映射、reasoning 与 Schema 测试资产 | 多语言适配契约 |
Java、Python 与 Node.js Agent Client 已有实现。Rust 与 Golang Agent Client 属于规划，不作为本版可用接入方式。
理解三组关键关系
Server 与 Client
Server 负责“谁可以执行、使用哪些配置、交给哪个客户端”；Client 负责“怎样调用模型、怎样执行工具、怎样上报过程”。协议不绑定某一种 Agent 框架。
Java Client 使用 AgentScope，Python Client 使用 LangGraph（模型集成使用 LangChain），Node.js Client 使用 Pi Agent。它们复用共同的协议与适配契约，同时保留各语言运行时的实现方式。
库与启动工程
SDK 提供可嵌入能力，启动工程负责配置、装配和进程生命周期。Java 引用库位于后端模块中；Python 与 Node.js SDK 位于 baize-sdk；各语言独立启动工程位于 baize-clients。
业务系统可以直接消费相应库，无需把整个示例启动工程搬入应用。接入前请阅读对应语言指南，工具注册方式并非三端完全相同。
管理资源与执行资源
Agent 配置、模型、MCP、Skill 和 RAG 在管理面组织。运行时使用已授权的描述、引用或执行上下文；大文件通过资源链路获取，不把文件内容作为任意大对象塞入控制消息。
这套文档如何阅读
- 部署与使用：先读快速上手，再按需配置 Agent、模型、知识库和对话端。
- 业务开发：选择一种客户端语言，把方法注册为业务工具，并阅读接口。
- 运行与回看：用 Agent Trace 看一次执行的阶段、工具和用量。
- 运行时开发：阅读 NARP v2、适配契约与执行路径与运维。
内容依据
本文档根据当前仓库源码与 docs/ 设计资料整理，于 2026-10-29 核对。设计文档与源码发生冲突时，以当前实现为准。文档中的构建、启动与调用命令是操作说明，不表示本轮已执行过后端部署、数据库迁移或真实模型联调。