mini-AGI Backend

🤖 迷你AGI后端

具有会话记忆的企业级AI代理编排平台

一个强大的后端系统，用于编排具有多提供商LLM支持、对话记忆、角色系统和工具集成的AI代理。

______________________________________________________________________

✨ 主要特点

• 🧠 对话记忆 -AI会记住会话中的先前聊天记录
• 🎭 Persona系统 -专业人工智能人士（交易、编码、研究）
• 🔌 多提供商LLM -在Z.AI和Ollama之间切换
• 🤝 智能体协同 -智能任务委托给专家
• 🛠️ 工具集成 -文件I/O、代码执行、MCP服务器
• 🔍 存储器搜索 -查找过去的对话
• 💾 数据库管理 -Oracle Cloud的自动清理和监控
• 🐳 Docker就绪 -一次指挥部署

______________________________________________________________________

🚀 快速开始

1.配置

cp .env.backend-only.example .env
# Edit .env and add: ZAI_API_KEY=your-key

2.开始

窗户：

start-backend.bat

Linux/Mac：

docker-compose -f docker-compose.backend-only.yml up -d

3.测试

curl http://localhost:8000/health

API文件： http://localhost:8000/docs

______________________________________________________________________

💬 快速示例

简单聊天

curl -X POST http://localhost:8000/chat \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Hello"}]}'

有记忆（AI记得！）

# Message 1
curl -X POST http://localhost:8000/chat \
  -d '{"user_id":"john","messages":[{"role":"user","content":"My name is John"}]}'

# Message 2 (use session_id from response)
curl -X POST http://localhost:8000/chat \
  -d '{"session_id":"","user_id":"john","messages":[{"role":"user","content":"What is my name?"}]}'

# Response: "Your name is John, as you mentioned earlier."

______________________________________________________________________

📚 文档

交互式文档： http://localhost:8000/docs

______________________________________________________________________

📡 API终点

核心

• GET /health -健康检查
• POST /chat -主聊天与记忆
• GET /personas -可用人物角色
• GET /llm/info -LLM配置

记忆

• POST /sessions -创建会话
• GET /sessions/{id}/history -获取历史记录
• GET /conversations/search -搜索对话
• POST /memory/facts -保存用户事实
• DELETE /sessions/cleanup -清理旧数据

数据库管理（Oracle云）

• GET /db/size -检查数据库大小
• GET /db/status -检查尺寸限制
• POST /db/cleanup/auto -自动清理
• POST /db/archive -存档旧数据
• POST /db/optimize -优化数据库

API完整参考： API_GUIDE.md

______________________________________________________________________

🎯 是什么让它变得聪明？

1. 记住上下文 -保持最后5轮对话
2. 了解用户 -商店偏好和事实
3. 搜索历史记录 -查找过去的讨论
4. 专业人物 -特定领域专家
5. 代理商协调 -代表最佳专家
6. 工具执行 -文件操作，代码运行

______________________________________________________________________

🔧 配置

# .env file
LLM_PROVIDER=zai
LLM_MODEL=glm-4.6
ZAI_API_KEY=your-key
CORS_ORIGINS=http://localhost:3000

______________________________________________________________________

🐳 部署

# Backend only (recommended)
docker-compose -f docker-compose.backend-only.yml up -d

# With Ollama
docker-compose up -d
docker exec -it ollama ollama pull llama3.1:8b

______________________________________________________________________

📊 建筑

FastAPI Backend
├── Memory System (SQLite)
├── Persona System
├── Agent Orchestrator
│   ├── Coder
│   └── Researcher
└── LLM Provider (Z.AI/Ollama)

______________________________________________________________________

🎉 v2.0中的新增功能

✅ 对话记忆系统 ✅ Persona支持 ✅ 长期用户事实 ✅ 会话管理 ✅ 对话搜索 ✅ 多供应商法学硕士 ✅ 数据库大小管理（Oracle云免费层）

______________________________________________________________________

开始： 看 API_GUIDE.md 获取完整文档！ 🚀