시작하기

권장 사전 준비

• Java 17+
• Gradle wrapper 실행 환경
• 로컬 파일 시스템에 색인 디렉터리를 둘 수 있는 애플리케이션

선택 개발 도구

• OpenAI 같은 외부 provider 키
• ONNX reranker를 위한 로컬 모델
• Dokka 문서를 확인할 브라우저

1. starter 의존성 추가

implementation("com.ainsoft.rag:ainsoft-rag-spring-boot-starter:0.1.0")

2. 최소 설정 추가

rag:
  indexPath: ./rag-index
  embeddingProvider: hash
  chunkerType: basic

3. 애플리케이션에서 RagEngine 주입

class SampleController(
    private val ragEngine: RagEngine
)

4. 관리 UI 확인

• UI: /rag-admin
• API: /api/rag/admin

5. API 문서 생성

cd ../ainsoft-rag-engine && ./gradlew docs
cd ../ainsoft-rag-spring-boot-autoconfigure && ./gradlew docs
cd ../ainsoft-rag-spring-boot-starter && ./gradlew docs

Day 1

• starter를 추가하고 기본 설정을 넣습니다.
• 제품 개요를 읽습니다.

Day 2

• 검색과 색인을 따라 ingest/search 흐름을 검증합니다.

Day 3

• Spring Boot 통합과 Admin UI를 보며 /rag-admin를 확인합니다.

Day 4+

• 보안과 테넌시와 API 참조를 검토합니다.