Google Workspace

Google Workspace 커넥터가 가장 많이 쓰이는 통합. 연결하면 에이전트가 Drive 에서 읽기, Gmail 로 이메일 전송, Calendar 이벤트 읽기·쓰기 가능 — 모두 여러분이 승인한 스코프 안에서.

​

빌드 가능한 것

​

Google 연결

1. Settings → Connections → New → Google Workspace 열기.
2. 쓰길 원하는 Google 계정으로 로그인.
3. 계획한 서비스의 스코프 부여 (Drive 읽기, Gmail 전송, Calendar 이벤트, Sheets 읽기/쓰기).
4. 연결이 워크스페이스에 나타남, Flow 에 붙일 준비.

​

DataSource 로서 Drive 사용

1. Flow 캔버스에서 DataSource → Google Drive 추가.
2. 픽커에서 폴더 선택 (연결된 계정으로).
3. 초기 인덱스 대기 (블록에 진행 pill 있음).
4. DataSource 를 Agent 에 연결.

새·업데이트된 파일 자동 동기화. 삭제된 파일이 몇 분 안에 인덱스에서 사라짐. 문서 컬렉션으로 자동 벌크 인제스트는 Google Drive Source 블록 있는 Foundry 파이프라인 사용 — Source 블록 참고.

​

Gmail 로 이메일 전송

1. Flow 에 Action → Gmail: Send 추가.
2. 블록 설정에서 이메일이 뭘 담아야 하는지 설명 — Agent 가 대화 기반으로 세부 채움.
3. 전송 전 사람 리뷰 원하면 Requires approval 토글 (승인·배포 참고).

Gmail 액션이 기본으로 연결된 편지함으로 전송. Reply-to 와 CC 는 Action 별 설정 가능.

​

Calendar 읽기

1. Agent 에 Tool → Google Calendar 추가.
2. 캘린더와 작업 선택 (list events, create event, find free time).
3. Tool 을 Agent 에 연결.

대화가 캘린더 컨텍스트 필요할 때 Agent 가 호출 — “다음 여유 슬롯이 언제?”, “3시 미팅 취소” 등.

​

Sheets 읽기 / 쓰기

• Tool → Google Sheets: Read — Agent 가 범위 선택하고 로우 얻음. 조회 테이블에 유용.
• Action → Google Sheets: Append — Agent 결정 후 로우 씀. 로깅에 유용.

​

여러 Google 계정

워크스페이스당 여러 Google 계정 연결 가능. Drive DataSource 나 Gmail Action 추가할 때 어느 연결된 계정 쓸지 선택. 흔한 패턴: 공유 워크스페이스 데이터 (문서, 캘린더) 용 한 계정, 아웃바운드 전송 (no-reply 주소) 용 한 계정.

​

특정 폴더로 스코프

Drive 는 셋업 시 커넥터를 특정 폴더 트리로 좁힘:

• Agent 가 우발 읽을 수 있는 표면 감소.
• 초기 인덱싱 속도 향상.

나중에 재인증 없이 폴더 더 추가 가능.

​

연결 해제

Settings → Connections → Google Workspace → Disconnect. 연결 사용한 모든 블록이 재연결 또는 제거할 때까지 “reconnect needed” 상태 표시. 같은 Google 계정으로 재연결이 재인덱싱 없이 연결 복원.

​

스코프 변경

초기 셋업 후 추가 스코프 필요하면 (예: 기존 Drive 전용 연결에 Gmail 스코프 추가):

1. Settings → Connections → Google Workspace → Update scopes.
2. 재인증; Google 이 새 동의 화면 표시.
3. 추가된 스코프의 새 블록 사용 가능.

​

관련

• 커넥터 — 일반 커넥터 개념.
• Source 블록 — Foundry 파이프라인의 Drive 사용.
• Tool 블록 — Agent 가 Google API 호출 방법.