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

...src/main/java/com/cloud/alibaba/ai/example/agent/controller/PersonalAssistantController.java

+        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) 方法中有存储元数据

...l-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/tool/SendEmailTool.java

...t-example/src/main/java/com/cloud/alibaba/ai/example/agent/tool/CreateCalendarEventTool.java

...l-assistant-example/src/main/java/com/cloud/alibaba/ai/example/agent/tool/DateTimeTools.java

spring-ai-alibaba-agent-example/subagent-personal-assistant-example/README.md

pom.xml

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

...e/src/main/java/com/cloud/alibaba/ai/example/agent/SubAgentPersonalAssistantApplication.java

+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用例

...src/main/java/com/cloud/alibaba/ai/example/agent/controller/PersonalAssistantController.java

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

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

已更新

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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

add subagent personal assistant#449

add subagent personal assistant#449
junxwang wants to merge 9 commits intospring-ai-alibaba:mainfrom
junxwang:main

junxwang commented Mar 20, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Mar 23, 2026

Uh oh!

junxwang Mar 23, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Mar 23, 2026

Uh oh!

junxwang Mar 23, 2026

Uh oh!

Uh oh!

junxwang commented Mar 30, 2026

Uh oh!

robocanic commented Mar 30, 2026 •

edited

Loading

Uh oh!

junxwang commented Mar 30, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

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!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

junxwang commented Mar 20, 2026 •

edited

Loading

robocanic commented Mar 30, 2026 •

edited

Loading

junxwang commented Mar 30, 2026 •

edited

Loading