Com o Google Drive conectado, a Lumina busca seus arquivos pelo nome e pelo conteúdo, lê documentos, planilhas, apresentações e PDFs, e usa o que encontrou na resposta. Você também pode anexar arquivos do Drive a um chat ou sincronizar pastas na base de conhecimento de um projeto ou agente. Na página de conexões, o card aparece como Google Workspace.
O que a Lumina faz#
| Pode | Não pode |
|---|---|
| buscar arquivos pelo nome e pelo conteúdo, em todo o Drive ou numa pasta | reescrever um arquivo que já existe, ou editar Apresentações Google e arquivos do Office |
| navegar pelas pastas, inclusive drives compartilhados a que você tem acesso | mudar compartilhamento ou permissões |
| ler Google Docs, Planilhas, Apresentações, PDFs e arquivos do Office | ler atalhos (só o arquivo para onde o atalho aponta) |
| anexar até 50 arquivos de uma vez a um chat | ler arquivos grandes demais para indexar |
| sincronizar uma pasta inteira, com ou sem subpastas, na base de um projeto ou agente | copiar arquivos, ou movê-los entre o Meu Drive e um drive compartilhado |
| salvar no Drive um arquivo do chat ou um anexo, como Documento, Planilha ou Apresentação Google | apagar de vez: a lixeira do Google esvazia sozinha depois de 30 dias |
| criar pastas, renomear e mover dentro do mesmo drive | salvar numa pasta que a organização compartilhou como fonte, que é só leitura |
| mandar um arquivo ou uma pasta para a lixeira e restaurar o que a Lumina mandou | |
| acrescentar texto ao fim de um Documento Google e linhas numa Planilha Google |
Toda alteração passa por um cartão de confirmação no chat: nada muda no Drive antes de você clicar em confirmar, e cada cartão faz uma alteração só.
Antes de conectar#
- Funciona com conta Google pessoal ou do Google Workspace.
- Se a sua empresa restringe o acesso de apps de terceiros no Google Workspace, o administrador pode precisar liberar a Lumina antes.
Como conectar#
- Na barra lateral, abra Conexões.
- No card Google Workspace, clique em Conectar.
- Na janela Conectar Google Drive, escolha Entrar com Google.
- Entre na sua conta Google e autorize o acesso. A autorização passa primeiro por uma página do Composio, o parceiro de integração que a Lumina usa com o Google, e em seguida pela tela de consentimento do Google.
A opção Configuração avançada (admin de TI) é para o administrador que usa uma service account própria (veja abaixo).
O que pedir no chat#
- "Tenho algum documento sobre a política de reembolso no Drive?"
- "O que tem na pasta Projetos/2026?"
- "Ache o contrato com a ACME e me diga a data de renovação."
- "Compare as planilhas de orçamento de 2025 e 2026."
- "Salve este relatório na pasta Clientes do meu Drive."
- "Crie a pasta Propostas 2027 no drive compartilhado do Comercial."
- "Mova a planilha de orçamento para a pasta Arquivo."
- "Mande o rascunho antigo para a lixeira."
- "Acrescente a ata de hoje no fim do documento Reuniões 2026."
- "Adicione estas três vendas na planilha Pipeline, aba Novembro."
Para anexar um arquivo específico: no chat, clique em Anexar arquivo → Anexar de fonte conectada. Para levar uma pasta à base de um projeto ou agente, use Sincronizar pasta inteira no seletor de arquivos.
Salvar e organizar arquivos
Quando você pede para salvar, criar, renomear, mover ou mandar para a lixeira, a Lumina mostra um cartão com o que vai acontecer: o nome, o formato e o caminho completo da pasta. Nada muda até você confirmar.
- Documentos do chat viram Documento Google, planilhas viram Planilha Google e apresentações viram
Apresentação Google. Se você pedir o arquivo do Office (
.docx,.xlsxou.pptx), ele é salvo assim. Anexos do Word, do Excel e do PowerPoint também são convertidos; os demais são salvos como estão. O arquivo pode ter até 4 MB. - Se você não disser a pasta, a Lumina pergunta antes, sugerindo a raiz do Meu Drive e as pastas que você usou por último.
- Se já existir um item com o mesmo nome na pasta, a Lumina numera o novo, por exemplo
Relatório (1). O cartão de resultado mostra o nome final e o link Abrir no Google Drive. - Mover só funciona dentro do mesmo drive: no Meu Drive, ou dentro de um mesmo drive compartilhado. Se a pasta está compartilhada, o cartão avisa que quem tinha acesso só pela pasta antiga pode perder o acesso.
- A lixeira do Google Drive guarda o item por 30 dias, e dá para restaurá-lo até lá. Se o item está compartilhado, o cartão avisa antes. A Lumina restaura só o que ela mesma mandou para a lixeira; o resto você restaura pela lixeira do Drive.
- Mandar para a lixeira depende do seu papel: num drive compartilhado, o Google costuma exigir administrador ou gerente de conteúdo. Se o Google recusar, nada muda e a Lumina diz o motivo.
- Agentes agendados não salvam no Google Drive: eles entregam o arquivo na execução, e você salva pelo chat.
Acrescentar a um documento ou a uma planilha
A Lumina acrescenta conteúdo a arquivos que já existem, sem reescrever o resto:
- Num Documento Google, o texto entra como um parágrafo novo no fim. O cartão mostra o texto exato antes de você confirmar.
- Numa Planilha Google, as linhas entram logo abaixo das que já estão preenchidas, na aba que você disser. Se a planilha tem mais de uma aba e você não disse qual, a Lumina pergunta. O cartão mostra o cabeçalho da aba e as linhas que vão entrar.
- Apresentações Google e arquivos do Office guardados no Drive (
.docx,.xlsx,.pptx) não são editados. A Lumina explica e oferece salvar uma cópia convertida para o formato Google, com o conteúdo novo; o original não muda.
Reconectar com permissão de edição
Se a sua conexão foi feita só para leitura, na primeira vez que você pedir para salvar ou organizar algo o cartão mostra o botão Reconectar com permissão de edição. Ele abre a autorização do Google e traz você de volta para o mesmo chat. Entre com a mesma conta Google da conexão; depois, é só pedir de novo.
Uma pasta que a organização compartilhou como fonte continua só leitura. Para salvar arquivos, conecte a sua própria conta Google.
Limitações#
- A Lumina só altera o seu Drive quando você confirma no cartão, uma alteração por vez.
- Arquivos acima do limite de tamanho são recusados, e o seletor mostra o tamanho e o limite.
- Arquivos protegidos por senha, corrompidos ou só com imagem podem não ser lidos.
- Pastas sincronizadas recebem mudanças quase em tempo real. Se as atualizações em tempo real ficarem indisponíveis, a sincronização passa a ser diária e uma mudança pode levar até 24 horas.
Problemas comuns#
| O que aparece | Causa provável | O que fazer |
|---|---|---|
| "Sua conexão expirou. Reconecte a conta." | o acesso foi revogado ou expirou no Google | clique em Reconectar |
| "Falta uma permissão nesta conexão" | a autorização não incluiu a leitura do Drive | reconecte e aceite todas as permissões |
| "Grande demais para indexar" | o arquivo passa do limite de tamanho | reduza ou divida o arquivo no Drive |
| "É um atalho, não o arquivo." | foi escolhido um atalho | abra o atalho no Drive e escolha o arquivo original |
| "Esta fonte pode estar desatualizada" | a sincronização automática não terminou recentemente | clique em Sincronizar agora |
| "Falta a permissão de edição" num cartão do chat | a conexão foi feita só para leitura | clique em Reconectar com permissão de edição no próprio cartão |
| "Entre com a mesma conta Google desta conexão para reconectar." | você entrou com outra conta Google | reconecte com a conta que aparece no card da conexão |
| A Lumina diz que só o dono ou um gerente pode mandar o item para a lixeira | o seu papel no item ou no drive compartilhado não permite | peça ao dono do arquivo ou a um gerente do drive compartilhado |
| A Lumina diz que não deu para confirmar se a alteração aconteceu | o Google não respondeu a tempo | abra a pasta no Google Drive e confira antes de pedir de novo |
Para o administrador ou TI#
Na conexão normal, a autorização é feita pelo app verificado do Composio, que pede estes escopos do Google:
| Escopo | Para quê |
|---|---|
drive | buscar, listar e ler arquivos |
userinfo.email, openid | identificar a conta conectada no card |
O app do Composio não oferece o escopo só de leitura do Drive, então o escopo concedido permite alterar arquivos. A Lumina só altera arquivos quando o usuário pede no chat e confirma no cartão, uma alteração por vez: salvar, criar pasta, renomear, mover dentro do mesmo drive, mandar para a lixeira, restaurar o que ela mesma mandou e acrescentar texto a um Documento Google ou linhas a uma Planilha Google. Nenhuma chamada compartilha, muda permissões ou apaga de vez. Uma conexão antiga, feita só para leitura, ganha a edição quando o usuário clica em Reconectar com permissão de edição no cartão.
Se o Google Workspace da empresa bloqueia apps de terceiros, libere o app do Composio, o parceiro de integração que a Lumina usa com o Google, em Admin Console → Segurança → Acesso e controle de dados → Controles de API.
Service account própria. Em Configuração avançada (admin de TI), o administrador cola o JSON de uma service account do Google Cloud da empresa e clica em Validar e conectar. Se a service account usa delegação em todo o domínio, autorize os mesmos escopos acima em Controles de API → Delegação em todo o domínio e informe o e-mail a impersonar. A chave privada é guardada criptografada.
Privacidade e desconexão#
A conexão é sua: dá acesso só ao que a sua conta Google alcança, e só você a usa. Ela vale só na organização em que foi feita.
Para desconectar, abra Conexões, clique em … no card e em Desconectar. O conteúdo que as fontes desta conexão trouxeram sai de todos os agentes, projetos e chats e deixa de ser usado nas respostas. Essa ação não pode ser desfeita.