baem1n/rag-agent
06_examples/skills/rag-agent/SKILL.md
RAG(Retrieval-Augmented Generation) 에이전트 구축 가이드. 벡터 스토어 검색, 문서 청킹, content_and_artifact 패턴을 다룹니다.
$ install --global
skillsauthnpx skillsauth add baem1n/langchain-langgraph-deepagents-notebooks rag-agentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 3, 2026, 7:51 PM175.0s1 file scanned
SKILL.md
- name:
- rag-agent
- description:
- >
- license:
- MIT
- compatibility:
- Python 3.12+
- category:
- rag
- difficulty:
- intermediate
- allowed-tools:
- retrieve
RAG Agent 스킬
사용 시기
- 사용자가 문서 기반 질의응답 시스템을 구축할 때
- 벡터 스토어에서 관련 문서를 검색하고 답변을 생성할 때
- RAG 파이프라인의 검색 품질을 개선할 때
워크플로
- 문서 준비: 원본 문서를 RecursiveCharacterTextSplitter로 청킹
- 임베딩 & 저장: OpenAIEmbeddings → InMemoryVectorStore (또는 FAISS, Chroma)
- 검색 도구 정의:
@tool(response_format="content_and_artifact")패턴 사용 - 에이전트 생성:
create_deep_agent(tools=[retrieve])— 검색 도구 전달 - 질의 & 검증: 단순 질의 → 비교 질의 → 출처 확인
핵심 패턴
content_and_artifact 반환
@tool(response_format="content_and_artifact")
def retrieve(query: str):
"""벡터 스토어에서 관련 문서를 검색합니다."""
results = vectorstore.similarity_search(query, k=3)
content = "\n\n".join(d.page_content for d in results)
return content, results # (요약 텍스트, 원본 객체)
청킹 전략
| 파라미터 | 권장값 | 이유 |
|---------|--------|------|
| chunk_size | 1000 | 충분한 컨텍스트 유지 |
| chunk_overlap | 200 | 문맥 연결 보장 |
| separators | ["\n\n", "\n", " "] | 자연스러운 경계 |
안전 규칙
- 검색된 문서에 없는 내용은 추측하지 않는다
- 출처(문서 제목, 페이지)를 반드시 명시한다
- 검색 결과가 부족하면 사용자에게 알린다
Related Skills
baem1n/sql-agent
tools
VerifiedTrustedCommunity
자연어 SQL 질의 에이전트 가이드. SQLDatabaseToolkit 활용, READ-ONLY 안전 규칙, HITL 승인 패턴을 다룹니다.
47SKILL.mdUpdated Apr 3, 2026
baem1n/ml-pipeline
devops
VerifiedTrustedCommunity
머신러닝 파이프라인 에이전트 가이드. sklearn 기반 모델 비교, 교차 검증, 서브에이전트 위임 패턴을 다룹니다.
47SKILL.mdUpdated Apr 3, 2026
baem1n/deep-research
tools
VerifiedTrustedCommunity
박사급 딥 리서치 에이전트 가이드. 병렬 서브에이전트 위임, think_tool 반성, 5단계 워크플로를 다룹니다.
47SKILL.mdUpdated Apr 3, 2026
baem1n/data-analysis
development
VerifiedTrustedCommunity
데이터 분석 에이전트 가이드. LocalShellBackend로 pandas 코드를 실행하고, 멀티턴 분석을 수행합니다.
47SKILL.mdUpdated Apr 3, 2026