核心库集成

如果你正在维护一个传统的 Spring Framework 项目（非 Spring Boot），或者你需要对 saa-graph-composer 进行更底层的控制，你可以直接集成核心库。

与 Starter 不同，核心库不包含自动配置机制，你需要显式地启用功能。

1. 引入依赖

仅引入核心库，不包含 Spring Boot 相关的依赖。

Maven

<dependency>
    <groupId>cn.teacy.ai</groupId>
    <artifactId>saa-graph-composer</artifactId>
    <version>0.3.0</version>
</dependency>

Gradle

implementation 'cn.teacy.ai:saa-graph-composer:0.3.0'

2. 显式启用

在你的 Spring 配置类（标注了 @Configuration 的类）上，必须添加 @EnableGraphComposer 注解。 这是核心库工作的开关，它负责注册 GraphAutoRegistrar 以处理图的扫描与编译。

ExampleConfig.java↗

@Configuration
@ComponentScan("cn.teacy.ai.examples")
@EnableGraphComposer(basePackages = "cn.teacy.ai.examples")
public class ExampleConfig {

}

3. 运行与调用

在非 Spring Boot 环境下，你需要使用 AnnotationConfigApplicationContext 或 ClassPathXmlApplicationContext 来启动 Spring 容器。

启动后，你可以像获取普通 Bean 一样获取编译好的 CompiledGraph。

ExamplesMainApplication.java↗

CompiledGraph graph = context.getBean(CompiledGraph.class);
graph.invoke(Map.of(KEY_INPUT, "alice")).ifPresent(it ->
        System.out.println(it.value(KEY_OUTPUT, "world"))
);

4. 手动配置 (进阶)

如果你不希望使用 @EnableGraphComposer 的自动扫描机制，或者你需要自定义 GraphCompiler 的行为（例如传入特殊的 ClassLoader 或自定义 Bean 获取逻辑），你可以选择手动定义 Bean。

只需在配置类中注册一个 GraphCompiler 类型的 Bean 即可。

ManualExampleConfig.java↗

@Configuration
// 不再需要 @EnableGraphComposer
@ComponentScan("cn.teacy.ai.examples")
public class ManualExampleConfig {

    @Bean
    public GraphCompiler graphCompiler(ApplicationContext applicationContext) {
        return new SpringReflectiveGraphCompiler(applicationContext);
    }

}

一旦 GraphCompiler Bean 存在于容器中，你可以手动触发编译，或者监听 Spring 的 ContextRefreshedEvent 事件来处理图的注册。但在大多数场景下，使用 @EnableGraphComposer 是最简单且推荐的方式。

ManualExampleMainApplication.java↗

GraphCompiler compiler = context.getBean(GraphCompiler.class);
GreetingGraphComposer composer = context.getBean(GreetingGraphComposer.class);

CompiledGraph graph = compiler.compile(composer);
graph.invoke(Map.of(KEY_INPUT, "bob")).ifPresent(it ->
        System.out.println(it.value(KEY_OUTPUT, "world"))
);