happybell80
d4e75f5913
- skill-email: GET /fetch → GET /messages (실제 엔드포인트에 맞춤) + 파라미터 명세 - skill-news: API 섹션 보강 (search, summarize, latest 파라미터 명세) 연결: rb8001 #180(404), rb8001 이슈 조사 종합 보고서 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
60 lines
1.4 KiB
Markdown
60 lines
1.4 KiB
Markdown
---
|
|
name: skill-email
|
|
description: Gmail API를 통한 이메일 읽기·쓰기·요약. 사용자가 "메일 확인해줘", "이메일 보내줘", "메일함 정리해줘" 등 이메일 관련 요청을 할 때 사용.
|
|
runtime:
|
|
kind: external_http
|
|
service_url_env: SKILL_EMAIL_URL
|
|
---
|
|
|
|
# skill-email
|
|
|
|
Gmail 통합 스킬. 포트 8501.
|
|
|
|
## Trigger
|
|
|
|
- `email_read`: 수신함 확인, 최근 메일 읽기, 안 읽은 메일
|
|
- `email_send`: 메일 작성·전송·답장
|
|
- `email_summary`: 메일함 요약, 핵심만 정리
|
|
|
|
## Do
|
|
|
|
- Gmail OAuth 토큰 기반 인증
|
|
- Push 알림 지원 (Google Pub/Sub)
|
|
- rb8001에서 HTTP로 호출
|
|
|
|
## Do Not
|
|
|
|
- 토큰 없이 호출하지 않음
|
|
- 비인증 사용자에게 메일 내용 노출 금지
|
|
|
|
## API
|
|
|
|
### 이메일 전송
|
|
|
|
POST /send
|
|
|
|
| 파라미터 | 타입 | 필수 | 설명 |
|
|
|---------|------|------|------|
|
|
| to | string | 필수 | 수신자 이메일 |
|
|
| subject | string | 필수 | 제목 |
|
|
| body | string | 필수 | 본문 |
|
|
|
|
### 이메일 조회
|
|
|
|
GET /messages
|
|
|
|
| 파라미터 | 타입 | 필수 | 설명 |
|
|
|---------|------|------|------|
|
|
| user_id | UUID | 필수 | 사용자 ID (쿼리 파라미터) |
|
|
| limit | int | 선택 | 최대 결과 수 (기본 10) |
|
|
| query | string | 선택 | 검색 쿼리 |
|
|
| provider | string | 선택 | "gmail" (기본) |
|
|
|
|
### 이메일 요약
|
|
|
|
POST /process
|
|
|
|
## 환경변수
|
|
|
|
- `USER_ID`, `TOKEN_BASE`, `TOPIC` (Gmail Push)
|