Meeting Agent

Slack 기반 AI 미팅 어시스턴트. 미팅의 전(Before) · 중(During) · 후(After) 전 단계를 자동화합니다.

Before Agent  →  During Agent  →  After Agent
업체/인물 리서치    트랜스크립트 수집    회의록 외부 발송
브리핑 생성         수동 노트 세션       액션아이템 알림
미팅 생성/예약      내부·외부 회의록     Contacts 자동 갱신

---

주요 기능

단계	기능
Before	외부 미팅 자동 감지 → 미팅 헤더 즉시 발송 → 업체·인물 리서치 백그라운드 순차 발송
Before	자연어 미팅 생성 (내일 오전 10시 KISA 미팅 잡아줘) + 스레드 답글로 업체명·장소 등 수정
Before	명함 DM 업로드 → Claude Vision OCR → Contacts 자동 등록
During	Google Meet 트랜스크립트 자동 폴링 (10분 주기) + 늦게 도착 시 회의록 자동 보강
During	Slack 수동 노트 세션 (/미팅시작, /메모, /미팅종료)
During	음성 파일 업로드 → Deepgram STT → 메모 자동 등록
During	텍스트 문서 업로드 (TXT, MD, PDF, DOCX 등) — 세션 중엔 메모 추가, 세션 없이 업로드 시 트랜스크립트로 간주해 회의록 초안 즉시 생성 (캘린더 없는 미팅도 지원)
After	내부용·외부용 회의록 초안 검토/편집 후 Drive 저장
After	외부용 회의록 Gmail 발송 (사용자 승인 후)
After	액션아이템 추출 → 담당자 DM → 매일 08:00 리마인더
검색	회의록 검색 (업체명·회의명·날짜 — 자연어 지원: "지난 목요일", "4월 13일", "지난달")
메모	업체 메모 저장 (카카오 메모 — PoC 예산 확보) → Drive 업체 Wiki 파일에 기록
제안서	회의 기반 제안서 개요·초안 생성 (스레드에서 수정 가능)
Feedback	사용자 피드백 (기능 요청·개선·버그) 수집 → 매일 22:00 관리자 다이제스트 발송
Trello 주간 보고서	매주 금 21:00 워크스페이스 전 보드 변경사항 집계 → Google Docs 원본 + Slack 요약 발송

---

기술 스택

항목	내용
LLM	Claude claude-haiku-4-5 (기본 / 명함 OCR) + claude-sonnet-4-5 (회의록 생성·수정, 제안서)
STT	Deepgram REST API (nova-2 모델, 한국어)
인터페이스	Slack Bolt (Socket Mode)
Google 연동	Calendar · Drive · Gmail · Docs · Meet API
스케줄러	APScheduler (브리핑 09:00, 트랜스크립트 폴링 10분, 리마인더 08:00, 피드백 다이제스트 22:00, Trello 주간 보고서 금 21:00)
저장소	SQLite + Fernet 암호화 (사용자 토큰), Google Drive (Contacts · 회의록)

---

빠른 시작

1. 의존성 설치

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. 환경 변수 설정

.env 파일 생성:

# Slack
SLACK_BOT_TOKEN=xoxb-...
SLACK_APP_TOKEN=xapp-...

# LLM
GOOGLE_API_KEY=...
ANTHROPIC_API_KEY=...

# STT
DEEPGRAM_API_KEY=...

# Google OAuth
OAUTH_CALLBACK_URL=https://your-domain.com/oauth/callback

# 암호화 키 (Fernet)
ENCRYPTION_KEY=...

# 내부 도메인 (쉼표 구분)
INTERNAL_DOMAINS=parametacorp.com,iconloop.com

# 피드백 다이제스트 발송 채널 (Slack 채널 ID 또는 관리자 사용자 ID)
FEEDBACK_CHANNEL=C0123456789

