Google Docs 읽기¶

Google Docs 읽기 스킬은 Google Docs API를 사용하여 문서의 내용을 읽어옵니다. 일반 텍스트 또는 구조화된 형식으로 출력할 수 있으며, LLM 에이전트와 연계하여 문서 분석, 요약 등에 활용할 수 있습니다.

설정 방법¶

1. 스킬 노드 추가¶

캔버스에서 이전 노드의 + 버튼을 클릭하고 스킬 노드를 추가합니다.

2. 스킬 선택¶

우측 패널의 스킬 탭에서 Google Docs 읽기를 선택합니다.

3. Google OAuth 인증 연결¶

인증 탭에서 등록된 Google OAuth 인증 정보를 선택합니다. 미등록 시 새 인증 추가를 클릭하여 Google OAuth 정보를 입력합니다.

4. 파라미터 입력¶

설정 탭에서 문서 ID를 입력합니다. {{를 입력하면 변수 셀렉터가 나타납니다.

파라미터¶

파라미터	필수	설명
document_id	O	Google Docs 문서 ID (URL의 `/d/` 뒤 부분)
output_format		출력 형식 (`text` 또는 `structured`, 기본: `text`)

인증 정보¶

Google OAuth 인증이 필요합니다.

항목	설명
access_token	Google OAuth 액세스 토큰
refresh_token	리프레시 토큰 (자동 갱신)

출력¶

text 형식¶

{
  "success": true,
  "data": {
    "title": "2026년 1분기 보고서",
    "content": "1. 개요\n프로젝트 진행 상황을 아래와 같이 보고합니다...",
    "revision_id": "ALm37BWJkR5zjG",
    "word_count": 1523
  }
}

structured 형식¶

{
  "success": true,
  "data": {
    "title": "2026년 1분기 보고서",
    "content": [
      {"type": "heading", "level": 1, "text": "1. 개요"},
      {"type": "paragraph", "text": "프로젝트 진행 상황을 아래와 같이 보고합니다..."},
      {"type": "list", "items": ["항목 1", "항목 2", "항목 3"]},
      {"type": "table", "rows": [["헤더1", "헤더2"], ["값1", "값2"]]}
    ],
    "revision_id": "ALm37BWJkR5zjG",
    "word_count": 1523
  }
}

출력 참조¶

{{ $('skill_1').data_content.result.title }}       → 문서 제목
{{ $('skill_1').data_content.result.content }}      → 문서 내용
{{ $('skill_1').data_content.result.word_count }}   → 단어 수

활용 예시¶

Google Docs 문서를 읽어 LLM으로 요약¶

Google Docs에서 문서를 읽은 후, LLM 에이전트가 핵심 내용을 요약합니다.

파라미터	값
document_id	`1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms`
output_format	`text`

후속 에이전트 노드에서 {{ $('skill_docs_read').data_content.result.content }}를 참조하여 요약을 생성합니다.

문서 변경 감지 후 알림¶

스케줄 트리거로 주기적으로 문서를 읽고, revision_id가 변경되었을 때 Telegram으로 알림을 보냅니다.

참고¶

document_id는 Google Docs URL에서 추출할 수 있습니다: https://docs.google.com/document/d/{document_id}/edit
structured 형식은 문서의 제목, 문단, 리스트, 테이블 등을 구분하여 반환합니다.
문서에 대한 읽기 권한이 있어야 합니다. 공유 설정을 확인하세요.