Conecte seus agentes ao Google Drive (beta)

Você pode conectar seu Agente do Notion ou seus Agentes Personalizados ao Google Drive para que eles possam buscar, ler, escrever e atualizar arquivos em tempo real.

Esta conexão está vinculada à pessoa que a configurou. Quando seu agente usa o Google Drive, ele verifica seu Drive em tempo real. Nada é salvo ou indexado pelo Notion. O agente só pode acessar arquivos que você possui, arquivos que foram compartilhados com você e quaisquer drives compartilhados aos quais você tenha acesso.

• Confira se você consegue fazer login na conta do Google que quer usar.

• Você precisa ser membro do espaço de trabalho, não ter acesso como convidado, e a IA do Notion precisa estar ativada nele.

• O proprietário do seu Google Workspace pode precisar aprovar o app Agentes Personalizados para o Drive para você conseguir se conectar. Se o Google Drive não estiver aprovado para seu espaço de trabalho, peça a um proprietário que o aprove. Quando um proprietário do espaço de trabalho se conecta, o Google Drive é automaticamente aprovado para o espaço de trabalho.

• Revise as autorizações mostradas pelo Google antes de permitir o acesso.

• Se o seu espaço de trabalho controla quais conexões são permitidas, um proprietário do espaço de trabalho pode precisar ativar o Google Drive para Agentes Personalizados.

• Conectar Agentes Personalizados ao Google Drive é diferente do conector do Google Drive para IA do Notion, que é destinado ao Agente do Notion.

Você pode conectar o Google Drive de duas maneiras. Conecte sua conta do Google uma vez nas configurações e adicione-a a qualquer agente. Ou adicione o Google Drive enquanto trabalha em um agente específico.

Conectar pelas configurações

Esta é a maneira mais rápida se você quiser usar a mesma conta do Google em mais de um agente.

1. Acesse Configurações → Conexões.

2. Selecione Google Drive.

3. Selecione Sua conta → Conectar sua conta do Google Drive.

4. Escolha Acesso limitado ou Acesso completo, então selecione Conectar.

5. Leia o lembrete e selecione Continuar para o Google.

6. Faça login com a conta do Google que você deseja usar.

7. Na próxima tela do Google, marque todas as caixas do Drive. Se alguma ficar desmarcada, seus agentes não conseguirão funcionar.

Sua conta do Google agora está conectada ao Notion. Você pode adicionar o Google Drive a qualquer Agente Personalizado nas configurações de Ferramentas e acesso dele.

Conectar pelo agente

1. Abra o Agente Personalizado que você deseja atualizar.

   • O Agente do Notion usa a conta do Google que você conecta em

     Configurações → Conexões. Não é preciso configurar nada extra no Agente do Notion.

2. Vá para Configurações → Ferramentas e acesso do agente.

3. Selecione + Adicionar conexão → Google Drive.

4. Siga as etapas para fazer login no Google e permitir o acesso. Na próxima tela do Google, marque todas as caixas do Drive. Se alguma ficar desmarcada, seus agentes não conseguirão funcionar.

   • Opcional: escolha drives compartilhados ou pastas específicas para limitar o que o agente pode acessar.

5. Selecione Salvar.

Assim que estiver conectado, você pode escolher exatamente o que seu agente pode acessar. Nas configurações de Ferramentas e acesso do agente, escolha os arquivos ou pastas específicos do Drive que você deseja que o agente possa visualizar e/ou editar.

Para garantir a melhor qualidade, mencione o Google Drive nas instruções do seu Agente Personalizado ou no seu prompt para o Agente do Notion quando quiser que ele busque ou atualize arquivos do Drive.

Ao adicionar o Google Drive, você escolhe o que o agente pode fazer. É possível mudar isso depois.

• Acesso limitado: seu agente pode ler todos os arquivos que você pode ler, mas só pode editar os arquivos que ele criou ou que você selecionou.

• Acesso completo: seu agente usa as mesmas permissões que você tem no Drive. Ele pode ler e editar todos os arquivos que você pode ler e editar.

Seu nível de acesso se aplica a todos os seus agentes. Para alterá-lo, reconecte o Google Drive e escolha Atualizar acesso ao Drive. O Agente do Notion sempre usa seu nível de acesso completo. Para limitar um Agente Personalizado a arquivos ou pastas específicos, use as configurações de Ferramentas e acesso dele.

