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 블록이 있는 파운더리 파이프라인을 쓰세요. 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 블록 파운더리 파이프라인에서 Drive 쓰기.
• Tool 블록 Agent가 Google API를 부르는 방법.