Google Calendar
Permite que o agente busque, crie, atualize e exclua eventos no Google Calendar. Requer uma Conexão Google Calendar configurada no workspace.
Ações disponíveis
Ao adicionar esta ferramenta, selecione quais operações o agente tem permissão de executar.
Buscar eventos
Pesquisa eventos no calendário com base em um critério de texto e filtros de data.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| Consulta | Sim | — | Texto a pesquisar nos eventos (título, descrição, local, etc.) |
| ID do calendário | Não | primary | ID do calendário onde pesquisar. Use primary para o calendário principal |
| Data/hora mínima | Não | — | Limite inferior de data dos eventos. Formato ISO 8601 (ex: 2024-01-01T00:00:00Z) |
| Data/hora máxima | Não | — | Limite superior de data dos eventos. Formato ISO 8601 (ex: 2024-12-31T23:59:59Z) |
| Máximo de resultados | Não | 10 | Número máximo de eventos a retornar |
Obter evento
Retorna os detalhes completos de um evento específico pelo seu ID.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID do evento | Sim | — | ID único do evento a obter |
| ID do calendário | Não | primary | ID do calendário que contém o evento |
Criar evento
Cria um novo evento no calendário.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID do calendário | Não | primary | ID do calendário onde criar o evento |
| Título | Sim | — | Título do evento |
| Descrição | Não | — | Descrição do evento |
| Local | Não | — | Local do evento |
| Início (data/hora) | Sim* | — | Data e hora de início no formato ISO 8601 (ex: 2024-06-01T10:00:00-03:00). Para eventos com horário |
| Início (data) | Não | — | Data de início para eventos de dia inteiro no formato YYYY-MM-DD. Use no lugar de "Início (data/hora)" |
| Término (data/hora) | Não | — | Data e hora de término no formato ISO 8601 |
| Término (data) | Não | — | Data de término para eventos de dia inteiro no formato YYYY-MM-DD |
| Fuso horário | Não | UTC | Fuso horário do evento (ex: America/Sao_Paulo) |
| Participantes | Não | — | Lista de participantes. Cada item deve ter email (string) e, opcionalmente, optional (boolean) — true para participação opcional, false (padrão) para obrigatória |
| Notificações | Não | none | Quem recebe convite por e-mail: all (todos), externalOnly (externos) ou none (ninguém) |
*Informe "Início (data/hora)" para eventos com horário definido, ou "Início (data)" para eventos de dia inteiro — não ambos.
Atualizar evento
Atualiza campos de um evento existente. Apenas os campos informados são alterados.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID do calendário | Não | primary | ID do calendário que contém o evento |
| ID do evento | Sim | — | ID único do evento a atualizar |
| Título | Não | — | Novo título do evento |
| Descrição | Não | — | Nova descrição do evento |
| Local | Não | — | Novo local do evento |
| Início (data/hora) | Não | — | Nova data e hora de início no formato ISO 8601 |
| Início (data) | Não | — | Nova data de início para evento de dia inteiro no formato YYYY-MM-DD |
| Término (data/hora) | Não | — | Nova data e hora de término no formato ISO 8601 |
| Término (data) | Não | — | Nova data de término para evento de dia inteiro no formato YYYY-MM-DD |
| Fuso horário | Não | UTC | Fuso horário do evento |
| Participantes | Não | — | Nova lista de participantes. Cada item deve ter email (string) e, opcionalmente, optional (boolean) |
| Notificações | Não | none | Quem recebe notificação da atualização: all, externalOnly ou none |
Excluir evento
Remove um evento do calendário.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID do calendário | Não | primary | ID do calendário que contém o evento |
| ID do evento | Sim | — | ID único do evento a excluir |
| Notificações | Não | none | Quem recebe notificação de cancelamento: all, externalOnly ou none |