O Google pede que você aprove o acesso: isso faz parte da configuração. Escolha a conta do Google que quer usar, confira o que está sendo solicitado e continue. Em seguida, o Google mostra as permissões do Drive para o nível de acesso que você escolheu. A conexão estará pronta quando o Notion informar que o Google Drive está conectado.

Talvez você não precise da aprovação de um administrador: muitos espaços de trabalho do Google Workspace permitem que as pessoas conectem novos apps por conta própria. Se o administrador não definiu uma regra especial para o app Agentes Personalizados para o Drive, talvez você consiga se conectar na hora. Depois que um administrador define uma regra para o app, é essa regra que vale.

O Notion diz "Conectado", mas você nunca viu um login do Google: o Notion pode reutilizar uma conexão do Google Drive que você configurou anteriormente. Isso é normal quando ela ainda funciona. Se ele estiver usando a conta do Google errada, ou se o Drive não estiver funcionando, remova o Google Drive em Ferramentas e acesso, depois conecte novamente e escolha a conta que você quer usar.

Você pode remover o Google Drive de todos os agentes que o utilizam ou apenas de um agente.

Remover sua conta de todos os agentes

Isso desconecta sua conta do Google de todos os agentes que a estavam utilizando.

• Acesse Configurações → Conexões e selecione Google Drive.

• Selecione Sua conta.

• Ao lado da sua conta conectada, selecione Desconectar e confirme.

Remover o Google Drive de um agente

1. Abra o agente e vá para Ferramentas e acesso.

2. Selecione os três pontos ao lado da conexão do Google Drive.

3. Selecione Desconectar.

Ao conectar um Agente Personalizado ao Google Drive, você pode configurar um gatilho para que ele verifique se há alterações. Para isso, indique uma pasta (ou um link do Drive) e escolha a frequência da verificação. Se algo mudar, o agente detecta a alteração e entra em execução. Você pode monitorar uma pasta ou um drive compartilhado. Só os arquivos diretamente dentro da pasta são monitorados. Alterações em subpastas não acionam o agente, e você não pode monitorar todo o seu Meu Drive.

Experimente um destes prompts para testar a conexão do seu agente com o Google Drive:

• “Faça uma busca no Google Drive por ‘roadmap’ e me diga o que você encontrar.”

• “Crie um Google Doc chamado ‘Resumo semanal’ com um breve resumo desta semana.”

Uma vez conectado ao Google Drive, seu agente pode:

• Fazer buscas em Docs, Planilhas e Slides aos quais você tem acesso.

• Editar Google Docs, Planilhas e Slides existentes, dependendo do acesso que você conceder. Para outros arquivos, como PDFs ou documentos do Word, seu agente pode salvar uma versão atualizada como um novo arquivo.

• Copiar, mover, renomear e mover arquivos para a lixeira.

• Ler e resumir o conteúdo de arquivos em tempo real.

• Ler o texto de um PDF.

• Criar novos documentos, planilhas, apresentações e pastas.

• Agir em resposta a um gatilho quando os arquivos forem atualizados.

Tipos de arquivo com os quais seu agente pode trabalhar

Seu agente pode ler Google Docs, Planilhas e Slides, além de PDFs, Word, Excel, PowerPoint, CSV e arquivos de texto sem formatação (incluindo HTML, JSON, XML e YAML). Arquivos enviados, como PDFs e arquivos do Office, podem ter até 10 MB. Para Google Docs, Planilhas ou Slides muito grandes, seu agente pode ler apenas parte do arquivo por vez.

Ele não pode ler Desenhos Google, Google Maps, Google Forms, imagens, vídeos, áudios ou arquivos zip. Se você direcionar o agente para um desses, ele informará que não consegue abrir o arquivo. Para Desenhos Google e outros tipos de arquivo do Google, ele solicitará que você abra o arquivo no Google Drive.

Seu agente só tem acesso ao que a conta do Google conectada pode acessar. Se essa conta do Google perder o acesso a um arquivo ou pasta, o agente também perderá o acesso.

Editores podem remover a conexão do Google Drive para um Agente Personalizado. Somente a pessoa que conectou o agente ao Google Drive pode adicionar mais acesso (como adicionar mais pastas).

