② Agent Service Maven 聚合:逻辑架构中的 Agent Server 数据面(Agent-App + Adapters 胶水),将单 Agent 封装为 HTTP 可部署服务。完整逻辑架构见 逻辑架构。
service/ packaging=pom · agent-service
├── agent-service-spec 契约 + SPI(纯 Java)
├── agent-service-adapters/ Adapters 聚合
│ ├── agent-service-adapters-common 中间件客户端、凭证、外部调用 DFX(引擎无关)
│ └── agent-service-adapters-agentcore AgentHandler + Core 中间件/外部服务绑定
├── agent-service-app Controller + Orchestrator + Lifecycle + AutoConfig
└── agent-service-demo 可运行示例
agent-service-app
→ agent-service-adapters-*(业务镜像选择)
→ agent-service-spec
agent-service-app 主代码不硬依赖 adapters-agentcore;由 demo 或产品镜像引入具体 adapter。
在 service/ 目录执行:
mvn clean test构建单个模块(含依赖 -am):
mvn -pl agent-service-app -am clean test
mvn -pl agent-service-demo -am spring-boot:run| 模块 | 说明 | 文档 |
|---|---|---|
| spec | 路径、DTO、AgentHandler / ServeOrchestrator SPI |
spec.README |
| adapters-common | Redis/Memory 契约与配置、凭证解密、外部调用 DFX | 包内 package-info |
| adapters-agentcore | JiuwenCoreAgentHandler;Checkpointer/Memory/MCP/远端/Sandbox 绑定 |
Adapters 与 Handler |
| app | Ingress Controller、默认 Orchestrator、Lifecycle | HTTP 对话面 |
| demo | 最小 Spring Boot 示例 | agent-service-demo/README.md |
执行内核为 agent-core-java(独立仓库,版本见 [Agent Core 依赖](../documents/zh/2.开发指南/Agent Core 依赖.md))。Service 层通过 adapters-agentcore 调用 Runner,不重复实现图执行引擎。
与仓库根 agent-runtime-java 版本一致(当前 0.1.1.post1)。