> ## 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.

> 고객관계관리(CRM) 데이터·내부 문서를 벡터화해 사내 질의응답 에이전트 구축 — 4개 페르소나 E2E 시나리오

# Crm internal

# CRM 내부 구축 시나리오

> **목표**: 고객 데이터(엑셀·워드)와 관리 지침 문서를 **Seahorse Storage**에 올리고, 회사 CRM 데이터베이스(PostgreSQL 등)와도 **API 로 연결** 하여, 직원이 **Agent Chat**에서 "이번 주 주요 계약 건 알려줘" 같은 자연어 질의로 답을 받는 사내 RAG 에이전트를 구성합니다.

## 구성 요약

```
[엑셀/워드 문서]                  [회사 PostgreSQL CRM DB]
     │                                     │
     ▼  업로드                             ▼  MCP 도구 등록
  Storage (스토리지 자동 임베딩)        Table (CRM 스키마)
     │                                     │
     └──────────────┬──────────────────────┘
                    ▼
                Agent Ops
              (RAG 에이전트)
                    │
        ▼ 권한·도메인·감사 설정
                [Agent Chat]
                    │
    "이번 주 주요 계약건 알려줘" / "ams 이용약관 요약해줘"
                    ▼
        → Storage 문서 + CRM DB 조합 답변
```

***

## 페르소나별 역할

