SuperAGI 源码学习
20 天 · 每天 30 分钟 · 逐层读懂开源的"自主 AI 智能体平台"——用 GUI 构建、并发运行、给智能体配工具与长期记忆，让它自主循环达成目标
开篇 · 这是个什么项目
SuperAGI 是一个开源的 自主 AI 智能体开发与运行平台。你在 GUI 里给智能体设定目标 + 工具 + 大模型，它就在后台自主循环（想 → 选工具 → 执行 → 观察 → 再想）直到达成目标。它支持并发跑多个智能体、工具市场、长期记忆、可视化监控。
🎯 一句话：SuperAGI 是一个完整的自主智能体平台——你定义智能体（目标+工具+LLM），后端把它排队交给 Celery 后台 worker 运行它的自主循环，运行过程和结果实时流回 GUI。它按工作流步骤驱动智能体，配向量记忆和资源管理。
目标驱动
给目标和指令，智能体自主拆解、循环执行直到完成。
工具 & 工具市场
丰富的工具（搜索/文件/代码/邮件…）+ 可扩展的 toolkit。
向量长期记忆
Pinecone/Chroma/Qdrant/Redis，让智能体"记住"过往。
并发后台运行
Celery worker 后台跑智能体循环，GUI 监控，不阻塞。
superagi/（FastAPI），GUI 在 gui/（Next.js）。架构全景（动起来看）
下图那颗发光小球是"你创建的一个智能体从 GUI 落到后台 worker 自主运行"的过程。从上到下：GUI → API → Agent 执行 → 底层能力。
SuperAGI 智能体的核心是一个自主循环（由工作流步骤驱动）：
问 LLM 下一步→ 2. 选工具LLM 决定
用哪个工具→ 3. 执行跑工具
拿结果→ 4. 观察结果存记忆
喂回下轮↺ 回到 1直到完成
怎么用这份教程
每天 30 分钟
一天一个独立页面，跟着"今日小结 + 动手"收尾。
零基础友好
不假设你懂 Agent/Celery/向量库，术语首次出现都有大白话解释。
精确到行号
关键代码标 文件:行号，可在真源码里跳转对照。
项目全景与架构
SuperAGI 是什么、平台架构、核心概念地图、技术栈。
Agent：自主智能体
目标/指令/工具/LLM，自主循环的心智模型。
工具 Tools
工具是智能体的手：name+描述+参数+_execute。
运行平台（docker compose）
启动后端+GUI+Postgres+Redis+Celery。
一次 agent 运行的完整旅程
从创建到 Celery 后台自主循环、结果流回。
Agent 执行循环
迭代步 + 工具步，自主循环怎么转。
工作流 workflow 与 step
用工作流步骤结构化地驱动智能体。
提示词构建
role/goal/工具/记忆怎么拼成 LLM 提示。
输出解析 output_parser
把 LLM 回复解析成"选哪个工具+参数"。
LLM 抽象
多模型（OpenAI/Palm…）统一接口、token 计数。
工具体系深入
base_tool、toolkit、真实工具精读。
tool_manager 与工具市场
工具怎么注册、安装、提供给智能体。
向量记忆 vector store
Pinecone/Chroma/Qdrant/Redis 长期记忆 + RAG。
资源管理 resource manager
智能体产出/使用的文件怎么存和用（S3/本地）。
数据模型
Agent/Execution/Workflow/Tool 等 DB 模型。
API controllers
FastAPI 端点：agent/execution/tool/project。
Celery 异步执行
后台 worker 跑智能体循环、调度、不阻塞 API。
GUI 与前端
Next.js 界面怎么创建智能体、实时监控。
部署与配置
config、docker 变体、本地 LLM、生产部署。
构建测试与收官串讲
全平台回顾、设计哲学、五框架对比。
✅ 全部 20 天已就绪。建议按顺序学。准备好了就从 Day 01 · 项目全景 开始。