AI代理编排平台

企业级AI代理编排平台,支持多提供商LLM、对话记忆、角色系统和工具集成。

  • by b9b4ymiN
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 b9b4ymiN/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":"<session-id>","user_id":"john","messages":[{"role":"user","content":"What is my name?"}]}'

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

📚 文档

文档 描述
内存_用法_用户名.md ⭐ 如何正确使用内存
API_GUIDE.md 完整的API参考资料和所有示例
存储器_SYSTEM.md 存储系统详细指南
部署.md 部署选项

交互式文档: 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 获取完整文档! 🚀