지식 베이스
지식 베이스 생성, 문서 관리, RAG 검색
개요
지식 베이스 엔드포인트는 문서 수집, 인덱싱, 하이브리드 RAG(검색 증강 생성) 검색을 처리합니다. 지식 베이스는 시맨틱 검색과 컨텍스트 기반 응답을 가능하게 합니다. 모든 엔드포인트는 인증이 필요합니다.
기본 URL:
지식 베이스 관리
GET /api/knowledge
모든 지식 베이스 목록을 조회합니다.
모든 지식 베이스 목록을 가져옵니다.
응답 200
[
{
"id": "kb-uuid",
"name": "Company Policies",
"description": "Internal policy documents",
"file_count": 5,
"created_at": 1700000000,
"updated_at": 1700010000
}
]POST /api/knowledge/create
새 지식 베이스를 생성합니다.
새 지식 베이스를 생성합니다.
요청 본문
{
"name": "Company Policies",
"description": "Internal policy documents"
}응답 200
{
"id": "kb-uuid",
"name": "Company Policies",
"description": "Internal policy documents",
"file_count": 0,
"created_at": 1700000000,
"updated_at": 1700000000
}GET /api/v1/knowledge/{id}
ID로 특정 지식 베이스를 파일 목록과 함께 가져옵니다.
파일 목록과 함께 특정 지식 베이스를 가져옵니다.
경로 파라미터
| 이름 | 타입 | 설명 |
|---|---|---|
id | string | 지식 베이스 UUID |
응답 200
{
"id": "kb-uuid",
"name": "Company Policies",
"description": "Internal policy documents",
"files": [
{
"id": "file-uuid",
"name": "hr-handbook.pdf",
"status": "completed",
"created_at": 1700000000
}
],
"created_at": 1700000000,
"updated_at": 1700010000
}POST /api/knowledge/{id}/update
지식 베이스의 메타데이터를 업데이트합니다.
지식 베이스 메타데이터를 업데이트합니다.
경로 파라미터
| 이름 | 타입 | 설명 |
|---|---|---|
id | string | 지식 베이스 UUID |
요청 본문
{
"name": "Updated Name",
"description": "Updated description"
}응답 200
업데이트된 지식 베이스 객체.
DELETE /api/knowledge/{id}/delete
지식 베이스를 삭제합니다.
지식 베이스를 삭제합니다.
경로 파라미터
| 이름 | 타입 | 설명 |
|---|---|---|
id | string | 지식 베이스 UUID |
응답 200
{ "success": true }GET /api/v1/knowledge/{id}/export
지식 베이스를 ZIP 파일로 내보냅니다.
지식 베이스를 ZIP 파일로 내보냅니다.
경로 파라미터
| 이름 | 타입 | 설명 |
|---|---|---|
id | string | 지식 베이스 UUID |
응답 200
Content-Type: application/zip 및 Content-Disposition: attachment 가 포함된 바이너리 ZIP 파일.
파일 관리
POST /api/knowledge/{id}/file/add
지식 베이스에 파일을 추가합니다.
지식 베이스에 파일을 추가합니다.
경로 파라미터
| 이름 | 타입 | 설명 |
|---|---|---|
id | string | 지식 베이스 UUID |
요청 본문
{
"file_id": "file-uuid"
}응답 200
파일 목록이 포함된 업데이트된 지식 베이스 객체.
POST /api/knowledge/{id}/file/remove
지식 베이스에서 파일을 제거합니다.
지식 베이스에서 파일을 제거합니다.
경로 파라미터
| 이름 | 타입 | 설명 |
|---|---|---|
id | string | 지식 베이스 UUID |
요청 본문
{
"file_id": "file-uuid"
}응답 200
업데이트된 지식 베이스 객체.
지식 그래프
GET /api/v1/knowledge/{id}/graph/status
지식 그래프의 빌드 상태를 가져옵니다. JSON 및 SSE 스트리밍을 모두 지원합니다.
지식 그래프 빌드 상태를 가져옵니다.
경로 파라미터
| 이름 | 타입 | 설명 |
|---|---|---|
id | string | 지식 베이스 UUID |
쿼리 파라미터
| 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|
stream | string | "false" | SSE 스트림을 위해 `"true"` 로 설정 |
token | string | — | JWT 토큰 (헤더 없이 EventSource 사용 시) |
응답 200 (stream=false)
{
"status": "building",
"progress": 0.45
}GET /api/v1/knowledge/{id}/graph/visualize
지식 그래프의 HTML 시각화를 가져옵니다.
지식 그래프의 HTML 시각화를 가져옵니다.
경로 파라미터
| 이름 | 타입 | 설명 |
|---|---|---|
id | string | 지식 베이스 UUID |
응답 200
그래프 시각화가 포함된 HTML 문서.
POST /api/knowledge/{id}/graph/toggle
이 지식 베이스의 지식 그래프 인덱싱을 켜거나 끕니다.
지식 그래프 인덱싱을 토글합니다.
경로 파라미터
| 이름 | 타입 | 설명 |
|---|---|---|
id | string | 지식 베이스 UUID |
요청 본문
{
"enabled": true
}응답 200
{
"status": "success",
"message": "Graph indexing toggled"
}