템플릿: Legal Assistant

개요

이 가이드는 public bucket을 활용해 대한민국 법령, 판례, 행정규칙을 검색하는 Q&A 에이전트 구조를 보여줍니다.

법령 데이터는 따로 업로드하지 않아도 됩니다. 먼저 검색을 확인한 뒤, 같은 bucket을 앱이나 에이전트에 연결하세요.

빠른 시작

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

public--korean-law
1. 근로기준법 제74조 ...
2. 근로기준법 시행령 ...

최소 에이전트 구조

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

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

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

LLM 설정

hosted model route 또는 OpenAI-compatible provider를 사용할 수 있습니다:

방식	설정
OpenRouter (무료, 기본)	변경 불필요
OpenRouter (유료)	.env.local에 LLM_API_KEY 설정
hosted routing	워크스페이스 API transport 사용
Ollama (로컬)	baseUrl을 http://localhost:11434/v1로 변경

커스터마이징

• 사내 문서를 private bucket에 업로드해서 법령과 교차 검색
• instructions를 노동법, 세법, 부동산법 등으로 특화
• 웹 검색 추가로 최신 법률 뉴스 참조
• CLI 대신 웹 UI 구축

요구사항

• Node.js 18+
• 워크스페이스 API 키 (SCHIFT_API_KEY)

Legacy 템플릿 안내

기존 create-schift legal-assistant starter는 제거되었습니다. 새 프로젝트는 위 CLI/API 확인 경로나 대시보드 APM/workspace-pack 흐름에서 시작하세요.