에이전트를 Google Drive에 연결하기(베타)

Notion 에이전트 또는 커스텀 에이전트를 Google Drive에 연결하면 에이전트가 실시간으로 파일을 검색하고 읽고 쓰고 업데이트할 수 있습니다.

이 연결은 설정한 사람에게 연결됩니다. 에이전트가 Google Drive를 사용하면 해당 사용자의 Drive를 실시간으로 확인합니다. Notion은 아무것도 저장하거나 인덱싱하지 않습니다. 에이전트는 해당 사용자가 소유한 파일, 공유받은 파일, 사용 권한이 있는 공유 드라이브에만 접근할 수 있습니다.

• 사용하려는 Google 계정에 로그인할 수 있는지 확인하세요.

• 게스트가 아닌 워크스페이스 멤버여야 하며, 워크스페이스에서 Notion AI가 활성화되어 있어야 합니다.

• Google Drive에 연결하려면 먼저 Google Workspace 소유자가 Custom Agents For Drive를 승인해야 할 수도 있습니다. 워크스페이스에서 Google Drive가 승인되지 않았다면 워크스페이스 소유자에게 승인을 요청하세요. 워크스페이스 소유자가 연결하면 해당 워크스페이스에서 Google Drive가 자동으로 승인됩니다.

• 사용 권한을 허용하기 전에 Google에 표시되는 권한을 검토하세요.

• 워크스페이스에서 허용할 연결을 관리하는 경우 워크스페이스 소유자가 커스텀 에이전트용 Google Drive를 켜야 할 수도 있습니다.

• 커스텀 에이전트를 Google Drive에 연결하는 방식은 Notion 에이전트용 Notion AI Google Drive 커넥터와 다릅니다.

Google Drive를 연결하는 방법에는 두 가지가 있습니다. 설정에서 Google 계정을 한 번 연결한 다음 원하는 에이전트에 추가할 수 있습니다. 또는 특정 에이전트에서 작업하는 동안 Google Drive를 추가할 수도 있습니다.

설정에서 연결하기

여러 에이전트에서 동일한 Google 계정을 사용하려는 경우 가장 빠른 방법입니다.

1. 설정 → 연결로 이동하세요.

2. Google Drive를 선택하세요.

3. 내 계정 → Google Drive 계정 연결을 선택하세요.

4. 제한된 사용 권한 또는 모두 허용을 선택한 다음 연결을 선택하세요.

5. 리마인더를 확인한 다음 Google로 계속을 선택하세요.

6. 사용하려는 Google 계정으로 로그인하세요.

7. 다음 Google 화면에서 Drive 확인란을 모두 선택하세요. 하나라도 선택하지 않으면 에이전트가 실행되지 않습니다.

Google 계정이 Notion에 연결되었습니다. 이제 커스텀 에이전트의 도구 및 사용 권한 설정에서 Google Drive를 추가할 수 있습니다.

에이전트에서 연결하기

1. 업데이트하려는 커스텀 에이전트를 여세요.

   • Notion 에이전트는

     설정 → 연결에서 연결한 Google 계정을 사용합니다. Notion 에이전트에서 추가로 설정할 것은 없습니다.

2. 에이전트의 설정 → 도구 및 사용 권한으로 이동하세요.

3. + 연결 추가 → Google Drive를 선택하세요.

4. 안내에 따라 Google에 로그인하고 사용 권한을 허용하세요. 다음 Google 화면에서 모든 Drive 확인란을 선택하세요. 하나라도 선택하지 않으면 에이전트가 실행되지 않습니다.

   • 선택 항목: 에이전트의 액세스 범위를 제한하려면면 특정 공유 드라이브나 폴더를 선택하세요.

5. 저장을 선택하세요.

연결이 완료되면 에이전트에 사용 권한을 부여할 대상을 세부적으로 지정할 수 있습니다. 에이전트의 도구 및 사용 권한 설정에서 에이전트가 보거나 편집할 수 있는 특정 Drive 파일이나 폴더를 선택하세요.