É melhor limitar o acesso apenas aos drives compartilhados ou pastas de que seu Agente Personalizado precisa. Isso ajuda o agente a manter o foco e reduz riscos.

Em um Agente Personalizado compartilhado, qualquer pessoa com acesso a esse agente pode consultar o Google Drive conectado.

• Conectar-se a mais de uma conta do Google por agente.

• Esta conexão só funciona com arquivos no seu Google Workspace. Se um arquivo for compartilhado de um Google Workspace diferente, o Agente Personalizado não conseguirá acessá-lo.

• Se o Agente Personalizado for compartilhado, qualquer pessoa que puder usar o agente também poderá fazer buscar no Drive ao qual ele está conectado.

"O administrador da sua instituição precisa analisar este app"

Você verá isso quando sua organização não tiver aprovado uma ou mais autorizações de que o app precisa. Somente um administrador pode corrigir isso.

1. Selecione Solicitar acesso.

2. Seu administrador do Google Workspace recebe a solicitação em Apps aguardando análise.

3. Tente se conectar novamente depois que o administrador aprovar o app e todas as autorizações necessárias.

"Acesso bloqueado: erro de autorização"

Você verá isso se o administrador tiver bloqueado o app para sua conta ou seu grupo. Entre em contato com o administrador do Google Workspace. Ele precisa autorizar o Agentes Personalizados para o Drive para o seu grupo antes que você possa se conectar.

Funcionava antes, mas parou

Seu acesso ao Google pode ter expirado ou sido desativado, ou seu administrador pode ter alterado uma regra.

1. Reconecte o Google Drive em Ferramentas e acesso.

2. Se o Google mostrar um bloqueio de administrador, entre em contato com seu administrador do espaço de trabalho.

3. Se o Google permitir o acesso, mas o Notion ainda não conseguir se conectar, entre em contato com o suporte do Notion e compartilhe o erro que você vê.

Para permitir que alguém se conecte, autorize o Agentes Personalizados para o Drive para o grupo (unidade organizacional) dessa pessoa e aprove todas as permissões do Google solicitadas pelo nível de acesso dela.

Como o Google decide quais apps as pessoas podem conectar

No seu painel de administrador, em Controles de API → Configurações → Apps de terceiros não configurados, a configuração padrão permite que as pessoas conectem novos apps por conta própria. Com essa configuração, as pessoas podem conectar o Agentes Personalizados para o Drive sem sua análise, desde que você não tenha definido uma regra específica para ele.

As outras configurações só permitem informações básicas de login do Google ou bloqueiam todos os novos apps. As regras definidas para um app específico substituem a configuração padrão. Os convidados são gerenciados pelo próprio grupo.

Essa configuração controla o acesso para fazer login nos apps. As instalações do Google Workspace Marketplace são gerenciadas separadamente.

Configurar o Notion Agents para o Drive

Se você configurar o app, as pessoas poderão se conectar mesmo que novos apps estejam limitados ao login básico ou bloqueados.

1. Abra o painel de administrador → Segurança → Controle de acesso e dados → Controles de API → Controle de acesso a apps.

2. Abra Apps configurados e selecione Configurar novo app.

3. Busque este ID de cliente OAuth exato:

   69206789846-avkmfeq0epeducrkoutjo361r8p5h103.apps.googleusercontent.com

4. Escolha os grupos das pessoas que poderão se conectar.

5. Escolha Confiável para permitir todas as autorizações solicitadas pelo app ou Dados específicos do Google para incluir todas as autorizações do Drive e de login do Google necessárias para a conexão.

6. Revise suas escolhas e selecione Concluir.

7. Peça à pessoa para conectar novamente após a alteração entrar em vigor.

Analisar uma solicitação de app

Ao analisar uma solicitação, verifique se:

• O app é o Agentes Personalizados para o Drive.

• O app está autorizado para o grupo da pessoa.

• Todas as autorizações do Drive e de login do Google foram aprovadas.

• Uma regra de subgrupo não está impedindo a conexão sem que ninguém perceba.

Para Dados específicos do Google, selecione todas as permissões que a conexão solicitar.

As alterações no Google Workspace podem levar algum tempo. Peça à pessoa para conectar novamente após a conclusão da alteração.