Annotations API Reference

/**
 * DEPRECATED: Use @ImportAutoConfiguration(AgentPlatformAutoConfiguration.class)
 *
 * Enabled agent framework with auto-configuration.
 * Triggers profile activation via EnvironmentPostProcessor.
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@Deprecated(since = "0.3.1", forRemoval = true)
public @interface EnableAgents {

    /**
     * Logging theme (sets embabel.agent.logging.personality property).
     *
     * Values: "starwars", "severance", "colossus", "hitchhiker", "montypython", ""
     * Default: ""
     */
    String loggingTheme() default "";

    /**
     * MCP servers to enable (deprecated functionality).
     *
     * Use spring.ai.mcp.client.* properties instead.
     */
    String[] mcpServers() default {};
}

// Old (deprecated)
@EnableAgents(loggingTheme = LoggingThemes.STAR_WARS)
public class OldApp { }

// New (recommended)
@ImportAutoConfiguration(AgentPlatformAutoConfiguration.class)
public class NewApp { }

embabel.agent.logging.personality=starwars

/**
 * Constants for logging theme values.
 */
public class LoggingThemes {
    public static final String STAR_WARS = "starwars";
    public static final String SEVERANCE = "severance";
    public static final String COLOSSUS = "colossus";
    public static final String HITCHHIKERS_GUIDE = "hitchhiker";
    public static final String MONTYPYTHON = "montypython";
}

// With property
@Value("${embabel.agent.logging.personality:}")
private String theme;

public boolean isStarWars() {
    return LoggingThemes.STAR_WARS.equals(theme);
}

/**
 * Configuration properties for logging personality.
 * Prefix: embabel.agent.logging
 */
@ConfigurationProperties(prefix = "embabel.agent.logging")
record LoggingPersonalityProperties(String personality) {}

@Autowired
private LoggingPersonalityProperties loggingProps;

public String getTheme() {
    return loggingProps.personality();
}

/**
 * DEPRECATED: Use Spring AI MCP client properties.
 */
@Deprecated(since = "0.3.1", forRemoval = true)
public class McpServers {
    public static final String DOCKER = "docker-ce";
    public static final String DOCKER_DESKTOP = "docker-desktop";
}