surreal-surge은(는) 무엇을 하나요?
SurrealDB 3 Agent Toolkit 2026 – SurrealQL 및 벡터 검색을 사용한 멀티모델 AI 앱 구축
개요
이 툴킷은 AI 에이전트가 SurrealDB 3와 상호작용할 수 있는 기능을 제공합니다. 문서, 그래프, 관계형 데이터를 단일 데이터베이스에서 처리하고, AI 기능을 위한 벡터 검색을 지원합니다.
기능
- 멀티모델 데이터 지원: 문서, 그래프, 테이블을 단일 쿼리로 조작
- SurrealQL 지원: 강력하고 표현력 있는 쿼리 언어
- 벡터 검색: 임베딩 기반 시맨틱 검색 및 RAG 파이프라인
- 스키마 유연성: 동적 스키마 또는 엄격한 스키마 정의 가능
- AI 에이전트 통합: Claude Code, Cursor, Codex와 같은 플랫폼에서 사용 가능
시작하기
필수 조건
- SurrealDB 3 인스턴스 (로컬 또는 Surreal Cloud)
- SurrealDB 연결 자격 증명
- AI 에이전트 환경 (Claude Code, Cursor, Codex 등)
설치
- 이 저장소를 클론하거나 스킬을 에이전트에 추가하세요.
- 다음 환경 변수를 설정하세요:
export SURREALDB_URL="http://localhost:8000/rpc"
export SURREALDB_NAMESPACE="your_namespace"
export SURREALDB_DATABASE="your_database"
export SURREALDB_USERNAME="root"
export SURREALDB_PASSWORD="root"
SurrealDB에 연결
다음 엔드포인트를 사용하여 데이터베이스에 연결합니다:
- URL:
SURREALDB_URL(예:http://localhost:8000/rpc) - 네임스페이스:
SURREALDB_NAMESPACE - 데이터베이스:
SURREALDB_DATABASE
사용 예시
레코드 생성
CREATE person CONTENT {
name: 'Alice',
email: '[email protected]',
age: 30
};
레코드 쿼리
SELECT * FROM person WHERE age > 25;
벡터 검색
-- 벡터 인덱스 생성
DEFINE INDEX vector_idx ON TABLE articles FIELDS embedding MACHINE LEARNING;
-- 의미 검색 수행
SELECT *, vector::similarity::cosine(embedding, [0.1, 0.2, ...]) AS sim
FROM articles
ORDER BY sim DESC
LIMIT 5;
구성
스킬은 환경 변수를 통해 구성됩니다. 자세한 내용은 위의 '시작하기' 섹션을 참조하세요.
기여하기
기여를 환영합니다! 풀 리퀘스트를 제출하거나 이슈를 열어주세요.
라이선스
이 프로젝트는 MIT 라이선스 하에 제공됩니다.
이 스킬은 SurrealDB 3 Agent Toolkit 2026의 일부입니다.