add subagent personal assistant by junxwang · Pull Request #449 · spring-ai-alibaba/examples

junxwang · 2026-03-20T14:14:02Z

What does this PR do?

feat: add subagent personal assistant

背景

本示例展示如何使用 Spring AI Alibaba 的 ReactAgent 框架构建一个多智能体监督者模式系统，通过主智能体协调多个子智能体，实现日历代理与邮件发送功能。

验证方法

设置 API Key
```
export DASHSCOPE_API_KEY=your-api-key
```

构建项目

cd subagent-personal-assistant-example
mvn clean package -DskipTests

运行应用
```
mvn spring-boot:run
```
访问API

curl --location 'http://127.0.0.1:8080/react/agent/supervisorAgent?query=Schedule%20a%20meeting%20with%20the%20design%20team%20next%20Tuesday%20at%202pm%20for%201%20hour%2C%20and%20send%20them%20an%20email%20reminder%20about%20reviewing%20the%20new%20mockups.&threadId=user-session-124&nodeId=_AGENT_HOOK_HITL' \
--header 'Content-Type: application/json' \
--header 'Accept: text/event-stream' \
--data ''

Copilot

Pull request overview

Adds a new Spring Boot example module demonstrating a “supervisor + subagents” personal assistant built on Spring AI Alibaba ReactAgent, including calendar/email tooling and a basic HITL (human-in-the-loop) approval flow.

Changes:

Introduces a new subagent-personal-assistant-example module with Supervisor/Calendar/Email agents and tool-callback implementations.
Adds a streaming REST endpoint to drive the supervisor agent and handle HITL interruptions/resume.
Adds module docs/config (README, application.yml, Maven module wiring).

Reviewed changes

Copilot reviewed 17 out of 17 changed files in this pull request and generated 14 comments.

Show a summary per file

File	Description
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/src/main/resources/application.yml	Adds Spring Boot + DashScope model configuration for the new example app.
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/SubAgentPersonalAssistantApplication.java	New Spring Boot entrypoint for the example module.
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/config/AgentConfig.java	Wires supervisor + subagents, tools, and HITL hook configuration.
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/controller/PersonalAssistantController.java	Exposes SSE endpoint for streaming agent output and HITL resume flow.
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/HITLHelper.java	Utility helpers to approve/reject/edit tool calls during HITL.
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/tool/UserDataTool.java	Tool to lookup users by username/department and return JSON-like results.
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/tool/SendEmailTool.java	Tool to validate and simulate sending outbound emails.
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/tool/DateTimeTools.java	Tool for returning the current date/time (currently returns date only).
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/tool/CreateCalendarEventTool.java	Tool to validate/simulate calendar event creation.
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/tool/AvailableTimeSlotsTool.java	Tool to validate input and return mocked available meeting slots.
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/model/UserInfo.java	DTO for user lookup tool input/output.
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/model/EmailInfo.java	DTO for email tool input.
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/model/CalendarInfo.java	DTO for calendar creation tool input.
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/model/AvailableTimeInfo.java	DTO for available time slots tool input.
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/README.md	Adds usage instructions, tool list, and example conversation.
spring-ai-alibaba-agent-example/subagent-personal-assistant-example/pom.xml	New module POM with Spring Boot + agent framework dependencies.
pom.xml	Adds the new example module to the root multi-module build.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-03-23T02:23:34Z

+        if (nodeId != null && TOOL_FEEDBACK_MAP.containsKey(nodeId)) {
+            System.out.println("人工介入开始...");
+            // Human intervention using checkpoint mechanism.
+            // You must provide a thread ID to associate execution with a session thread,
+            // so that conversations can be paused and resumed (required for human review).
+            InterruptionMetadata metadata = InterruptionMetadata.builder().toolFeedbacks(TOOL_FEEDBACK_MAP.get(nodeId)).build();
+            InterruptionMetadata approvalMetadata = HITLHelper.approveAll(metadata);
+            // Resume execution using approval decision
+            config = RunnableConfig.builder()
+                    .threadId(threadId) // Same thread ID
+                    .addHumanFeedback(approvalMetadata)
+                    .build();
+            TOOL_FEEDBACK_MAP.remove(nodeId);


When resuming from a HITL interruption you rebuild InterruptionMetadata with only toolFeedbacks; nodeId/state are not set, but HITLHelper.approveAll() copies node/state from the provided metadata. This likely produces feedback metadata with null nodeId/state and can break resume execution. Store the original InterruptionMetadata (or at least nodeId + state) in the map and use it when creating the approval metadata.

在println(NodeOutput nodeOutput) 方法中有存储元数据

Copilot · 2026-03-23T02:23:37Z

+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+/**
+ * @author wangjx
+ * @since 2026-02-13
+ */
+@SpringBootApplication
+public class SubAgentPersonalAssistantApplication {
+    public static void main(String[] args) {
+        SpringApplication.run(SubAgentPersonalAssistantApplication.class, args);
+    }


Other agent example modules include at least a basic @SpringBootTest contextLoads test, but this new module has no src/test at all (despite depending on spring-boot-starter-test). Adding a minimal context-load test would help catch wiring/config regressions (e.g., bean creation for supervisorAgent).

当前项目为使用示例，README.md中已提供使用方法，无需在提供 test用例

junxwang · 2026-03-30T01:41:04Z

@robocanic

robocanic · 2026-03-30T02:19:56Z

@robocanic

Working on it. Btw, can you provide the background of this PR and the verification means?

junxwang · 2026-03-30T03:18:51Z

@robocanic

正在努力。顺便问一下，你能介绍一下这个永久居民的背景和验证方式吗？

已更新

junxwang · 2026-04-22T02:47:52Z

@robocanic 您好，PR #449 已准备就绪，所有检查已通过，麻烦您有空时帮忙合并一下，谢谢！

wangjx and others added 8 commits February 11, 2026 23:18

feat: add subagent personal assistant

47d3f81

feat: add subagent personal assistant

2168b2c

Merge branch 'spring-ai-alibaba:main' into main

df52285

feat: add subagent personal assistant

889131b

Merge remote-tracking branch 'origin/main'

5b4fcfd

feat: add subagent personal assistant

31901c1

feat: add subagent personal assistant

8aff290

Merge branch 'spring-ai-alibaba:main' into main

457a96b

junxwang mentioned this pull request Mar 20, 2026

[Question] ReactAgent 流式中断恢复机制不完善：stream() 不支持恢复，invokeAndGetOutput() 非流式 alibaba/spring-ai-alibaba#4287

Closed

robocanic requested review from Copilot and robocanic March 23, 2026 02:18

Copilot started reviewing on behalf of robocanic March 23, 2026 02:19 View session

Copilot AI reviewed Mar 23, 2026

View reviewed changes

Fix the issues raised by Copilot.

17c0714

Merge branch 'main' into main

ddc63c9

Conversation

junxwang commented Mar 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this PR do?

背景

验证方法

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

junxwang Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

junxwang Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

junxwang commented Mar 30, 2026

Uh oh!

robocanic commented Mar 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

junxwang commented Mar 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

junxwang commented Apr 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

junxwang commented Mar 20, 2026 •

edited

Loading

robocanic commented Mar 30, 2026 •

edited

Loading

junxwang commented Mar 30, 2026 •

edited

Loading

junxwang commented Apr 22, 2026 •

edited

Loading