<Tabs>
  <Tab title="고객관리자 · 엔지니어">
    **역할**: 데이터 소스 준비 — Storage 업로드

    **하는 일**:

    * 관리 중인 **고객 데이터**(엑셀·워드·PDF)를 분류·정리
    * 고객관리 지침 문서·FAQ·계약 템플릿도 주제별로 구분
    * Seahorse **Storage** 를 주제별/중요도별로 생성
    * 파일을 업로드하면 스토리지가 자동 임베딩

    **사용 문서**:

    * [Storage 생성](/console/storage/storage-create)
    * [Storage 상세 & 파일 업로드](/console/storage/storage-detail)
    * [Support Extension 37종](/console/storage/storage-detail#support-extension-지원-확장자)

    **결과**:

    * Storage 여러 개 + 자동 생성된 Table 세트
  </Tab>

  <Tab title="개발자 · 프로그래머">
    **역할**: 외부 DB·API 연동 — CRM PostgreSQL 과 Seahorse 연결

    **하는 일**:

    * 기존 CRM **PostgreSQL DB** 를 Seahorse 에이전트에 연결
    * Seahorse Storage 로 올리지 않고 **원본 DB 를 실시간 조회** 하는 형태
    * 방법 1: **PostgreSQL MCP 템플릿** 등록 → 에이전트가 SQL 실행
    * 방법 2: 내부 API Swagger 를 보고 **커스텀 MCP 도구** 작성

    **사용 문서**:

    * [PostgreSQL 템플릿](/console/agent-ops/agent-tool/templates/postgresql) (가장 빠른 경로)
    * [커스텀 도구 생성](/console/agent-ops/agent-tool/custom-create)
    * [Agent 생성 → 도구 탭 연결](/console/agent-ops/agent/agent-create)
    * 자동화 레시피: [PostgreSQL 반복 쿼리 자동화](/agent-chat/recipes/postgres-sql-automation)

    **주의**:

    * 운영 DB 는 반드시 **읽기 전용 계정** 사용
    * 민감 컬럼 마스킹 뷰 또는 SELECT 제외
    * API Swagger 기술 문서를 에이전트에게 함께 제공하면 정확도↑
  </Tab>

  <Tab title="보안 관리자">
    **역할**: 에이전트 권한·도메인·감사 관리

    **하는 일**:

    * 에이전트 **접근 도메인** 제한 (예: 사내 IP 만)
    * **사용 권한** — 어느 팀이 어떤 Storage·Table 에 접근하는지
    * **API Key 발급·회수** — 외부 연동용
    * **감사 로그 모니터링** — 누가 언제 어떤 질의를 했는지
    * 에이전트 배포 URL 슬러그 정책 확인

    **사용 문서**:

    * [Agent 생성 — 접근 권한 설정](/console/agent-ops/agent/agent-create)
    * [API Keys 관리](/console/management/api-keys)
    * [Organization 멤버 관리](/console/management/organization)
    * [Export Keys (X25519)](/console/management/export-keys)
    * 운영 감사: [Events 감사 로그](/internal/system-admin/operations/events)
    * 차단 API Key: [Blocked API Keys](/internal/system-admin/operations/blocked-api-keys)

    **체크리스트**:

    * [ ] 에이전트에 **읽기 전용** 도구만 연결
    * [ ] API Key 권한이 최소 권한 원칙 준수
    * [ ] 감사 로그 보존 정책 확인
    * [ ] 예약 슬러그 정책 ([Reserved Subdomains](/internal/system-admin/settings/agent-settings/reserved-subdomains))
  </Tab>

  <Tab title="최종 사용자">
    **역할**: Agent Chat 에서 대화로 업무 수행

    **하는 일**:

    * 배포된 에이전트 URL (`{slug}.agent.seahorse.dnotitia.ai`) 접속
    * 자연어로 질의 — 예:
      * "이번 주 주요 계약 건과 리스트 출력해줘"
      * "ams 이용약관을 요약해줘"
      * "2025년 10월 26일 본회의 상정 안건 10개 알려줘"
    * 필요 시 Storage·Web Search·Tool Call 카드 확인해 출처 검증

    **사용 문서**:

    * [Agent Chat 개요 + 활용 레시피](/agent-chat)
    * [PostgreSQL + CRM 자동화 레시피](/agent-chat/recipes/postgres-sql-automation)
    * [RAG + 웹 검색 통합](/agent-chat/recipes/rag-web-search)
    * [Tool Call 카드 읽기](/agent-chat/ui/tool-call)
  </Tab>
</Tabs>

***

## Console 구성 단계

<Steps>
  <Step title="Storage 생성 + 분류별 업로드">
    주제·중요도·팀별로 Storage 를 나누세요 — `crm-customer-data`, `crm-policy-docs`, `sales-playbook` 등.

    * [Storage 생성](/console/storage/storage-create)
    * 파일 업로드 (스토리지 자동 임베딩)
  </Step>

  <Step title="PostgreSQL CRM 연결 (선택)">
    실시간 조회가 필요한 기존 CRM DB 가 있다면:

    * [PostgreSQL MCP 템플릿](/console/agent-ops/agent-tool/templates/postgresql) 등록
    * 환경변수: `POSTGRES_CONNECTION_STRING` (읽기 전용 계정)
    * Tool Management 화면에서 **Active** 상태 확인
  </Step>

  <Step title="System Prompt 준비">
    에이전트의 응답 성격·톤·금지사항 정의.

    예시 시스템 프롬프트:

    ```
    당신은 Acme 주식회사의 CRM 분석 도우미입니다.
    - 고객 데이터는 Storage 의 문서와 PostgreSQL DB 에서 조회합니다.
    - 민감 정보(주민번호·카드번호)는 응답에서 마스킹 처리합니다.
    - 확실하지 않은 정보는 추측하지 말고 "자료에 없음" 으로 답합니다.
    - 모든 숫자 답변에는 출처(파일명 또는 쿼리)를 명시합니다.
    ```

    자세한 설정: [System Prompts](/console/agent-ops/system-prompts)
  </Step>

  <Step title="Agent 생성·연결">
    * Agent Ops → **\[에이전트 생성]**
    * 이름·슬러그·설명
    * **테이블** 탭: 1단계의 Storage 자동 생성 Table 들 연결
    * **엔드포인트** 탭: 사용할 LLM (예: `claude-opus-4.5` 또는 비용 최적화 `gpt-oss-120b`)
    * **도구** 탭: PostgreSQL 템플릿 + 필요 시 Web Search·Slack
    * **규칙** 탭: Rule Set 적용 (금칙어·응답 길이 등)

    자세한 내용: [Agent 생성](/console/agent-ops/agent/agent-create)
  </Step>

  <Step title="보안·권한 설정">
    * API Key 발급 범위 제한
    * 에이전트 접근 도메인·조직 멤버 권한
    * 감사 로그 모니터링 준비

    자세한 내용: [Management](/console/management), [System Admin → Operations](/internal/system-admin/operations)
  </Step>

  <Step title="배포 & 사용자 공지">
    * **\[배포]** 클릭 → 상태가 `Deployed` 로
    * 배포 URL 확인 (`{slug}.agent.seahorse.dnotitia.ai`)
    * 내부 사용자에게 URL 공유 + 사용 가이드 배포

    자세한 내용: [에이전트 배포](/console/agent-ops/agent/agent-detail)
  </Step>
</Steps>

***

## Agent Chat 에서 사용하기

배포 후 사용자는 Agent Chat UI 에서 다음과 같은 질의 가능:

<Tabs>
  <Tab title="고객 데이터 검색">
    > "Acme Corp 계약 이력을 보여줘"

    → 에이전트 동작:

    1. Storage 의 CRM 문서 검색 (`search_documents`)
    2. 필요 시 PostgreSQL `execute_query` 로 최근 데이터 조회
    3. 두 결과를 합쳐 요약 응답 + 출처 명시
  </Tab>

  <Tab title="주간 리포트">
    > "이번 주 신규 계약 건수와 상위 5개 지역 알려줘"

    → PostgreSQL 쿼리 실행 → 표 형태 결과 → 자연어 요약.
    같은 프롬프트를 [Scheduler](/agent-chat/user-menu/scheduler) + [Slack 알림](/agent-chat/recipes/slack-notification) 로 자동화 가능.
  </Tab>

  <Tab title="정책 문서 요약">
    > "ams 이용약관 요약해줘" / "2025년 10월 26일 본회의 상정 안건 10개 알려줘"

    → Storage 정책·약관 문서 검색 → 요약.
    Tool Call 카드로 실제 참조한 문서·청크 확인 가능.
  </Tab>
</Tabs>

***

## 체크리스트 (구성자용)

<Warning>
  배포 전에 꼭 확인하세요.
</Warning>

### 데이터 준비

* [ ] Storage 분류 체계 정의 (고객·정책·제품 등)
* [ ] 민감 정보 마스킹·제외 규칙
* [ ] 파일 형식 [37종 지원 확장자](/console/storage/storage-detail#support-extension-지원-확장자) 확인

### DB 연동 (해당 시)

* [ ] 읽기 전용 DB 계정 생성
* [ ] SSL 연결 활성화
* [ ] MCP 도구 Test Connection 성공

### 에이전트 구성

* [ ] System Prompt 명확화 (톤·금지·출처 규칙)
* [ ] LLM 모델 비용 대비 품질 검토 ([Billing 모델 단가](/billing))
* [ ] 필요 도구만 연결 (남용 방지)

### 보안·감사

* [ ] 읽기 전용 권한만 부여
* [ ] API Key 최소 권한
* [ ] Events 감사 로그 모니터링 설정
* [ ] 에이전트 접근 도메인 제한

### 사용자 온보딩

* [ ] 사용 가이드 + 사내 배포 URL 공유
* [ ] FAQ 예시 프롬프트 정리
* [ ] 문의 채널 지정

***

## 관련 문서

* [Console 활용 가이드 목록](/console/guides)
* [Agent Chat 개요](/agent-chat)
* [PostgreSQL 자동화 레시피](/agent-chat/recipes/postgres-sql-automation)
* [Tool Management (도구 등록)](/console/agent-ops/agent-tool)
* [Management (API Key·조직)](/console/management)