# Trello 주간 보고서 설정 (선택)
# - TRELLO_WORKSPACE: 대상 워크스페이스 이름/displayName (기본 CorpDev_BS)
# - TRELLO_REPORT_CHANNEL: 보고서 발송 Slack 채널 (미설정 시 FEEDBACK_CHANNEL 사용)
# - TRELLO_REPORT_USER_ID: Drive·Trello 토큰을 사용할 Slack user_id (미설정 시 자동 선택)
# - TRELLO_REPORT_FOLDER_NAME: Drive 저장 폴더명 (기본 "Trello 주간 보고서")
TRELLO_WORKSPACE=CorpDev_BS
TRELLO_REPORT_CHANNEL=C0123456789

# ParaScope 연동 (선택)
PARASCOPE_BOT_ID=...
PARASCOPE_BOT_APP_ID=...
PARASCOPE_CHANNEL_ID=...

3. 서버 실행

bash start.sh

start.sh는 기존 프로세스를 종료하고 단일 인스턴스로 실행합니다.

4. Slack에서 등록

Google 계정 연동 (필수)

/등록

Google OAuth 인증 후 Drive 폴더 자동 생성. 브리핑·미팅 생성·회의록 등 핵심 기능에 필요합니다.

Trello 연동 (선택 — 파이프라인 관리 시 필요)

/trello

Slack DM으로 전송되는 인증 링크를 클릭하여 Trello 계정을 연결합니다. 연동 시 브리핑에 업체별 Trello 카드 컨텍스트가 포함되고, 회의록 완료 후 액션아이템을 Trello에 등록할 수 있습니다.

드림플러스 계정 등록 (선택 — 회의실 예약 시 필요)

/드림플러스

드림플러스 회의실 예약·조회·취소 및 크레딧 관리 기능을 사용하려면 드림플러스 계정 정보를 등록해야 합니다.

---

키 및 토큰 발급 가이드

Slack Bot Token & App Token

1. api.slack.com/apps 접속 → Create New App → From scratch
2. App Name 입력, 워크스페이스 선택 후 생성

Bot Token (SLACK_BOT_TOKEN)

1. 좌측 메뉴 OAuth & Permissions 이동
2. Bot Token Scopes 에서 아래 권한 추가:

 app_mentions:read
 channels:history
 chat:write
 commands
 files:read
 groups:history
 im:history
 im:read
 im:write
 users:read

3. Install to Workspace → 설치 완료 후 Bot User OAuth Token 복사 → SLACK_BOT_TOKEN

App Token (SLACK_APP_TOKEN)

1. 좌측 메뉴 Basic Information → App-Level Tokens → Generate Token
2. Token Name 입력, Scope에 connections:write 추가 → 생성
3. 생성된 xapp-... 토큰 복사 → SLACK_APP_TOKEN

Socket Mode 활성화

1. 좌측 메뉴 Socket Mode → Enable Socket Mode 켜기

Event Subscriptions 설정

1. 좌측 메뉴 Event Subscriptions → Enable Events 켜기
2. Subscribe to bot events 에 추가: app_mention, message.im

Interactivity 설정

1. 좌측 메뉴 Interactivity & Shortcuts → Interactivity 켜기

Socket Mode에서는 Event/Interactivity의 Request URL 입력이 불필요합니다.

Slash Commands 등록

1. 좌측 메뉴 Slash Commands → Create New Command 로 아래 슬래시 커맨드 섹션의 커맨드를 모두 등록

---

ngrok — 개발용 Public URL

Google OAuth 콜백을 로컬에서 받으려면 외부에서 접근 가능한 URL이 필요합니다.

# ngrok 설치 (macOS)
brew install ngrok

# 인증 (https://ngrok.com 에서 토큰 발급)
ngrok config add-authtoken <your-authtoken>

# 포트 8000 포워딩 (OAuth 서버 기본 포트)
ngrok http 8000

ngrok 실행 후 출력되는 https://xxxx-xxx.ngrok-free.app 주소를 .env에 설정합니다:

OAUTH_CALLBACK_URL=https://xxxx-xxx.ngrok-free.app/oauth/callback

무료 플랜은 세션 종료 시 URL이 변경됩니다. 재실행 후 .env와 Google Cloud Console의 리다이렉트 URI를 함께 업데이트해야 합니다.

---

라이브 서버 배포

개발 환경(ngrok)이 아닌 상시 운영 서버에 배포하는 방법입니다.