최상의 결과를 얻으려면 에이전트가 Drive 파일을 검색하거나 업데이트하도록 할 때 커스텀 에이전트의 지침이나 Notion 에이전트에 입력하는 프롬프트에 Google Drive를 언급하세요.

Google Drive를 추가할 때 에이전트가 수행할 수 있는 작업의 범위를 정하는 사용 권한 수준을 선택하게 됩니다. 이 설정은 나중에 변경할 수 있습니다.

• 제한된 사용 권한: 에이전트는 사용자가 읽을 수 있는 모든 파일을 읽을 수 있지만, 에이전트가 생성했거나 사용자가 선택한 파일만 편집할 수 있습니다.

• 모두 허용: 에이전트는 사용자의 기존 Drive 권한을 그대로 따릅니다. 사용자가 읽고 편집할 수 있는 모든 파일을 에이전트도 읽고 편집할 수 있습니다.

사용 권한 수준은 모든 에이전트에 적용됩니다. 변경하려면 Google Drive를 다시 연결하고 Drive 사용 권한 업데이트를 선택하세요. Notion 에이전트에는 항상 모두 허용 수준의 사용 권한이 적용됩니다. 커스텀 에이전트의 사용 권한을 특정 파일이나 폴더로 제한하려면 해당 에이전트의 도구 및 사용 권한 설정을 사용하세요.

Google에서 사용 권한 승인을 요청하는 경우: 이는 정상적인 설정 과정입니다. 원하는 Google 계정을 선택하고 요청 내용을 확인한 다음 계속 진행하세요. 이어서 Google에서 선택한 사용 권한 수준에 대한 Drive 권한을 표시합니다. Notion에 Google Drive가 연결되었다고 표시되면 연결이 완료된 것입니다.

관리자 검토가 필요하지 않을 수 있습니다: 많은 Google Workspace에서는 사용자가 직접 새 앱을 연결할 수 있습니다. 관리자가 Custom Agents For Drive에 별도의 규칙을 설정하지 않았다면 바로 연결할 수 있습니다. 관리자가 해당 앱에 대한 규칙을 설정한 경우에는 그 규칙이 우선 적용됩니다.

Notion에는 ‘연결됨’이라고 표시되지만 Google 로그인 화면이 나타나지 않는 경우: Notion에서 이전에 설정한 Google Drive 연결을 다시 사용하고 있을 수 있습니다. 연결이 정상적으로 작동한다면 문제가 없습니다. 잘못된 Google 계정이 사용되고 있거나 Drive가 작동하지 않는 경우, 도구 및 사용 권한에서 Google Drive를 제거한 다음 다시 연결하여 원하는 계정을 선택하세요.

Google Drive를 사용하는 모든 에이전트에서 제거하거나 특정 에이전트에서만 제거할 수 있습니다.

모든 에이전트에서 계정 제거하기

이 옵션을 선택하면 Google 계정을 사용 중인 모든 에이전트에서 연결이 해제됩니다.

• 설정 → 연결로 이동한 다음 Google Drive를 선택하세요.

• 내 계정을 선택하세요.

• 연결된 계정 옆의 연결 해제를 선택하고 확인하세요.

특정 에이전트에서 Google Drive 제거하기

1. 에이전트를 열고 도구와 사용 권한으로 이동하세요.

2. Google Drive 연결 옆에 있는 점 3개를 선택하세요.

3. 연결 해제를 선택합니다.

커스텀 에이전트를 Google Drive에 연결할 때 트리거를 설정하면 에이전트가 Google Drive의 변경 사항을 확인하도록 할 수 있습니다. 폴더(또는 Drive 링크)를 지정하고 변경 사항을 확인할 주기를 선택하세요. 변경 사항이 있으면 에이전트가 감지하고 실행됩니다. 폴더나 공유 드라이브를 모니터링할 수 있습니다. 단, 폴더에 직접 포함된 파일만 모니터링됩니다. 하위 폴더의 변경 사항은 에이전트를 트리거하지 않으며 내 드라이브 전체를 모니터링할 수도 없습니다.

