생산성 및 문서

Google Drive를 자율 AI 에이전트에 연결하기

Google Drive는 기업의 실제 문서를 보관합니다. Atako 에이전트는 Google 비밀번호를 절대 보지 않고도 파일을 정리하고 공유할 수 있습니다.

Atako 에이전트가 작성 · 검토·승인자 Romain Laodicina · Atako CTO

출시 예정 — 계정을 만들면 이 연동이 준비되는 즉시 알려드립니다.

가능한 워크플로우

고객 산출물 자동 정리

에이전트는 산출물(시안, 회의록, 청구서)이 들어오는 수신함 폴더를 감시합니다. get_file로 새 파일의 이름과 유형을 읽고, move_file로 알맞은 고객 폴더로 옮긴 뒤, rename_file로 정해진 규칙에 따라 이름을 바꿉니다. 잡동사니 폴더에 파일이 3주씩 방치되는 일이 사라집니다. grant는 에이전트의 활동 범위를 특정 폴더 하나 또는 여러 개로 제한하며, 절대 Drive 전체를 대상으로 하지 않습니다.

공유 권한 감사 및 정리

기업용 Drive에서는 공유 권한이 계속 쌓입니다. 예전 협력사, 퇴사한 인턴, 1년째 열려 있는 공개 링크 등입니다. 에이전트는 list_permissions로 활성 권한 목록을 조회하고, 회사 외부 주소나 공개 링크를 가리키는 항목을 찾아낸 뒤, delete_permission으로 접근 권한을 제거하기 전에 검토용 목록을 준비합니다. 매주 한 번만 확인해도 Drive를 깔끔하게 유지할 수 있습니다.

문서 모니터링 및 폴더 요약

에이전트는 search_files와 list_files로 공유 폴더(계약서, 회의록, 보고서)를 훑어보고, get_export_links로 내보내기 가능한 내용을 가져온 뒤, 추적용 파일에 요약을 작성해 넣습니다. 아무도 매주 처음부터 끝까지 다시 읽거나 수동으로 요약할 시간이 없는 법무 폴더나 회의록 모음처럼, 한 사람이 계속 최신 상태로 따라가기 어려운 규모의 자료에 유용합니다.

커넥터 작업

  • list_files

    읽기. 기본적으로 휴지통을 제외한 폴더의 파일 목록을 조회합니다.

  • search_files

    읽기. Drive 검색 쿼리로 파일을 검색합니다.

  • get_file

    읽기. 파일의 메타데이터(이름, 유형, 크기, 링크)를 가져옵니다.

  • get_export_links

    읽기. 파일의 내보내기 링크를 가져옵니다.

  • list_permissions

    읽기. 파일이나 공유 드라이브에 접근할 수 있는 사람 목록을 조회합니다.

  • create_folder

    쓰기. 필요하면 상위 폴더 안에 폴더를 생성합니다.

  • move_file

    쓰기. 파일을 다른 폴더로 이동합니다.

  • rename_file

    쓰기. 파일이나 폴더의 이름을 바꿉니다.

  • create_permission

    쓰기. 사용자, 그룹, 도메인과 파일을 공유합니다.

  • trash_file

    쓰기. 파일을 휴지통으로 이동합니다. 비우기 전까지는 복구할 수 있습니다.

사전 요구 사항

  • 연동을 연결하려면 Atako 기업 계정에 관리자 권한이 필요합니다.
  • 대상 Drive에 접근 권한이 있는 개인용 또는 Workspace Google 계정이 필요합니다.
  • Google OAuth 동의가 필요하며, 스코프는 전체 범위인 https://www.googleapis.com/auth/drive입니다.
  • 에이전트별 명시적인 grant가 필요합니다. 연결만으로는 아무 접근 권한도 주어지지 않습니다.

연결 방법

  1. 1

    설정 → 연동 열기

    관리자가 커넥터 목록에서 Google Drive를 선택합니다.

  2. 2

    노출되는 액션 확인

    연결 창에는 권한 부여 전 모든 읽기와 쓰기 액션이 나열됩니다.

  3. 3

    Google 화면에서 인증

    Google 동의 화면으로 리디렉션됩니다. 복사할 키도, 전달되는 비밀번호도 없습니다.

  4. 4

    에이전트에 접근 권한 부여

    에이전트 페이지에서 정확한 액션과 읽기 또는 쓰기 범위를 선택합니다.

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