전제 조건

• Ubuntu VPS (Python 3.10+)
• 도메인 + Cloudflare 프록시 설정 완료

포트 요구사항

Socket Mode는 아웃바운드 WebSocket만 사용하므로 Slack 통신에는 인바운드 포트가 필요 없습니다. Google OAuth 콜백용 FastAPI 서버(8000 포트)만 외부 접근이 필요하며, Cloudflare Origin Rules로 처리합니다.

개발용 vs 라이브용 Slack 앱

라이브 서버용 Slack 앱을 별도로 생성해야 합니다. Socket Mode는 하나의 앱 토큰으로 하나의 연결만 유지하므로, 동일 앱을 로컬과 서버에서 동시에 실행하면 이벤트가 랜덤으로 분배됩니다. Slack 토큰만 분리하고 Google/Trello/LLM 키는 동일하게 사용할 수 있습니다. 워크스페이스가 다르면 앱 이름·슬래시 커맨드 모두 동일해도 충돌 없습니다.

1. 서버 환경 설정

# 시스템 패키지 설치
sudo apt update
sudo apt install python3.11 python3.11-venv python3.11-dev libffi-dev build-essential -y

# 코드 배포
git clone <repo-url> ~/workspace/meeting-agent
cd ~/workspace/meeting-agent

# venv 생성 및 의존성 설치
python3.11 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

libffi-dev, python3.11-dev, build-essential은 cffi/cryptography 네이티브 빌드에 필요합니다.

2. Slack 앱 생성 (라이브용)

api.slack.com/apps → Create New App → From scratch 으로 라이브 전용 앱을 생성합니다.

설정 항목:

1. Socket Mode → Enable Socket Mode → 토큰 생성 (xapp-...) → SLACK_APP_TOKEN

2. OAuth & Permissions → Bot Token Scopes 추가 후 Install → SLACK_BOT_TOKEN

   app_mentions:read, channels:history, chat:write, commands,
   files:read, files:write, groups:history, im:history, im:read,
   im:write, users:read, users:read.email, users.profile:read
   

3. Event Subscriptions → Enable Events → Subscribe to bot events: app_mention, message.im

4. Interactivity & Shortcuts → Interactivity 켜기

5. Slash Commands → 슬래시 커맨드 섹션의 커맨드를 모두 등록 (Socket Mode에서는 Request URL 불필요)

3. 환경 변수 설정

빠른 시작 > 환경 변수 설정과 동일한 .env 파일을 생성하되, 아래 항목을 라이브 환경에 맞게 변경합니다:

# 라이브용 Slack 앱 토큰으로 교체
SLACK_BOT_TOKEN=xoxb-...
SLACK_APP_TOKEN=xapp-...

# 라이브 도메인으로 변경
OAUTH_CALLBACK_URL=https://meeting.yourdomain.com/oauth/callback

# Trello 연동 시 추가
TRELLO_API_KEY=...
TRELLO_BOARD_ID=...

# Trello 주간 보고서 (선택 — 미설정 시 FEEDBACK_CHANNEL·첫 토큰 보유자로 폴백)
TRELLO_WORKSPACE=CorpDev_BS
TRELLO_REPORT_CHANNEL=C0123456789
TRELLO_REPORT_USER_ID=U0123456789

4. Google Cloud Console 설정

개발용과 동일한 Google Cloud 프로젝트를 사용합니다.

console.cloud.google.com → APIs & Services → Credentials → OAuth 2.0 Client → Authorized redirect URIs 에 라이브 콜백 URL 추가:

https://meeting.yourdomain.com/oauth/callback

개발용(ngrok) URI를 함께 등록해두면 하나의 Google 프로젝트로 개발/라이브 모두 사용 가능합니다.

5. Cloudflare 설정

Cloudflare가 HTTPS를 처리하므로 서버에 Nginx나 SSL 인증서가 불필요합니다.

1. DNS: A 레코드로 meeting.yourdomain.com → 서버 IP, 프록시 활성화 (주황색 구름)
2. Origin Rules: Cloudflare 대시보드 → Rules → Origin Rules → Create Rule
   • 조건: Hostname equals meeting.yourdomain.com
   • 액션: Destination Port → 8000