다음 프롬프트 중 하나를 사용하여 에이전트와 Google Drive의 연결을 테스트해 보세요.

• “Google Drive에서 ‘로드맵’을 검색하고 찾은 내용을 알려줘.”

• “이번 주 내용을 간단히 요약해서 ‘주간 요약’이라는 Google 문서를 만들어 줘.”

Google Drive에 연결되면 에이전트는 다음과 같은 작업을 할 수 있습니다.

• 사용 권한이 있는 문서, 스프레드시트, 프레젠테이션을 검색할 수 있습니다.

• 부여한 사용 권한에 따라 기존 Google 문서, 스프레드시트, 프레젠테이션을 편집할 수 있습니다. PDF나 Word 문서 같은 다른 파일의 경우, 에이전트가 업데이트된 버전을 새 파일로 저장할 수 있습니다.

• 파일을 복사하거나 이동하고, 이름을 바꾸거나 휴지통으로 이동할 수 있습니다.

• 파일 콘텐츠를 실시간으로 읽고 요약할 수 있습니다.

• PDF의 텍스트를 읽을 수 있습니다.

• 새 문서, 스프레드시트, 프레젠테이션, 폴더를 만들 수 있습니다.

• 파일이 업데이트되면 트리거에 따라 작업을 수행할 수 있습니다.

에이전트가 작업할 수 있는 파일 형식

에이전트는 Google 문서, 스프레드시트, 프레젠테이션뿐 아니라 PDF, Word, Excel, PowerPoint, CSV, 일반 텍스트 파일(HTML, JSON, XML, YAML 포함)을 읽을 수 있습니다. PDF나 Office 파일 등 업로드하는 파일의 크기는 최대 10MB까지 지원됩니다. 용량이 매우 큰 Google 문서, 스프레드시트, 프레젠테이션의 경우 에이전트가 한 번에 파일의 일부만 읽을 수도 있습니다.

Google 드로잉, Google 지도, Google 설문지, 이미지, 동영상, 오디오, zip 파일은 에이전트가 읽을 수 없습니다. 이런 파일을 지정하면 에이전트가 파일을 열 수 없다고 알려줍니다. Google 드로잉과 기타 Google 파일 형식의 경우, 대신 Google Drive에서 파일을 열도록 요청합니다.

에이전트는 연결된 Google 계정에 사용 권한이 있는 대상에만 접근할 수 있습니다. 해당 Google 계정이 파일이나 폴더에 대한 사용 권한을 잃으면 에이전트도 접근할 수 없습니다.

편집자는 커스텀 에이전트의 Google Drive 연결을 제거할 수 있습니다. 폴더를 추가하는 등 사용 권한을 추가로 부여하는 작업은 해당 에이전트를 Google Drive에 연결한 사용자만 할 수 있습니다.

커스텀 에이전트에 필요한 공유 드라이브나 폴더로만 사용 권한을 제한하는 게 좋습니다. 이렇게 하면 에이전트가 작업에 집중할 수 있고 위험도 줄일 수 있습니다.

공유 커스텀 에이전트의 경우, 해당 에이전트에 사용 권한이 있는 사람이라면 누구나 연결된 Google Drive에 쿼리할 수 있습니다.

• 하나의 에이전트에 여러 Google 계정을 연결할 수 없습니다.

• 이 연결은 내 Google Workspace에 있는 파일에만 적용됩니다. 다른 Google Workspace에서 공유한 파일에는 커스텀 에이전트가 접근할 수 없습니다.

• 커스텀 에이전트가 공유된 경우, 해당 에이전트를 사용할 수 있는 사람은 누구나 연결된 Drive도 검색할 수 있습니다.

‘소속 기관의 관리자가 이 앱을 검토해야 합니다’

조직에서 앱에 필요한 권한 중 하나 이상을 승인하지 않으면 이 메시지가 표시됩니다. 이 문제는 관리자만 해결할 수 있습니다.

1. 사용 권한 요청을 선택하세요.

2. Google Workspace 관리자는 검토 대기 중인 앱에서 해당 요청을 확인할 수 있습니다.

