프로젝트 소개

AI Fabric Framework는 Java 21 및 Spring Boot 4.1.x 애플리케이션을 위한 오픈소스 AI 지원 및 오케스트레이션 계층으로, Apache 2.0 라이선스 하에 Maven Central에 게시되어 있습니다. 애플리케이션이 소유한 도메인 상태, 아이덴티티, 권한 부여를 대체하는 대신, 이러한 경계 주위에 AI 기능 계층을 추가합니다. LLM은 추론하고 제안할 수 있지만, 신뢰할 수 있는 애플리케이션 코드가 무엇을 보고 변경할 수 있는지 결정합니다. 핵심 기능은 다음과 같습니다. - 동기화된 벡터 증거와 함께 애노테이션 기반 엔티티 인덱싱을 통한 애플리케이션 데이터 시맨틱 검색 - 검색 컨텍스트와 구조화된 오케스트레이션 결과를 갖춘 증거 기반 RAG - 타입 지정 검색, 파라미터 추출, 확인 흐름을 갖춘 통제된 애플리케이션 액션 - 최근 턴, 고정 대상, 대기 중인 확인을 포함한 대화 메모리 - 프라이버시를 안전하게 보호하는 검색을 위한 PII 탐지 및 정제된 증거 - 이벤트 기반 신호로부터의 행동 인텔리전스 - 액세스 정책 훅과 메타데이터 필터링 벡터 공급자를 통한 테넌트 안전, 역할 인식 검색 - 벡터 저장소에 대한 실시간 엔티티 생성/업데이트/삭제 동기화 - 문서 수집(텍스트/JSON) 및 기존 데이터 백필/마이그레이션 - 선택적 다중 전문가 체인을 갖춘 제한된, 버전 관리되는 AI 전문가 실행 - OpenAI 및 로컬 ONNX 임베딩을 지원하는 공급자 추상화 - Lucene, 인메모리, Pinecone, Qdrant, Weaviate, Milvus에 대한 벡터 저장소 지원 - 기본, 커머스, 지원 시나리오를 위한 선별된 프롬프트 번들 이 프레임워크는 모듈식이며, 애플리케이션은 BOM을 통해 필요한 모듈만 가져옵니다. 커머스 RAG, 계정 해결, 행동 신호, 테넌트 가드, 프라이버시 차폐, 실시간 데이터 동기화를 다루는 실제 Spring Boot 데모 애플리케이션(모의 UI가 아님)과 함께 제공됩니다. 테스트는 계층화되어 있습니다. 결정적 단위 및 계약 테스트는 공급자 키 없이 실행되고, 스모크 프로필은 패키징된 런타임 동작을 검증하며, Docker/Testcontainers 제품군은 인프라 경계를 입증하고, 키 기반 제품군은 실제 LLM 및 벡터 통합을 실행합니다. 이 프로젝트는 시작 가이드, 대화형 코스, 아키텍처 문서, 코딩 어시스턴트 컨텍스트 팩, 프로덕션 체크리스트를 제공합니다. 현재 릴리스는 0.8.7이며, 버전 간 마이그레이션 지침이 문서화된 0.x 라인에 있습니다.