Delphi Agent Framework

🚀 企业级 Java Agent 框架
基于 Spring AI + Virtual Threads，为 Java 后端团队提供生产级 LLM 应用开发能力

📖 完整文档 | 🚀 快速开始 | 💬 讨论区

---

为什么选择 Delphi Agent？

✅ Java 生态原生

• Virtual Threads：百万级并发，无需复杂的 asyncio 编程
• Maven 生态：企业级依赖管理，Spring Boot 开箱即用
• 类型安全：编译期检查，重构友好，IDE 支持完善

✅ Spring AI 多模型适配

• 统一 ChatModel 接口，一行代码切换 DeepSeek / OpenAI / Claude
• Anthropic Messages API 兼容（通过 Spring AI Anthropic Provider）
• 支持本地模型（Ollama / vLLM）

✅ 生产级运行时

• 分布式协调：Redis Lease + Run Queue + SSE Pub/Sub
• 数据持久化：MongoDB + Outbox Pattern 保证事件可靠投递
• 多租户治理：namespace 隔离、配额、审计、速率限制

✅ 企业级 Sandbox

• Docker 隔离 + 非 root 用户 + read-only rootfs
• S3 兼容的 Workspace Snapshot（MinIO / AWS S3）
• 正常下线闭环（drain + graceful shutdown）

---

快速对比：Python vs Java Agent 框架

特性	LangChain (Python)	Delphi Agent (Java)
ReAct Loop	✅	✅
工具调用	✅	✅ (Spring AI ToolDefinition)
流式响应	✅	✅ (Flux<StreamEvent>)
多模型支持	OpenAI / Anthropic SDK	Spring AI 统一抽象
并发处理	asyncio	Virtual Threads (更简单)
分布式部署	需自行实现	开箱即用 (Redis 协调)
多租户	需自行实现	内置 namespace + 配额
企业安全	需自行实现	审计日志 + 工具策略管道
适用团队	AI 研究 / 原型开发	Java 后端团队 / SaaS 公司

---

快速开始

1. 环境准备

# 切换到 JDK 21
jdk21

# 验证版本
java -version  # 应显示 Java 21

# 启动依赖服务（MongoDB + Redis）
docker run -d -p 27017:27017 --name mongo mongo:5
docker run -d -p 6379:6379 --name redis redis:6.2

2. 配置环境变量

创建 .env 文件：

DEEPSEEK_API_KEY=sk-your-key
MONGODB_URI=mongodb://localhost:27017/pi-agent-framework
REDIS_HOST=localhost
REDIS_PORT=6379

3. 启动服务

# 编译
mvn clean compile -DskipTests

# 启动
mvn spring-boot:run -pl delphi-agent-server

4. 验证

curl http://localhost:8080/actuator/health
curl http://localhost:8080/api/catalog/models

👉 5 分钟教程：创建你的第一个 Agent

---

核心能力

• ✅ ReAct Agent Loop：模型流式推理、工具调用、结果回灌、自动压缩
• ✅ 会话运行时：MongoDB 持久化、会话树、fork、navigate、compact
• ✅ Subagent 编排：ORCHESTRATOR / CODER / TESTER 角色分工与工具链
• ✅ 工具系统：read / bash / edit / grep / find / Skill 扩展
• ✅ 多节点部署：Redis 协调、SSE 可靠投递、正常下线闭环
• ✅ 多租户治理：配额、速率限制、审计、用量统计

📚 完整能力清单

---

文档导航

分类	内容
🚀 快速开始	安装、第一个 Agent、架构概览、FAQ
🔧 Spring AI 集成	多模型配置、自定义 Provider、流式响应
☕ Java 最佳实践	Virtual Threads、Reactive Streams、性能调优
📖 开发指南	Agent Loop、会话、工具、Subagent、多租户
🚢 部署运维	单节点、分布式、K8s、监控、故障排查
💡 实战教程	5 套端到端案例教程
📚 API 参考	HTTP API、SDK、数据模型、配置
🏗️ 架构设计	模块详解、事件模型、Redis 协调

---

技术栈

组件	版本	说明
Java	21	Virtual Threads 支持
Spring Boot	3.4.1	企业级框架
Spring AI	1.1.3	多模型统一抽象
MongoDB	5+	会话与事件持久化
Redis	6.2+	分布式协调与 SSE
Docker	20+	Sandbox 隔离
Maven	3.9+	构建工具

---

示例

5 套端到端案例，覆盖 Skill、Sandbox、多租户、SaaS 场景：

# 示例 1：技能系统入门
bash samples/1-basic-skill-usage/test.sh

# 示例 5：完整 SaaS 应用
bash samples/5-comprehensive-demo/test.sh

详见 samples/README.md 和 实战教程

---

开发命令

# 编译
mvn clean compile -DskipTests

# 测试
mvn test

# 测试指定模块
mvn test -pl delphi-agent-runtime

# 启动服务
mvn spring-boot:run -pl delphi-agent-server

# 打包
mvn package -DskipTests

---

贡献

欢迎提 issue 和 PR！详见 贡献指南

---

License

Apache 2.0

---

致谢

感谢所有贡献者！特别感谢 Spring AI 社区的支持。