3. 관리자가 앱과 필요한 모든 권한을 승인한 후 다시 연결해 보세요.

‘사용 권한 차단됨: 인증 오류’

관리자가 내 계정이나 그룹에서 해당 앱을 차단한 경우 이 메시지가 표시됩니다. Google Workspace 관리자에게 문의하세요. 연결하려면 관리자가 내 그룹에서 Custom Agents For Drive를 사용할 수 있도록 허용해야 합니다.

이전에는 작동했지만 지금은 작동하지 않는 경우

Google 사용 권한이 만료되거나 비활성화되었거나, 관리자가 규칙을 변경했을 수 있습니다.

1. 도구 및 사용 권한에서 Google Drive를 다시 연결하세요.

2. Google에서 관리자가 차단했다는 메시지가 표시되면 워크스페이스 관리자에게 문의하세요.

3. Google에서는 접근이 허용되지만 Notion에서 여전히 연결할 수 없는 경우, Notion 지원팀에 문의하여 표시되는 오류를 공유해 주세요.

사용자가 연결할 수 있도록 하려면 해당 그룹(조직 단위)에 대해 Custom Agents For Drive를 허용하고 사용 권한 수준에 따라 요구되는 모든 Google 권한을 승인하세요.

Google에서 사용자가 연결할 수 있는 앱을 결정하는 방식

관리자 콘솔의 API 제어 → 설정 → 구성되지 않은 타사 앱에서 기본 설정은 사용자가 새 앱을 직접 연결할 수 있도록 허용합니다. 이 기본 설정에서는 Custom Agents For Drive에 별도의 규칙을 설정하지 않았다면 관리자 검토 없이도 사용자가 해당 앱을 연결할 수 있습니다.

다른 설정에서는 기본 Google 로그인 정보만 허용하거나 모든 새 앱을 차단합니다. 특정 앱에 설정한 규칙은 기본 설정보다 우선 적용됩니다. 게스트는 별도의 그룹을 통해 관리됩니다.

이 설정은 앱 로그인 사용 권한에 적용됩니다. Google Workspace 마켓플레이스 설치는 별도로 관리됩니다.

Notion Agents For Drive 설정하기

관리자가 앱을 직접 설정하면 새 앱이 기본 로그인으로 제한되거나 차단되어 있어도 사용자가 연결할 수 있습니다.

1. 관리자 콘솔 → 보안 → 사용 권한 및 데이터 제어 → API 제어 → 앱 사용 권한 제어를 여세요.

2. 구성된 앱을 열고 새 앱 구성을 선택하세요.

3. 다음 OAuth 클라이언트 ID를 정확히 입력해 검색하세요.

   69206789846-avkmfeq0epeducrkoutjo361r8p5h103.apps.googleusercontent.com

4. 연결을 허용할 사용자가 속한 그룹을 선택하세요.

5. 앱에서 요청하는 모든 권한을 허용하려면 신뢰할 수 있음을 선택하세요. 또는 연결에 필요한 모든 Drive 및 Google 로그인 권한을 포함하려면 특정 Google 데이터를 선택하세요.

6. 선택 사항을 검토한 다음 완료를 선택하세요.

7. 변경 사항이 적용된 후 해당 사용자에게 다시 연결하도록 요청하세요.

앱 요청 검토

요청을 검토할 때 다음 사항을 확인하세요.

• 앱이 Custom Agents For Drive인지 확인하세요.

• 해당 사용자의 그룹에서 앱이 허용되어 있는지 확인하세요.

• 모든 Drive와 Google 로그인 권한이 ‘승인됨’ 상태인지 확인하세요.

• 하위 그룹 규칙으로 인해 앱이 차단되지 않았는지 확인하세요.

특정 Google 데이터를 선택한 경우, 연결에 필요한 모든 권한을 선택하세요.

Google Workspace 변경 사항이 적용되는 데 시간이 걸릴 수 있습니다. 변경 사항이 적용된 후 해당 사용자에게 다시 연결하도록 요청하세요.