Google Drive
Permite que o agente busque, baixe, envie, mova e exclua arquivos e pastas no Google Drive. Requer uma Conexão Google Drive configurada no workspace.
Ações disponíveis
Ao adicionar esta ferramenta, selecione quais operações o agente tem permissão de executar.
Buscar arquivos
Pesquisa arquivos e pastas no Drive com base em uma consulta.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| Consulta | Sim | — | Critério de pesquisa no formato do Drive (ex: name contains 'relatório', mimeType='application/pdf', 'me' in owners) |
| Máximo de resultados | Não | 10 | Número máximo de itens a retornar |
| Ordenar por | Não | modifiedTime desc | Critério de ordenação (ex: modifiedTime desc, name asc) |
| ID do Drive compartilhado | Não | — | ID de um Shared Drive para pesquisar. Se omitido, pesquisa no My Drive |
Obter arquivo
Retorna os metadados completos de um arquivo ou pasta pelo seu ID.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID do arquivo | Sim | — | ID único do arquivo ou pasta a obter |
Baixar arquivo
Retorna a URL de download de um arquivo no Drive. Para arquivos do Google Workspace (Docs, Sheets, Slides), é possível escolher o formato de exportação.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID do arquivo | Sim | — | ID único do arquivo a baixar |
| Formato de exportação | Não | — | Para arquivos do Google Workspace, o formato de destino (ex: application/pdf, text/csv, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet) |
Enviar arquivo
Faz o upload de um arquivo para o Drive. Também permite criar arquivos nativos do Google Workspace (Docs, Sheets, Slides) em branco.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| Nome | Sim | — | Nome do arquivo a criar no Drive |
| Conteúdo (base64) | Não | — | Conteúdo do arquivo codificado em base64. Omitir para arquivos nativos do Google Workspace |
| Tipo MIME | Não | application/octet-stream | Tipo do arquivo (ex: text/plain, application/pdf, application/vnd.google-apps.spreadsheet) |
| ID da pasta de destino | Não | — | ID da pasta onde salvar o arquivo. Se omitido, salva na raiz do My Drive |
| Descrição | Não | — | Descrição do arquivo |
Mover arquivo
Move ou renomeia um arquivo ou pasta no Drive.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID do arquivo | Sim | — | ID único do arquivo ou pasta a mover ou renomear |
| ID da pasta de destino | Não | — | ID da pasta de destino. Omitir para apenas renomear |
| Novo nome | Não | — | Novo nome do arquivo ou pasta. Omitir para apenas mover |
| ID da pasta de origem | Não | — | ID da pasta atual (necessário ao mover entre pastas para remover a referência anterior) |
Pelo menos um dos campos "ID da pasta de destino" ou "Novo nome" deve ser informado.
Excluir arquivo
Remove um arquivo ou pasta do Drive.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID do arquivo | Sim | — | ID único do arquivo ou pasta a remover |
| Mover para lixeira | Não | true | Se true, move o item para a lixeira (recuperável). Se false, exclui permanentemente |