Google Drive에는 계약서, 회의록, 고객 산출물 등 기업의 진짜 정보가 담겨 있는 경우가 많습니다. 여기에 접근할 수 있는 자율 에이전트는 매번 하나하나 지시를 받는 대신, 툴 콜링을 통해 스스로 폴더를 조회하거나 문서를 내보내거나 파일을 옮길 수 있습니다.

연결은 OAuth 2.0을 사용하며, 전체 범위 스코프인 https://www.googleapis.com/auth/drive를 씁니다(Google의 OAuth 스코프). Atako는 Google 비밀번호를 절대 저장하지 않으며, 플랫폼에는 암호화된 토큰만 남습니다.

에이전트는 매번 대화를 새로 시작하지 않아도 새 파일에 대해 계속 작동하며, 데이터 운영 에이전트와 비슷한 산출물 정리나 마케팅 운영 팀을 위한 콘텐츠 준비처럼 파일 양이 많아 수동 정리가 매일 번거로운 상황에 유용합니다.

모든 액션은 명시적인 grant를 거칩니다. Google Drive를 연결하는 것만으로는 관리자가 에이전트별로 어떤 액션을 호출할 수 있는지 정하기 전까지 아무 접근 권한도 주어지지 않습니다. 다른 커넥터와 마찬가지로 Google Drive를 다루는 스탠다드 플랜 상세를 참고하세요.

한계와 모범 사례

요청되는 OAuth 스코프는 범위가 넓습니다. 미리 선택된 폴더 하나가 아니라 연결된 Drive 전체를 포함합니다. 실질적인 제한은 grant 수준에서 이루어집니다. 각 에이전트에는 필요한 액션만 부여하고, 충분한 경우 읽기 전용으로 제한하세요.

delete_file은 휴지통을 거치지 않는 되돌릴 수 없는 삭제입니다. trash_file만 부여받은 에이전트는 언제든 되돌릴 수 있습니다. 영구 삭제는 정말 그 역할이 필요한 에이전트에만 부여하세요.

에이전트는 연결된 Google 계정이 접근 권한을 가진 파일에만 작동하며, 기존 권한을 우회하지 않습니다. 문서에는 이 연동 고유의 요청 속도 제한이 언급되어 있지 않으며, 대신 Google Drive API의 쿼터가 적용됩니다. 모든 호출은 에이전트의 감사 로그에서 확인할 수 있습니다.

관련 사용 사례

관련 통합

자주 묻는 질문

에이전트가 Google Drive에서 파일을 영구적으로 삭제할 수 있나요?

가능합니다. 다만 grant에 delete_file이 쓰기 스코프로 명시적으로 포함된 경우에만 그렇습니다. 이 grant가 없으면 되돌릴 수 있는 trash_file로 파일을 휴지통에 넣는 것만 가능합니다.

Atako의 Google Drive 접근 권한을 어떻게 철회하나요?

설정 → 연동에서 연결의 Revoke를 클릭하세요. 암호화된 토큰이 즉시 삭제되고, 이를 사용하던 모든 에이전트가 바로 접근 권한을 잃습니다.

에이전트가 제 개인 Drive의 모든 파일을 볼 수 있나요?

OAuth 스코프는 연결된 계정 전체를 포함하지만, 에이전트가 실제로 하는 일은 grant에 좌우됩니다. 액션을 읽기 전용이나 특정 폴더로 제한할 수 있습니다.

다음으로 읽을거리

출처

Romain Laodicina

Atako CTO

이 콘텐츠는 Atako의 AI 에이전트가 작성한 후, Atako CTO인 Romain Laodicina가 검토, 수정 및 승인했습니다.

첫 AI 에이전트를 배포하세요

무료로 계정을 만들고 코드 없이 몇 분 만에 에이전트를 실행하세요.

AI 트렌드에서 한 발 앞서세요.

제품 업데이트, 신규 에이전트, AI 분석 콘텐츠를 이메일로 바로 받아보세요. 스팸은 없으며 언제든 구독을 취소할 수 있습니다.