Google Docs 수정¶

Google Docs 수정 스킬은 Google Docs API를 사용하여 기존 문서의 내용을 변경합니다. 텍스트 삽입(insert), 치환(replace), 삭제(delete) 작업을 조합하여 문서를 업데이트할 수 있습니다.

설정 방법¶

1. 스킬 노드 추가¶

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

2. 스킬 선택¶

우측 패널의 스킬 탭에서 Google Docs 수정을 선택합니다.

3. Google OAuth 인증 연결¶

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

4. 파라미터 입력¶

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

파라미터¶

파라미터	필수	설명
document_id	O	수정할 Google Docs 문서 ID
operations	O	수정 작업 배열 (아래 operations 형식 참조)

operations 배열 형식¶

각 작업은 type 필드로 구분되며, 배열 순서대로 실행됩니다.

insert (텍스트 삽입)¶

필드	필수	설명
type	O	`insert`
index	O	삽입 위치 (문자 인덱스, 1부터 시작)
text	O	삽입할 텍스트

replace (텍스트 치환)¶

필드	필수	설명
type	O	`replace`
search_text	O	검색할 텍스트
replace_text	O	치환할 텍스트

delete (텍스트 삭제)¶

필드	필수	설명
type	O	`delete`
start_index	O	삭제 시작 위치 (문자 인덱스)
end_index	O	삭제 끝 위치 (문자 인덱스)

operations 예시¶

[
  {"type": "replace", "search_text": "{{날짜}}", "replace_text": "2026-03-17"},
  {"type": "insert", "index": 1, "text": "[자동 업데이트]\n"},
  {"type": "delete", "start_index": 100, "end_index": 150}
]

인증 정보¶

Google OAuth 인증이 필요합니다.

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

출력¶

{
  "success": true,
  "data": {
    "document_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms",
    "operations_applied": 3
  }
}

출력 참조¶

{{ $('skill_1').data_content.result.document_id }}          → 수정된 문서 ID
{{ $('skill_1').data_content.result.operations_applied }}   → 적용된 작업 수

활용 예시¶

템플릿 문서의 플레이스홀더 치환¶

미리 작성된 템플릿 문서에서 {{고객명}}, {{날짜}} 등의 플레이스홀더를 실제 데이터로 치환합니다.

파라미터	값
document_id	`1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms`
operations	아래 참조

[
  {"type": "replace", "search_text": "{{고객명}}", "replace_text": "홍길동"},
  {"type": "replace", "search_text": "{{날짜}}", "replace_text": "2026-03-17"},
  {"type": "replace", "search_text": "{{금액}}", "replace_text": "1,500,000원"}
]

LLM 분석 결과를 문서 끝에 추가¶

기존 보고서 문서의 끝에 LLM이 생성한 분석 결과를 삽입합니다. Google Docs 읽기 스킬로 먼저 문서를 읽어 word_count로 끝 위치를 파악한 후 삽입합니다.

파라미터	값
document_id	`{{ $('skill_docs_read').data_content.result.document_id }}`
operations	아래 참조

[
  {"type": "insert", "index": 9999, "text": "\n\n## AI 분석 결과\n{{ $('agent_1').text_content }}"}
]

참고¶

operations 배열의 작업은 순서대로 실행됩니다. 삽입/삭제 시 인덱스가 변경되므로 순서에 유의하세요.
replace 작업은 문서 전체에서 search_text와 일치하는 모든 항목을 치환합니다.
문서에 대한 편집 권한이 있어야 합니다. 공유 설정을 확인하세요.
index는 1부터 시작하며, 문서의 첫 번째 문자 앞에 삽입하려면 1을 사용합니다.