AI API

AI 기반 데이터 인텔리전스 API 그룹입니다. Text-to-SQL, 벡터 검색, RAG, 스키마 동기화, 문서 처리, 용어집 관리 기능을 제공합니다.

API 목록

API	경로	설명
Ask	POST /api/v1/ai/ask	자연어를 SQL로 변환
Ask + Execute	POST /api/v1/ai/ask/execute	SQL 변환 후 즉시 실행
AI Search	/api/v1/ai/search	벡터/전문 통합 검색
RAG	/api/v1/rag	문서 기반 질의응답
Schema Sync	POST /api/v1/ai/schema/sync	스키마 인덱스 동기화
Schema Graph	GET /api/v1/ai/schema/graph	스키마 그래프 조회

공통 사항

• 모든 AI API는 JWT Bearer 토큰 인증이 필요합니다.
• AI 제공자(OpenAI, Claude 등) 설정은 서버 환경변수로 구성됩니다.
• 벡터 검색은 Weaviate, Milvus, Elasticsearch 백엔드를 지원합니다.
• 용어집 관리(/api/v1/ai/glossary)를 통해 도메인 용어를 등록하면 Text-to-SQL 정확도가 향상됩니다.

추가 엔드포인트

• POST /api/v1/ai/explain - SQL 설명 생성
• POST /api/v1/ai/documents/upload - AI용 문서 업로드
• GET /api/v1/ai/documents - 업로드된 문서 목록
• POST /api/v1/ai/glossary - 용어 등록
• GET /api/v1/ai/glossary - 용어 목록
• GET /api/v1/ai/glossary/{term} - 용어 조회
• PUT /api/v1/ai/glossary/{term} - 용어 수정
• DELETE /api/v1/ai/glossary/{term} - 용어 삭제