Skip to main content

​
기술 문서 RAG 시나리오

목표: API 명세·README·아키텍처 문서·Swagger/OpenAPI·코드 스니펫을 Seahorse Storage 에 올려, 개발자가 Agent Chat 에서 “이 API 의 요청 예시 줘”, “라이선스 충돌 검사해줘” 같은 자연어 질의로 답을 받는 개발자 지원 에이전트 를 구성합니다. GitHub MCP 로 레포 실시간 조회까지.

​
구성 요약

[OpenAPI YAML/JSON · README.md · 아키텍처 PDF]
          │                   [GitHub Repo]
          ▼ 업로드              │ MCP
     Storage (프로젝트별)       │
          │ 자동 임베딩              │
     Table (벡터)               │
          └────┬───────────────┘
               ▼
        Agent (개발자 지원)
               │
          Agent Chat (개발자)
               ▼
    "user endpoint 호출 예시 curl 줘"
    "이번 PR 요약 + 잠재 버그" (GitHub MCP)

​
페르소나별 역할

역할: 레퍼런스 문서·레포 큐레이션
  • 프로젝트별 Storage (proj-api-gw, proj-frontend, platform-arch)
  • OpenAPI·README·ADR(Architecture Decision Records)·변경 로그
  • 사용·금지 라이브러리 가이드, 코드 리뷰 체크리스트
사용 문서:

​
Console 구성 단계

1

Storage 분류·업로드

프로젝트별 Storage. 민감 레포는 별도 Storage 로 접근 분리.
2

GitHub MCP 등록

3

(선택) Atlassian · PostgreSQL MCP

사내 Confluence·운영 DB 조회 필요 시 추가 등록.
4

System Prompt (개발자 페르소나)

당신은 시니어 개발자 지원 어시스턴트입니다.
- 코드 예시를 제공할 땐 실제 프로젝트의 컨벤션(언어·버전·프레임워크)을 따릅니다.
- API 질의엔 path·method·필수 파라미터·요청/응답 예시를 JSON 또는 curl 로 제공합니다.
- 시크릿·토큰·고객 PII 가 코드에 포함되어 있으면 마스킹 후 안내합니다.
- 불확실하면 "레포·문서에서 찾지 못함, 확인 필요" 로 답하고 추측 금지.
- 출처 파일/라인/URL 을 명시합니다.
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 는 별도 권한 분리
  • 코드 예시 컨벤션 명시 (언어 버전·프레임워크)

​
관련 문서