> ## 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. > DOCX/PPTX 템플릿에 변수 주입 + 사내 문서·DB 자동 인용 + Flow Studio + Team Control 기반 배치로 일괄 생성. 제안서·계약서·보고서 자동 작성 # Proposal from template # 템플릿 기반 제안서 생성 **요약**: Storage 에 올린 **DOCX/PPTX 템플릿** 에 변수(`{{고객사명}}`, `{{매출}}`) 를 정의해두고, 에이전트가 사내 문서(RAG) · DB(PostgreSQL) · 외부 데이터를 조합해 자동으로 채운 뒤 **DOCX 또는 PPTX 파일로 출력** 합니다. Flow Studio + Team Control 기반 배치로 여러 고객사용 제안서를 **배치 생성** 도 가능. ## 구성 개요 ``` DOCX/PPTX 템플릿 (Storage) {{고객사명}} {{과제}} {{솔루션}} {{비용}} ... │ ▼ Agent ├─ search_documents (성공사례·자사 자료 RAG) ├─ PostgreSQL MCP (고객사 데이터·과거 거래) ├─ Web Search (최신 시장 정보) └─ render_template (변수 주입 + DOCX/PPTX 생성) │ ▼ 완성된 제안서 / 계약서 / 보고서 (다운로드 또는 Slack 전송) ``` ## 활용 시나리오 | 시나리오 | 템플릿 | 데이터 소스 | 출력 | | :------------------------ | :---------- | :---------------------------------- | :------------------ | | **영업 제안서** | DOCX | 고객 정보(DB) + 성공사례(RAG) + 자사 솔루션 카탈로그 | 고객 맞춤 제안서 DOCX/PPTX | | **계약서 자동 작성** | DOCX | 거래 조건(DB) + 표준 계약 조항(RAG) | 검토용 계약서 초안 DOCX | | **분기 IR 자료** | PPTX | KPI(DB) + 사업부 보고(RAG) | 임원 발표용 PPTX | | **고객 온보딩 키트** | DOCX + PPTX | 고객 설정(DB) + 매뉴얼(RAG) | 환영 메일 + 첨부 자료 | | **법무 검토 의견서** | DOCX | 법령 RAG + 과거 검토 사례 | 표준 의견서 DOCX | | **채용 제안서 (Offer Letter)** | DOCX | HR DB(연봉/직급) + 회사 소개 | 후보자별 Offer DOCX | | **컨설팅 보고서** | DOCX | 인터뷰 요약(RAG) + 분석 결과(DB) | 챕터별 보고서 | | **납품 견적서** | DOCX | 단가 마스터(DB) + 옵션 카탈로그 | 항목별 견적서 PDF | ## 요구 사항 | 항목 | 설정 위치 | | ---------------------- | ---------------------------------------------------------------------------------------------------------- | | **Storage** | 템플릿 파일 + 인용할 사내 자료(성공사례·솔루션 카탈로그) 업로드 | | **에이전트** | Storage Table 연결 + 필요한 MCP 도구 | | **MCP 도구** | (선택) PostgreSQL — 고객·단가 조회 / Web Search — 시장 정보 / Slack — 결과 전송 | | **PostgreSQL 접속 환경변수** | **Internal → System Management → [Environment](/internal/system-admin/settings/environment)** (운영자만 설정 가능) | | **모델** | 문장 품질 중요 → `claude-opus-4.5` 권장 ([Billing](/billing)) | | **System Prompt** | 어조(공식·격식)·금칙(허위 약속 금지)·인용 형식 명시 | **PostgreSQL 을 고객·단가 DB 로 연결하려면 운영자 Console 사전 세팅이 필요** 합니다. PostgreSQL 템플릿의 접속 환경변수(`PG_HOST` · `PG_USER` · `PG_PASSWORD` · `PG_DBNAME` 등)는 **System Default 타입** 이라 사용자가 도구 생성 화면에서 직접 입력하지 못합니다. **운영자가 Internal → System Management → [Environment](/internal/system-admin/settings/environment) 에서 값을 먼저 등록** 해야 합니다. **진행 순서** 1. 운영자에게 고객 DB 접속 정보(호스트·읽기 전용 계정·DB 명) 전달 2. 운영자가 Environment 에 PostgreSQL 환경변수 세팅 3. 그 다음에 사용자 화면(Tool Management)에서 PostgreSQL 템플릿 생성 4. [도구 상세](/console/agent-ops/agent-tool/tool-detail) 의 **Test** 로 연결 확인 자세한 보안·설정 주의: [PostgreSQL 템플릿 → Environment Variables](/console/agent-ops/agent-tool/templates/postgresql#environment-variables) · [PostgreSQL 자동화 레시피 — 읽기 전용 권장](/agent-chat/recipes/postgres-sql-automation#먼저-읽어주세요--읽기-전용-보고서-용도로만-권장) **제안서 생성 관점에서도 DB 는 SELECT 전용** — 에이전트가 고객 DB 에 실수로 INSERT/UPDATE 하지 않도록 읽기 전용 계정 사용이 필수입니다. ## 템플릿 작성 규칙 ### DOCX 템플릿 Word 문서에 **이중 중괄호 변수** 를 사용합니다. ``` 존경하는 {{고객사명}} 담당자님께, 당사는 {{과제명}} 과제 해결을 위해 다음 솔루션을 제안드립니다. ## 1. 과제 정의 {{과제_상세설명}} ## 2. 제안 솔루션 {{솔루션_요약}} ## 3. 예상 효과 - 비용 절감: {{비용절감액}} - 처리 시간: {{시간단축}} ## 4. 견적 {{견적표}} ← 표 형태로 자동 생성 ## 5. 참고 사례 {{성공사례}} ← RAG 검색 결과 자동 인용 ``` ### PPTX 템플릿 각 슬라이드의 텍스트 박스에 동일한 `{{변수}}` 사용. 차트·이미지는 변수로 동적 생성도 가능 (Plotly·matplotlib 결과 삽입). **변수 명명 규칙** * 한글·영문 혼용 가능: `{{고객사명}}`, `{{customer_name}}` * 중첩 객체는 `.` 으로 접근: `{{customer.name}}`, `{{quote.total}}` * 리스트 반복은 `{{#items}}...{{/items}}` (Mustache 스타일) * 표는 셀 전체에 `{{table_data}}` 변수 → 자동 행 확장 ## 단계 [Storage 상세 → Upload](/console/storage/storage-detail#파일-업로드): * `templates/` prefix 에 DOCX/PPTX 템플릿 * `cases/` 에 성공사례·솔루션 자료 (RAG 검색 대상) * `catalog/` 에 가격·옵션 카탈로그 [Agent 생성](/console/agent-ops/agent/agent-create): * **Endpoints**: `claude-opus-4.5` (문장 품질) 또는 `gpt-5.2` * **Tables**: 위 Storage Table 모두 연결 * **Tools**: PostgreSQL (고객 DB) · Web Search · Slack 등 * **System Prompt**: 어조·금칙·필수 인용 명시 Agent Chat 에서 자연어로 요청: > `templates/sales-proposal-v2.docx 템플릿으로 ABC전자(고객 ID 12345) 대상 영업 제안서를 만들어줘. 과제는 'AI 챗봇 도입'이고, 성공사례는 cases/ 에서 비슷한 제조업 2건을 인용해줘.` 에이전트가: 1. PostgreSQL 에서 ABC전자 정보·과거 거래 조회 2. RAG 로 cases/ 에서 유사 사례 검색·요약 3. 견적 테이블 자동 계산 4. DOCX 변수 주입 → 다운로드 링크 제공 여러 고객사용 제안서를 **한 번에 생성** 하려면 두 가지 경로 중 선택: **(A) [Flow Studio](/agent-chat/toolbar/flow-studio)** — 결정적 배치 * 입력 노드: CSV (`customer_id, project_name, budget`) 또는 PostgreSQL `execute_query` * **Loop** 노드: 고객별 반복 * LLM + Word `create_document` → DOCX 생성 * 업로드 / Slack 알림 **(B) [Team Control](/agent-chat/user-menu/team-control)** — 자율 배치 * Supervisor + Worker(Word Template 도구 허용) * Goal: `customers.csv 의 모든 고객에 대해 sales-proposal-v2.docx 기반 제안서 생성` * Acceptance Criteria: 파일 수 == 고객 수, 필수 변수 누락 0 50 개 고객 기준 Flow Studio 는 약 5 분, Team Control 은 조금 더 오래 (자율 판단 오버헤드). 위 Flow 를 [Scheduler](/agent-chat/user-menu/scheduler) 에 `0 9 * * MON` 같은 Cron 으로 연결하면 매주 월요일 아침 자동 생성. * **다운로드** — Agent Chat 의 첨부 카드에서 직접 * **Slack 전송** — Slack MCP 로 채널·DM 전달 * **이메일** — (이메일 MCP 등록 시) 담당자에게 발송 * **Storage 적재** — 완성본을 별도 Storage 의 `proposals/` 에 저장 → 후속 검색 가능 ## 배치 실행 팁 (Flow Studio · Team Control) * **출력 파일명 규칙 지정** — `proposal_{{customer_id}}_{{date}}.docx` 처럼 templating 으로 충돌 방지 * **샘플 1 건 먼저** — 변수 매핑·문체 확인 후 본 배치 * **품질 검수 워크플로** — 생성 후 자동 PR/Slack 으로 승인 요청 → 승인 시에만 발송 * **다국어** — 같은 템플릿에 `lang` 변수 추가 → 한/영/일 동시 생성 ## 프롬프트 템플릿 ### 단일 제안서 ``` templates/{템플릿파일명}.docx 를 사용해서 다음 정보로 제안서를 만들어줘. - 고객사: {고객사명} - 담당자: {담당자명} ({이메일}) - 과제: {과제명} - 예산: {예산} - 마감: {제안 마감일} 추가 지시: 1. cases/ 에서 동일 산업의 성공사례 2건 인용 2. 견적표는 catalog/ 의 단가 기준 자동 계산 (VAT 별도) 3. "ROI 약속" 같은 단정적 표현 금지 4. 출력은 DOCX 파일로 다운로드 링크와 함께 제공 ``` ### 배치 (Flow Studio) ``` [Flow 작업] 입력: customers.csv (customer_id, name, project, budget) 템플릿: templates/sales-proposal-v2.docx 출력: proposals/proposal_{customer_id}_2026Q2.docx 각 행에 대해: 1. PostgreSQL 에서 고객 상세 조회 (last_order, industry, contact) 2. cases/ 에서 같은 industry 사례 검색 3. 변수 주입 후 DOCX 생성 4. 결과 zip 으로 다운로드 ``` ## 변형·응용 * **계약서 + 전자서명** — DocuSign·Adobe Sign MCP 연동 (사내 도입 시) * **버전 관리** — 동일 고객 재제안 시 이전 버전과 diff 표시 * **AB 테스트 제안서** — 2 가지 톤(공식/캐주얼) 생성 후 응답률 비교 * **반자동 검수** — 생성 후 **Flow 재실행** → "이 제안서에 과장 표현이 있는지 점검해줘" * **개인화 메일 + 첨부** — DOCX 생성 + 같은 변수로 이메일 본문도 함께 생성 ## 주의 사항 * **할루시네이션 위험** — 가격·일정·기술 사양 같은 **수치는 반드시 DB·카탈로그 출처를 강제**. System Prompt 에 "추정 금지, 데이터에 없으면 빈칸" 명시. * **법적 문구** — 계약서·보장 문구는 법무 검토 없이 자동 생성 절대 금지. 항상 **초안(draft)** 상태로 출력하고 검수 워크플로 거치기. * **민감 정보 노출** — 고객별 견적·연봉 등은 [Users 접근 제어](/console/agent-ops/agent/agent-update#수정-시-주의--users-탭-access-control) 에서 권한 분리. * **비용** — DOCX 한 건당 LLM 호출 1\~3 회 발생. 100 건 배치 시 [Billing](/billing) 에서 사전 견적. * **버전 충돌** — 같은 고객사 제안서를 여러 사람이 동시에 생성하지 않도록 파일명에 작성자·타임스탬프 포함. ## 관련 레시피 * [PostgreSQL 반복 쿼리 자동화](/agent-chat/recipes/postgres-sql-automation) — 고객·단가 조회 * [대량 문서 인덱싱·요약](/agent-chat/recipes/bulk-document-summarize) — 인용할 자료 사전 준비 * [보고서 자동 발행](/agent-chat/recipes/scheduled-report) — 정기 보고서 생성·발행 * [Slack 알림 자동화](/agent-chat/recipes/slack-notification) — 완성본 Slack 전달 * [레시피 목록](/agent-chat/recipes)