studio-one-ai-starter는Spring Boot 애플리케이션에서AI(Chat, Embedding, Vector Store, RAG 등)기능을 👉설정만으로 활성화하고 👉구현체(OpenAI, Gemini, 내부 모델 등)를 코드에서 분리하기 위해 제공된다.

5.1 시작하기

5.1.1 의존성 추가

studio-one-ai-starter 를 의존성에 추가하면 쉽게 사용할 수 있다.

dependencies {
    implementation("studio.one.starter:studio-platform-starter")
    implementation("studio.one.starter:studio-platform-starter-user")
    implementation("studio.one.starter:studio-platform-starter-security")
    ****implementation("studio.one.starter:studio-platform-starter-ai")
}

5.1.2 활성화 하기

studio.ai.* 속성으로 활성화와 동작을 제어한다(기본값은 주석 참고).

5.1.2.1 기능 활성화

studio:
  ai:
    enabled: true

enabled가 false면 Template 관련 Bean/Controller가 생성되지 않는다.

이 플래그가 false면:

• 모든 AI 관련 빈이 등록되지 않음
• 애플리케이션은 AI 기능을 전혀 모르는 상태로 동작

5.1.2.2 REST API

studio.ai.endpoints.enabled 설정을 통하여 사용 여부를 선택할 수 있다. 기본값을 false 이다.

studio:
	ai:
		endpoints:
			enabled: true
			base-path: /api/ai

5.1.2.3 LLM(Provider) 정보 추가

studio.ai.providers.[프로파이더 이름].* 기준으로 핵심은:

• enabled: AI 모듈 전체 활성화
• defaultProvider: 기본 Provider 선택
• providers: Provider 여러 개 등록 가능 (key가 provider name)
• Provider별로 type, apiKey, baseUrl, chat, embedding 설정
• endpoints.basePath: /api/ai 기본값 변경 가능