3. 방화벽: 서버에서 8000 포트를 Cloudflare IP 대역에만 오픈

6. systemd 서비스 등록

sudo tee /etc/systemd/system/meeting-agent.service <<'EOF'
[Unit]
Description=Meeting Agent Slack Bot
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/home/ubuntu/workspace/meeting-agent
EnvironmentFile=/home/ubuntu/workspace/meeting-agent/.env
ExecStart=/home/ubuntu/workspace/meeting-agent/.venv/bin/python3.11 main.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable meeting-agent
sudo systemctl start meeting-agent

서비스 관리:

sudo systemctl status meeting-agent     # 상태 확인
sudo journalctl -u meeting-agent -f     # 로그 확인
sudo systemctl restart meeting-agent    # 재시작

7. 배포 업데이트

cd ~/workspace/meeting-agent
git pull
sudo systemctl restart meeting-agent

main 브랜치에 푸시하면 GitHub Actions가 자동으로 배포하며, 배포 완료 시 FEEDBACK_CHANNEL에 버전·변경사항 알림이 발송됩니다.

8. 데이터 백업 (선택)

SQLite DB를 주기적으로 백업합니다:

# crontab -e 에 추가
0 3 * * * cp /home/ubuntu/workspace/meeting-agent/store/users.db /home/ubuntu/backups/users_$(date +\%Y\%m\%d).db

---

Google API Key (GOOGLE_API_KEY)

Gemini LLM 호출용 키입니다.

1. Google AI Studio 접속
2. Create API key 클릭 → 프로젝트 선택 또는 신규 생성
3. 생성된 키 복사 → GOOGLE_API_KEY

---

Google OAuth 클라이언트 설정

Calendar / Drive / Gmail / Docs / Meet API 연동에 사용되는 OAuth 2.0 자격 증명입니다.

1. Google Cloud Console 접속 → 프로젝트 선택/생성
2. APIs & Services → Library 에서 아래 API 활성화:

• Google Calendar API
• Google Drive API
• Gmail API
• Google Docs API
• Google Meet API (Google Workspace Meeting API)
• People API

3. APIs & Services → OAuth consent screen 설정:

• User Type: Internal (조직 내부용) 또는 External
• 앱 이름, 지원 이메일 입력

4. APIs & Services → Credentials → Create Credentials → OAuth client ID:

• Application type: Web application
• Authorized redirect URIs에 OAUTH_CALLBACK_URL 값 추가

5. 생성된 Client ID · Client Secret → server/oauth.py의 GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET 환경변수로 설정

GOOGLE_CLIENT_ID=...apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-...

---

Fernet 암호화 키 (ENCRYPTION_KEY)

사용자 Google OAuth 토큰을 SQLite에 저장할 때 암호화에 사용됩니다.

python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

출력된 값을 .env에 설정합니다:

ENCRYPTION_KEY=abc123...==

이 키를 분실하면 저장된 모든 사용자 토큰을 복호화할 수 없습니다. 안전한 곳에 백업하세요.

---

Deepgram API Key (DEEPGRAM_API_KEY)

음성 파일 STT(Speech-to-Text) 변환에 사용됩니다.

1. console.deepgram.com 접속 → 회원가입 또는 로그인
2. 좌측 메뉴 API Keys → Create a New API Key
3. Key Name 입력, Permissions: Member 선택 → 생성
4. 생성된 키 복사 → DEEPGRAM_API_KEY

사용 모델: nova-2 (한국어 지원, smart_format, punctuate 옵션 활성화)

지원 포맷: MP3, MP4, M4A, WAV, OGG, WebM, AAC 등 (최대 500MB)

사내 방화벽 환경에서 SSL 인증서 오류 발생 시 tools/stt.py의 verify=False 설정으로 우회합니다.

---

슬래시 커맨드

