Gmail을 자율 AI 에이전트에 연결하기

자율 AI 에이전트를 Gmail에 연결해야 하는 이유

Gmail은 고객, 공급사, 팀과의 소통이 모이는 곳입니다. 여기에 연결된 자율 에이전트는 단발성 지시에 답하는 데 그치지 않습니다. 툴 콜링 덕분에 받은 지시에 따라 메시지를 찾을지, 분류할지, 답변을 준비할지 스스로 판단하며 계속 작동합니다.

연결은 OAuth 2.0을 사용하며, 스코프는 https://www.googleapis.com/auth/gmail.modify입니다(Google의 Gmail 스코프). 이 스코프는 읽기, 작성, 발송을 허용하지만 메시지를 즉시 영구적으로 삭제하는 것은 허용하지 않습니다.

이 때문에 지원 편지함 분류 같은 흐름이 유용해지며, 이는 지원 분류나 지원 자동화 에이전트가 하는 일과 비슷합니다. 사람이 채팅 대화를 열기를 기다리지 않고 새 메시지가 도착할 때마다 받아 답변을 준비합니다. Gmail은 커넥터별 별도 청구 항목 없이 스탠다드 플랜이 다루는 연동에 포함되어 있습니다.

한계와 모범 사례

이 커넥터에서 가장 민감한 액션은 send_email입니다. 쓰기 스코프로 부여되면 에이전트는 사용자를 거치지 않고 바로 발송합니다. 가장 안전한 방식은 create_draft만 부여하는 것입니다. 에이전트가 준비하면 사람이 검토한 뒤 send_draft로 발송을 실행합니다.

gmail.modify 스코프는 특정 라벨이나 폴더가 아니라 연결된 편지함 전체를 대상으로 합니다. 따라서 실질적인 제한은 grant에서 나옵니다. 연결 시점에 모든 것을 한꺼번에 부여하기보다, 에이전트에 실제로 필요한 정확한 액션만 나열하세요.

문서에는 Gmail 커넥터 고유의 요청 속도 제한이 언급되어 있지 않습니다. 발송되었든 거부되었든 모든 호출은 에이전트 페이지의 감사 로그에서 확인할 수 있습니다. 다른 OAuth 계정과 마찬가지로 Google 측에서 토큰이 만료되거나 취소되면 재연결할 때까지 연결 상태가 오류로 표시됩니다.