Spring AI 子代理协调指南

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.ai</groupId>
        <artifactId>spring-ai-starter-model-openai</artifactId>
        <version>2.0.0-M5</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>org.springaicommunity</groupId>
        <artifactId>spring-ai-agent-utils</artifactId>
        <version>0.4.2</version>
    </dependency>
</dependencies>

spring.ai.openai.api-key=${OPENAI_API_KEY}
spring.ai.openai.chat.options.model=gpt-4.1-mini
spring.application.name=spring-ai-subagent
agent.tasks.paths=classpath:/agents/*.md

---
name: code-reviewer
description: >
  专业代码审查员。在编写或修改代码后主动使用，以发现质量、安全和可读性问题。
tools: Read, Grep, Glob
disallowedTools: Edit, Write
model: sonnet
---
你是一位资深代码审查员，专精于软件质量。
**调用时：**
1. 运行 `git diff` 以识别最近的更改
2. 检查修改过的文件及其上下文
3. 检查以下领域的问题
**检查清单：**
- 代码清晰度和可读性
- 适当的命名约定
- 错误处理和边界情况
- 安全漏洞
**输出：** 按文件组织的清晰、可操作的反馈，附带行号引用。

---
name: documentation-writer
description: >
  技术文档专家，负责架构说明、工作流总结和简洁的开发人员文档。
model: default
---
你是一位资深技术文档专家。
你的职责：
- 生成简洁的技术文档
- 解释 Spring Boot 和 Java 应用程序架构
- 清晰地总结工作流
- 提供对开发者友好的解释
- 保持文档简洁且技术准确

@Configuration
public class AgentConfig {
    @Value("${agent.tasks.paths}")
    private List<Resource> agentPaths;

    @Bean
    @Primary
    public ChatClient orchestratorChatClient(ChatClient.Builder chatClientBuilder) {
        SubagentType claudeType = ClaudeSubagentType.builder()
          .chatClientBuilder("default", chatClientBuilder.clone())
          .build();
        ToolCallback taskTool = TaskTool.builder()
          .subagentReferences(ClaudeSubagentReferences.fromResources(agentPaths))
          .subagentTypes(claudeType)
          .build();
        return chatClientBuilder.clone()
          .defaultToolCallbacks(taskTool)
          .build();
    }
}

@Service
public class OrchestratorService {
    private final ChatClient chatClient;

    public OrchestratorService(ChatClient chatClient) {
        this.chatClient = chatClient;
    }

    public String ask(String userMessage) {
        return chatClient.prompt(userMessage).call().content();
    }
}

public class SpringAiSubagentApplication {
    private static final Logger logger = LoggerFactory.getLogger(SpringAiSubagentApplication.class);

    public static void main(String[] args) {
        SpringApplication.run(SpringAiSubagentApplication.class, args);
    }

    @Bean
    CommandLineRunner demo(OrchestratorService orchestratorService) {
        return args -> {
            String response = orchestratorService.ask(
              """
              执行以下任务：
              - 审查代码质量。
              - 生成简洁的技术文档，如用户指南。
              """
            );
            logger.info("{}", response);
        };
    }
}

@Test
void givenSubagentDefinitions_whenLoadingSubagents_thenReferencesAreCreated() {
    var references = ClaudeSubagentReferences.fromResources(agentPaths);
    assertThat(references).isNotNull();
}

@Test
void givenPrompt_whenExecutingOrchestration_thenResponseIsGenerated() {
    List<Resource> agentResources = List.of(
      new ClassPathResource("agents/test-agent.md")
    );
    SubagentType claudeType = ClaudeSubagentType.builder()
      .chatClientBuilder("default", chatClientBuilder.clone())
      .build();
    ToolCallback taskTool = TaskTool.builder()
      .subagentReferences(ClaudeSubagentReferences.fromResources(agentResources))
      .subagentTypes(claudeType)
      .build();
    ChatClient chatClient = chatClientBuilder.clone()
      .defaultToolCallbacks(taskTool)
      .build();
    String result = chatClient.prompt("解释身份验证模块如何工作。")
      .call()
      .content();
    assertThat(result).isNotBlank();
    assertThat(result).contains("authentication");
}