기술 문서 RAG 시나리오
목표: API 명세·README·아키텍처 문서·Swagger/OpenAPI·코드 스니펫을 Seahorse Storage 에 올려, 개발자가 Agent Chat 에서 “이 API 의 요청 예시 줘”, “라이선스 충돌 검사해줘” 같은 자연어 질의로 답을 받는 개발자 지원 에이전트 를 구성합니다. GitHub MCP 로 레포 실시간 조회까지.
구성 요약
페르소나별 역할
- 테크 리드
- 플랫폼 엔지니어
- 보안·라이선스 담당
- 개발자
역할: 레퍼런스 문서·레포 큐레이션
- 프로젝트별 Storage (
proj-api-gw,proj-frontend,platform-arch) - OpenAPI·README·ADR(Architecture Decision Records)·변경 로그
- 사용·금지 라이브러리 가이드, 코드 리뷰 체크리스트
- Storage 생성
- Support Extension 37종 —
.md,.json,.yaml전부 지원
Console 구성 단계
1
Storage 분류·업로드
프로젝트별 Storage. 민감 레포는 별도 Storage 로 접근 분리.
2
GitHub MCP 등록
- Tool Management → 도구 생성 → GitHub 템플릿
- 환경변수
GITHUB_PERSONAL_ACCESS_TOKEN— 최소 권한 PAT (repo:status,public_repo등)
3
(선택) Atlassian · PostgreSQL MCP
사내 Confluence·운영 DB 조회 필요 시 추가 등록.
4
System Prompt (개발자 페르소나)
5
Agent 생성
- 모델:
claude-opus-4.5(복잡 추론) / 경량 질의는gpt-5.2 - 테이블: 프로젝트 Storage Table 연결
- 도구: GitHub, (선택) Atlassian, PostgreSQL
- 시스템 프롬프트: 위 프롬프트 적용
6
배포 + 개발 팀 공지
- 배포 URL 공유 + 예시 프롬프트 5~10 개 정리
- Slack 봇 연동 (Slack 알림 레시피) 로 리뷰 자동화
체크리스트
- OpenAPI·README 등 최신 버전 업로드
- GitHub PAT 최소 권한 (read-only 권장)
- System Prompt 에 시크릿 마스킹·출처 필수
- 민감 레포 Storage 는 별도 권한 분리
- 코드 예시 컨벤션 명시 (언어 버전·프레임워크)