커맨드	설명
/등록 / /register	Google 계정 연동
/재등록 / /reregister	Google 계정 재인증 (스코프 변경 시 활용)
/브리핑 / /brief	오늘 미팅 브리핑 수동 실행
/미팅추가 / /meet	자연어로 미팅 생성
/기업 / /company	기업 정보 강제 리서치
/인물 / /person	인물 정보 강제 리서치
/미팅시작	수동 노트 세션 시작 (후보 일정 있으면 선택 UI + 새 미팅 추가 버튼)
/메모	미팅 중 노트 추가 (세션 없으면 자동 시작)
/미팅종료	세션 종료 + 회의록 즉시 생성 + 검토 단계
/회의록작성	회의록 수동 생성
/회의록	저장된 회의록 목록 조회 (검색어 지원: /회의록 카카오, /회의록 2026-04)
/업데이트 / /update	company_knowledge.md 갱신
/드림플러스 / /dreamplus	드림플러스 계정 등록/변경
/회의실예약	드림플러스 회의실 예약
/회의실조회	회의실 예약 조회
/회의실취소	회의실 예약 취소
/크레딧조회	드림플러스 크레딧 조회
/trello	Trello 계정 연결
/trello-disconnect	Trello 연결 해제
/트렐로조회 / /trello-search	Trello 카드 검색
/트렐로주간보고 / /trello-weekly	Trello 주간 보고서 생성 (인자: 일수, 기본 7)
/도움말 / /help	사용 가능한 커맨드 및 자연어 명령어 안내

자연어 DM도 지원합니다 (브리핑 해줘, 내일 3시 KISA 미팅 잡아줘, 지난 목요일 회의록, 카카오 메모 — PoC 예산 확보, 주간보고서, 지난 2주 트렐로 보고서, ~기능 추가해줘, ~버그 같아 등).

---

브리핑 동작 방식

외부 미팅 브리핑은 2단계 비동기 방식으로 동작합니다. 리서치 대기 없이 미팅 정보를 즉시 수신하고, 리서치 결과는 완료되는 순서대로 스레드에 추가됩니다.

1단계 (즉시)     미팅 헤더 발송
                  ┌────────────────────────────────┐
                  │ 📋 업체명 — 오후 3:00 (Google Meet) │
                  │ [어젠다 내용 또는 스레드 답글 안내]   │
                  └────────────────────────────────┘

2단계 (백그라운드, 업체별 순차)
  → 업체 리서치 완료  🏢 업체명 리서치 결과 (ParaScope / 업체 동향 / 서비스 연결점)
  → 담당자 완료       👤 담당자 정보
  → 맥락 조회 완료    📌 이전 미팅 맥락 + 📧 이메일 맥락

다중 업체 브리핑 시에도 단일 스레드에서 순차 처리하므로 두 업체의 결과가 섞이지 않습니다.

---

프롬프트 템플릿 커스터마이징

LLM에 전달되는 주요 프롬프트는 prompts/templates/ 폴더의 마크다운 파일로 관리됩니다. 파일을 수정한 뒤 서버를 재실행하면 변경 내용이 즉시 반영됩니다 (코드 수정 불필요).

prompts/templates/
├── minutes_internal.md     # 내부용 회의록 생성 프롬프트
├── minutes_external.md     # 외부용 회의록 생성 프롬프트
├── company_news.md         # 업체 최근 동향 검색 프롬프트
├── person_info.md          # 인물 정보 검색 프롬프트
└── service_connection.md   # 서비스 연결점 분석 프롬프트

템플릿 내 변수는 {{변수명}} 형식으로 작성합니다:

템플릿 파일	사용 변수
minutes_internal.md	{{title}}, {{date}}, {{attendees}}, {{sources}}
minutes_external.md	{{title}}, {{date}}, {{attendees}}, {{internal_minutes}}
company_news.md	{{today}}, {{company_name}}
person_info.md	{{person_name}}, {{company_name}}
service_connection.md	{{knowledge}}, {{company_info}}

인라인으로 관리되는 프롬프트(미팅 파싱, 인텐트 분류, 액션아이템 추출 등)는 prompts/briefing.py에서 직접 수정합니다.

---

Drive 폴더 구조

