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

> Flow Studio + Scheduler 로 일간·주간 보고서를 자동 생성·발행 (Slack·메일 전송)

# Scheduled report

# 보고서 자동 발행

**요약**: 정기 지표·리포트를 **Flow Studio** 로 설계하고 **Scheduler** 로 주기 실행, 결과를 DOCX·PPTX·Slack 메시지로 자동 발행.

## 구성 개요

```
Scheduler (Cron)
      ↓
  Flow Studio
 ┌────────────────────────────────┐
 │ 1. execute_query (PostgreSQL)  │
 │ 2. search_documents (Storage)  │
 │ 3. LLM 요약/분석               │
 │ 4. render_document (DOCX/PPTX) │
 │ 5. post_message (Slack)        │
 └────────────────────────────────┘
      ↓
  팀 채널 / 메일함에 보고서 도착
```

## 요구 사항

| 항목         | 설정                                     |
| ---------- | -------------------------------------- |
| **데이터 소스** | PostgreSQL MCP / Storage / Analytics 등 |
| **출력 포맷**  | DOCX (워드) 또는 PPTX (슬라이드) 템플릿           |
| **발행 채널**  | Slack MCP (채널 전송) 또는 이메일               |
| **실행 주기**  | Scheduler Cron (일간/주간/월간)              |

## 단계

<Steps>
  <Step title="출력 템플릿 준비">
    * [Word 템플릿 가이드](/agent-chat/toolbar/word/template-guide) 또는 [PowerPoint 템플릿 가이드](/agent-chat/toolbar/powerpoint/template-guide) 참고
    * 주간 리포트: 요약·지표 표·차트 자리표시자 포함
    * **Temp Files** 패널에 템플릿 업로드
  </Step>

  <Step title="데이터 수집 흐름 설계">
    Flow Studio 에서 노드 연결:

    * `execute_query` — DB 지표 (주문·사용자·매출 등)
    * `search_documents` — 주간 주요 이슈·공지 문서 수집
    * `web_search` (선택) — 외부 동향
  </Step>

  <Step title="LLM 요약 노드 추가">
    수집된 데이터를 System Prompt 기반으로 정형화:

    ```
    다음 데이터를 임원용 주간 리포트로 정리:
    1. 핵심 지표 Top 5
    2. 전주 대비 변동률
    3. 주의가 필요한 이상치 3 가지
    4. 다음 주 예상 이슈
    ```
  </Step>

  <Step title="문서 렌더링">
    * `render_document` 또는 `create_presentation` 로 템플릿에 데이터 주입
    * 결과 파일은 Temp Files `generated_docxs/` 또는 `generated_pptxs/` 에 저장
  </Step>

  <Step title="Slack · 이메일 발행">
    * Slack MCP `post_message` — 채널에 요약 + 파일 첨부
    * 또는 custom MCP 로 이메일 발송
    * 대시보드 URL·상세 페이지 링크 포함
  </Step>

  <Step title="Scheduler 등록">
    [사용자 메뉴 → Scheduler](/agent-chat/user-menu/scheduler):

    * Flow 이름 선택
    * Cron: `0 9 * * MON` (매주 월요일 9시) / `0 9 1 * *` (매월 1일)
    * Timezone: `Asia/Seoul`
    * 실패 알림 이메일 등록
  </Step>
</Steps>

## 프롬프트 템플릿

**주간 임원 리포트**:

```
지난 7 일간 데이터로 주간 리포트 작성:
1. {회사} 핵심 KPI 요약 (매출·활성 사용자·NPS)
2. 상위 5 고객 변동
3. 리스크 / 기회 2~3 개
4. 다음 주 Action Item 3 개

형식: DOCX 템플릿 `weekly-exec.docx` 에 주입.
발행: #exec-digest 채널에 메시지 + DOCX 첨부.
```

**월간 기술 리포트**:

```
이번 달 GitHub 활동 + 장애 이력 기반 엔지니어링 리포트:
- 머지된 PR 카테고리별 집계
- 장애 발생·복구 시간 분석
- 사내 지표 개선 3 가지

PPTX 15 슬라이드 내외.
```

## 주의 사항

<Warning>
  * **실행 실패 모니터링** — Scheduler 실패 시 알림 받을 이메일·채널 등록
  * **대량 Token 주의** — 긴 리포트는 비용 ↑ ([Billing 참고](/billing))
  * **시간대** — Cron timezone 확실히 설정
</Warning>

<Info>
  실패 시 재시도 정책·부분 실행(특정 단계만 재실행) 은 Flow Studio 에서 노드별 설정 가능.
</Info>

## 관련 레시피

* [PostgreSQL 반복 쿼리 자동화](/agent-chat/recipes/postgres-sql-automation) — 데이터 수집 단계 상세
* [Slack 알림 자동화](/agent-chat/recipes/slack-notification) — 발행 채널 구성
* [템플릿 기반 제안서 생성](/agent-chat/recipes/proposal-from-template) — DOCX/PPTX 렌더링
* [레시피 목록](/agent-chat/recipes)