> ## Documentation Index
> Fetch the complete documentation index at: https://manual.seahorse.dnotitia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> API 문서·코드 레포·아키텍처 문서를 기반으로 개발자용 기술 에이전트 구축

# Tech docs rag

# 기술 문서 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)
```

***

## 페르소나별 역할

<Tabs>
  <Tab title="테크 리드">
    **역할**: 레퍼런스 문서·레포 큐레이션

    * 프로젝트별 Storage (`proj-api-gw`, `proj-frontend`, `platform-arch`)
    * OpenAPI·README·ADR(Architecture Decision Records)·변경 로그
    * 사용·금지 라이브러리 가이드, 코드 리뷰 체크리스트

    **사용 문서**:

    * [Storage 생성](/console/storage/storage-create)
    * [Support Extension 37종](/console/storage/storage-detail#support-extension-지원-확장자) — `.md`, `.json`, `.yaml` 전부 지원
  </Tab>

  <Tab title="플랫폼 엔지니어">
    **역할**: GitHub·DB·기타 MCP 연동

    * **GitHub MCP 템플릿** — 커밋·PR·이슈·코드 검색 (26 tools)
    * **PostgreSQL MCP** — 운영 DB 스키마 조회 (읽기 전용)
    * 내부 설계 위키(Confluence)가 있다면 **Atlassian MCP**

    **사용 문서**:

    * [GitHub MCP 템플릿](/console/agent-ops/agent-tool/templates/github)
    * [Atlassian MCP 템플릿](/console/agent-ops/agent-tool/templates/atlassian)
    * [PostgreSQL 템플릿](/console/agent-ops/agent-tool/templates/postgresql)
  </Tab>

  <Tab title="보안·라이선스 담당">
    **역할**: 외부 공개 금지 정보 · 라이선스 규정 관리

    * 내부 전용 Storage 는 **Reserved** / 권한 관리
    * System Prompt 에 "민감 코드·시크릿·고객 식별 정보 마스킹" 고정
    * 라이선스 충돌 체크용 문서(OSS 라이선스 가이드) 업로드

    **사용 문서**:

    * [API Keys — 최소 권한](/console/management/api-keys)
    * [Storage 자체 삭제 주의](/console/storage/storage-delete)
    * [System Admin → Events 감사](/internal/system-admin/operations/events)
  </Tab>

  <Tab title="개발자">
    **역할**: Agent Chat 에서 개발 질의

    **예시**:

    * "Users API 의 POST 요청 curl 예시 주고, 필수 파라미터 설명해줘"
    * "이번 주 main 브랜치 merge 된 PR 요약해줘" (GitHub MCP)
    * "우리 프론트엔드에서 React 19 로 올리려는데 breaking change 영향 있을지 확인해줘"
    * "이 에러 로그 `NullPointerException at UserService.java:42` 관련 코드 찾아줘"

    출처 검증: Tool Call 카드에서 실제 참조한 파일·라인 확인.

    **사용 문서**:

    * [GitHub PR 리뷰 요약 레시피](/agent-chat/recipes/github-pr-review)
    * [Tool Call 읽기](/agent-chat/ui/tool-call)
  </Tab>
</Tabs>

## Console 구성 단계

<Steps>
  <Step title="Storage 분류·업로드">
    프로젝트별 Storage. 민감 레포는 별도 Storage 로 접근 분리.
  </Step>

  <Step title="GitHub MCP 등록">
    * [Tool Management → 도구 생성 → GitHub 템플릿](/console/agent-ops/agent-tool/templates/github)
    * 환경변수 `GITHUB_PERSONAL_ACCESS_TOKEN` — 최소 권한 PAT (`repo:status`, `public_repo` 등)
  </Step>

  <Step title="(선택) Atlassian · PostgreSQL MCP">
    사내 Confluence·운영 DB 조회 필요 시 추가 등록.
  </Step>

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

  <Step title="Agent 생성">
    * 모델: `claude-opus-4.5` (복잡 추론) / 경량 질의는 `gpt-5.2`
    * 테이블: 프로젝트 Storage Table 연결
    * 도구: GitHub, (선택) Atlassian, PostgreSQL
    * 시스템 프롬프트: 위 프롬프트 적용
  </Step>

  <Step title="배포 + 개발 팀 공지">
    * 배포 URL 공유 + 예시 프롬프트 5\~10 개 정리
    * Slack 봇 연동 ([Slack 알림 레시피](/agent-chat/recipes/slack-notification)) 로 리뷰 자동화
  </Step>
</Steps>

## 체크리스트

* [ ] OpenAPI·README 등 최신 버전 업로드
* [ ] GitHub PAT 최소 권한 (read-only 권장)
* [ ] System Prompt 에 시크릿 마스킹·출처 필수
* [ ] 민감 레포 Storage 는 별도 권한 분리
* [ ] 코드 예시 컨벤션 명시 (언어 버전·프레임워크)

## 관련 문서

* [Console 활용 가이드 목록](/console/guides)
* [GitHub PR 리뷰 요약 레시피](/agent-chat/recipes/github-pr-review)
* [PostgreSQL 자동화 레시피](/agent-chat/recipes/postgres-sql-automation)
* [GitHub MCP 템플릿](/console/agent-ops/agent-tool/templates/github)