Google Sheets
Permite que o agente leia, escreva e gerencie abas e intervalos de células em planilhas do Google Sheets. Requer uma Conexão Google Sheets configurada no workspace.
Ações disponíveis
Ao adicionar esta ferramenta, selecione quais operações o agente tem permissão de executar.
Listar abas
Retorna a lista de abas (sheets) de uma planilha, com suas propriedades.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID da planilha | Sim | — | ID da planilha do Google Sheets (encontrado na URL: docs.google.com/spreadsheets/d/{ID}/) |
Adicionar aba
Cria uma nova aba em uma planilha existente.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID da planilha | Sim | — | ID da planilha onde a aba será criada |
| Título | Sim | — | Nome da nova aba |
| Posição | Não | — | Posição da aba (baseada em 0). Se omitido, é adicionada ao final |
| Número de linhas | Não | 1000 | Número de linhas da nova aba |
| Número de colunas | Não | 26 | Número de colunas da nova aba |
Excluir aba
Remove uma aba de uma planilha.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID da planilha | Sim | — | ID da planilha que contém a aba |
| ID da aba | Sim | — | ID numérico da aba a excluir (obtido via "Listar abas") |
Ler intervalo
Lê os valores de um intervalo de células.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID da planilha | Sim | — | ID da planilha |
| Intervalo | Sim | — | Intervalo no formato A1 (ex: Sheet1!A1:D10, A1:C5, Sheet1!A:A). Incluir o nome da aba para maior precisão |
Atualizar intervalo
Substitui os valores de um intervalo de células pelos valores informados.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID da planilha | Sim | — | ID da planilha |
| Intervalo | Sim | — | Intervalo no formato A1 (ex: Sheet1!A1:C3) |
| Valores | Sim | — | Matriz bidimensional de valores (linhas × colunas). Ex: [["Nome", "Idade"], ["João", 30]] |
| Modo de entrada | Não | USER_ENTERED | Como interpretar os valores: USER_ENTERED (interpreta fórmulas e tipos) ou RAW (texto literal) |
Limpar intervalo
Remove os valores de um intervalo de células sem excluir a formatação.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID da planilha | Sim | — | ID da planilha |
| Intervalo | Sim | — | Intervalo a limpar no formato A1 (ex: Sheet1!A1:D10, A:C) |
Adicionar linhas
Adiciona novas linhas ao final de um intervalo ou tabela.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID da planilha | Sim | — | ID da planilha |
| Intervalo de referência | Sim | — | Intervalo de referência para localizar a tabela onde as linhas serão adicionadas (ex: Sheet1!A1) |
| Valores | Sim | — | Linhas a adicionar como matriz bidimensional. Ex: [["João", 30, "SP"], ["Maria", 25, "RJ"]] |
| Modo de entrada | Não | USER_ENTERED | Como interpretar os valores: USER_ENTERED ou RAW |
| Modo de inserção | Não | INSERT_ROWS | Como inserir os dados: INSERT_ROWS (insere novas linhas) ou OVERWRITE (sobrescreve) |