113 lines
3.2 KiB
Markdown
113 lines
3.2 KiB
Markdown
# Atlas Zero Agent
|
||
|
||
`Atlas Zero Agent` 是一个面向通用对话场景的 `chatbox agent` 项目。
|
||
|
||
它以聊天作为统一入口，内部通过多 agent 协作完成规划、执行、知识检索、记忆管理、安全审查和资源调度，目标是做成一个可扩展、可服务化、可观测的 agent runtime，而不是一个只会单轮回答的聊天壳。
|
||
|
||
## Vision
|
||
|
||
- 一个对外统一的聊天入口
|
||
- 一个对内可编排的 agent runtime
|
||
- 一套可持续扩展的 memory、RAG 与 tools 体系
|
||
- 一套适合产品化落地的 API、状态管理与治理能力
|
||
|
||
## Core Ideas
|
||
|
||
- `Chatbox First`: 用户只面对一个自然的聊天入口
|
||
- `Agent Runtime Inside`: 内部通过多个职责明确的 agents 协同工作
|
||
- `FastAPI Native`: 后端优先采用服务化接口设计
|
||
- `LangChain + LangGraph`: 用组件抽象连接模型、工具和知识，用状态图管理多步执行
|
||
- `Observable by Default`: 从一开始就考虑 trace、审计、成本和运行状态
|
||
|
||
## Agent Roles
|
||
|
||
项目借用了《海贼王》蛋头岛 `Vegapunk satellites` 的命名体系，但这些名字不只是皮肤，而是对应真实职责：
|
||
|
||
- `Stella`: 主控入口与 orchestrator
|
||
- `Atlas`: 执行型 agent，负责工具调用和任务落地
|
||
- `Edison`: 规划型 agent，负责步骤拆解与工具编排
|
||
- `Pythagoras`: 知识与记忆 agent，负责 RAG、总结与长期上下文
|
||
- `Shaka`: 安全与规则 agent，负责 guardrails、风险判定与权限控制
|
||
- `Lilith`: 探索型 agent，负责多路搜索、试探和实验性路径
|
||
- `York`: 资源型 agent，负责模型路由、配额、队列和成本控制
|
||
|
||
## Architecture
|
||
|
||
建议采用分层结构：
|
||
|
||
- `Interface Layer`: `FastAPI` 对外接口、流式输出、会话 API
|
||
- `Application Layer`: 请求编排、权限、会话上下文、服务层
|
||
- `Agent Runtime Layer`: `LangGraph` 编排多 agent 状态流转
|
||
- `Knowledge Layer`: session memory、long-term memory、RAG
|
||
- `Tool Layer`: 本地工具、外部 API、未来的 `MCP` 接入
|
||
- `Observability Layer`: trace、审计、指标、成本治理
|
||
|
||
更详细的工程版设计见：
|
||
|
||
- `atlas-zero-agent-design.md`
|
||
- `docs/architecture.md`
|
||
|
||
## Planned Stack
|
||
|
||
- `FastAPI`
|
||
- `Pydantic`
|
||
- `LangChain`
|
||
- `LangGraph`
|
||
- `PostgreSQL`
|
||
- `Redis`
|
||
- `pgvector`
|
||
- `LangSmith` or `OpenTelemetry`
|
||
|
||
## API Direction
|
||
|
||
第一阶段建议优先做这些接口：
|
||
|
||
- `POST /api/chat`
|
||
- `POST /api/chat/stream`
|
||
- `GET /api/sessions/{session_id}`
|
||
- `POST /api/sessions/{session_id}/messages`
|
||
- `GET /api/agents`
|
||
- `GET /api/health`
|
||
|
||
## Roadmap
|
||
|
||
### Phase 1
|
||
|
||
- 基础 chat API
|
||
- 流式输出
|
||
- session 持久化
|
||
- 最小多 agent 执行链路
|
||
- 基础 memory 与 RAG
|
||
|
||
### Phase 2
|
||
|
||
- 多 agent 扩展
|
||
- 用户长期记忆
|
||
- 文件上传与知识入库
|
||
- 模型路由与预算控制
|
||
- 更完整的 observability
|
||
|
||
### Phase 3
|
||
|
||
- 异步任务与队列
|
||
- 人工审批
|
||
- `MCP` 工具接入
|
||
- 多租户与插件化
|
||
|
||
## Current Status
|
||
|
||
当前仓库处于设计和骨架规划阶段，重点先明确：
|
||
|
||
- 命名体系
|
||
- agent 职责边界
|
||
- runtime 架构
|
||
- API 设计
|
||
- 最小可运行实现路径
|
||
|
||
## Repository Notes
|
||
|
||
- 设计草案：`atlas-zero-agent-design.md`
|
||
- 工程架构：`docs/architecture.md`
|
||
|
||
后续可以从一个最小闭环开始：`Stella -> Shaka -> Edison -> Pythagoras -> Atlas`。
|