MeetingAgent/
├── Contacts/
│   ├── Companies/          # {업체명}.md (리서치 결과 + 내부 메모)
│   └── People/             # {이름}.md
├── Minutes/                # {날짜}_{제목}_내부용.md / _외부용.md
├── Sources/                # 원본 데이터 보관
│   └── Research/           # {날짜}_{업체명}_web_search.md
└── company_knowledge.md    # 자사 서비스 요약

---

프로젝트 구조

meeting-agent/
├── main.py                 # Slack Bolt + APScheduler 진입점
├── start.sh                # 단일 인스턴스 실행 스크립트 (개발용)
├── .github/
│   └── workflows/
│       └── deploy.yml      # GitHub Actions 자동 배포 (웹훅 방식)
├── agents/
│   ├── before.py           # Before 에이전트 (브리핑, 리서치, 미팅 생성)
│   ├── during.py           # During 에이전트 (트랜스크립트, 노트, 음성STT, 문서업로드, 회의록)
│   ├── after.py            # After 에이전트 (회의록 발송, 액션아이템, Trello 등록)
│   ├── proposal.py         # 제안서 에이전트 (개요·초안 생성, 스레드 수정)
│   ├── card.py             # 명함 OCR 에이전트
│   ├── room.py             # 드림플러스 회의실 예약·조회·취소 (Slack Modal)
│   ├── dreamplus.py        # 드림플러스 API 래퍼 (JWT 인증)
│   ├── feedback.py         # 피드백 수집·분류·다이제스트 에이전트
│   └── trello_report.py    # Trello 주간 보고서 (Google Docs + Slack 요약)
├── tools/
│   ├── calendar.py         # Google Calendar API
│   ├── docs.py             # Google Docs API (트랜스크립트 읽기)
│   ├── drive.py            # Google Drive API
│   ├── gmail.py            # Gmail API
│   ├── stt.py              # Deepgram STT API
│   ├── slack_tools.py      # Slack Block Kit 메시지 빌더
│   ├── trello.py           # Trello REST API 래퍼
│   ├── dreamplus.py        # 드림플러스 API 클라이언트
│   └── text_extract.py     # 텍스트 추출 유틸리티
├── prompts/
│   ├── briefing.py         # LLM 프롬프트 함수 (템플릿 로더 포함)
│   └── templates/          # 외부 프롬프트 템플릿 (서버 재실행으로 반영)
│       ├── minutes_internal.md
│       ├── minutes_external.md
│       ├── briefing_summary.md
│       ├── company_news.md
│       ├── person_info.md
│       ├── service_connection.md
│       ├── proposal_intake.md
│       └── proposal_generate.md
├── store/
│   └── user_store.py       # SQLite + Fernet 사용자 토큰 관리
├── server/
│   └── oauth.py            # FastAPI (OAuth 콜백 + Trello 인증 + 배포 웹훅)
├── tests/                  # 단위 테스트
├── requirements.txt
└── docs/                   # 설계 문서

---

문서

문서	내용
요구사항	전체 시스템 요구사항 및 구현 현황
Before Agent 설계	브리핑, 리서치, 미팅 생성 상세 설계
During Agent 설계	트랜스크립트 수집, 수동 노트 세션 설계
After Agent 설계	회의록 발송, 액션아이템, Contacts 갱신 설계
LLM 사용 현황	LLM 호출 함수·프롬프트 목록
테스트 가이드	테스트 실행 방법 및 구성

---

테스트

pytest tests/
pytest tests/ -v             # 상세 출력
pytest tests/test_before.py  # 특정 파일만

---

Google OAuth 권한 범위

Scope	용도
calendar	미팅 조회·생성·설명 업데이트·extendedProperties 패치
drive	Contacts·회의록·company_knowledge.md 읽기/쓰기
gmail.readonly	이메일 맥락 검색, 이메일 주소 추출
gmail.send	외부용 회의록 이메일 발송
documents.readonly	Google Meet 트랜스크립트 읽기
contacts.readonly	Google 주소록 참석자 이메일 조회 (신규 등록자부터 적용, 기존 사용자는 /재등록 필요)
meetings.space.created	Google Meet 트랜스크립션 자동 활성화