Public Buckets

Public Bucket이란?

Public bucket은 Schift가 운영하는 전역 공용 읽기 전용 인덱스입니다. 사전 인덱싱된 공공 데이터를 문서 업로드 없이 바로 검색할 수 있습니다.

Agent -> RAG({ bucket: "public--korean-law" }) -> hosted API -> 사전 인덱싱된 법령 데이터

사용 가능한 Public Bucket

Bucket ID	데이터 소스	범위
public--korean-law	korean-law-mcp	대한민국 법률, 판례, 행정규칙

사용법

일반 bucket과 동일하게 사용합니다. Public bucket ID만 넣으면 됩니다:

import { WorkspaceClient, RAG, Agent } from "@schift-io/sdk";

const client = new WorkspaceClient({ apiKey: "sch_..." });
const rag = new RAG(
  { bucket: "public--korean-law", topK: 5 },
  client.transport,
);

// 직접 검색
const results = await rag.search("근로기준법 출산휴가");

// 에이전트와 함께 사용
const agent = new Agent({
  name: "Legal Assistant",
  instructions: "한국 법률 질문에 답변하세요. 조문 번호를 인용하세요.",
  model: "gpt-4o-mini",
  transport: client.transport,
  rag,
});

const answer = await agent.run("출산휴가 기간이 어떻게 되나요?");

동작 원리

Public bucket은 lazy indexing 방식입니다:

1. 해당 법령이 이미 인덱싱되어 있으면: 즉시 벡터 검색 (sub-300us)
2. 아직 인덱싱되지 않았으면: 소스에서 가져와서 임베딩 후 인덱싱 후 반환
3. 다음 검색부터: 즉시 캐시 히트

주요 법령 30개 이상이 사전 인덱싱되어 있습니다.

과금

항목	부담
검색	유저 (Search 축)
인덱싱/저장	Schift (무료)
LLM (hosted routing)	유저 (LLM 축)
LLM (BYOK)	유저 (직접 부담)

빠른 시작

python3 -m pip install schift-cli
export SCHIFT_API_KEY=sch_...
export SCHIFT_API_URL=https://api.example.com/v1
schift search "근로기준법 출산휴가" --bucket public--korean-law --top-k 5

이 검색이 확인되면 위 SDK 예시로 같은 bucket을 에이전트에 연결하세요.