Google Calendar
Gestiona los eventos de Google Calendar desde el agente.
Google Calendar
Permite que el agente busque, cree, actualice y elimine eventos en Google Calendar. Requiere una conexión con Google Calendar configurada en el workspace.
Las operaciones disponibles
Al añadir esta herramienta, elige qué operaciones puede ejecutar el agente.
Buscar eventos
Busca eventos en el calendario por texto y filtros de fecha.
| Parámetro | Obligatorio | Por defecto | Qué es |
|---|---|---|---|
| Consulta | Sí | — | El texto que buscar en los eventos (título, descripción, ubicación, etc.) |
| ID del calendario | No | primary | El calendario donde buscar. Usa primary para el principal |
| Fecha/hora mínima | No | — | El límite inferior de fecha. ISO 8601 (p. ej. 2024-01-01T00:00:00Z) |
| Fecha/hora máxima | No | — | El límite superior de fecha. ISO 8601 (p. ej. 2024-12-31T23:59:59Z) |
| Máximo de resultados | No | 10 | Cuántos eventos devolver como mucho |
Obtener un evento
Devuelve los detalles completos de un evento por su ID.
| Parámetro | Obligatorio | Por defecto | Qué es |
|---|---|---|---|
| ID del evento | Sí | — | El ID único del evento |
| ID del calendario | No | primary | El calendario que contiene el evento |
Crear un evento
Crea un evento nuevo en el calendario.
| Parámetro | Obligatorio | Por defecto | Qué es |
|---|---|---|---|
| ID del calendario | No | primary | El calendario donde crearlo |
| Título | Sí | — | El título del evento |
| Descripción | No | — | La descripción del evento |
| Ubicación | No | — | La ubicación del evento |
| Inicio (fecha/hora) | Sí* | — | La fecha y hora de inicio, ISO 8601 (p. ej. 2024-06-01T10:00:00-03:00). Para eventos con horario |
| Inicio (fecha) | No | — | La fecha de inicio para eventos de todo el día, YYYY-MM-DD. Úsalo en lugar de «Inicio (fecha/hora)» |
| Fin (fecha/hora) | No | — | La fecha y hora de fin, ISO 8601 |
| Fin (fecha) | No | — | La fecha de fin para eventos de todo el día, YYYY-MM-DD |
| Zona horaria | No | UTC | La zona horaria del evento (p. ej. America/Sao_Paulo) |
| Asistentes | No | — | La lista de asistentes. Cada elemento necesita email (string) y, opcionalmente, optional (boolean): true para asistencia opcional, false (por defecto) para obligatoria |
| Notificaciones | No | none | Quién recibe la invitación por correo: all, externalOnly o none |
*Indica «Inicio (fecha/hora)» para un evento con horario, o «Inicio (fecha)» para uno de todo el día; no ambos.
Actualizar un evento
Actualiza los campos de un evento existente. Solo cambian los campos que indiques.
| Parámetro | Obligatorio | Por defecto | Qué es |
|---|---|---|---|
| ID del calendario | No | primary | El calendario que contiene el evento |
| ID del evento | Sí | — | El ID único del evento que actualizar |
| Título | No | — | El nuevo título del evento |
| Descripción | No | — | La nueva descripción del evento |
| Ubicación | No | — | La nueva ubicación del evento |
| Inicio (fecha/hora) | No | — | La nueva fecha y hora de inicio, ISO 8601 |
| Inicio (fecha) | No | — | La nueva fecha de inicio para un evento de todo el día, YYYY-MM-DD |
| Fin (fecha/hora) | No | — | La nueva fecha y hora de fin, ISO 8601 |
| Fin (fecha) | No | — | La nueva fecha de fin para un evento de todo el día, YYYY-MM-DD |
| Zona horaria | No | UTC | La zona horaria del evento |
| Asistentes | No | — | La nueva lista de asistentes. Cada elemento necesita email (string) y, opcionalmente, optional (boolean) |
| Notificaciones | No | none | A quién se notifica la actualización: all, externalOnly o none |
Eliminar un evento
Quita un evento del calendario.
| Parámetro | Obligatorio | Por defecto | Qué es |
|---|---|---|---|
| ID del calendario | No | primary | El calendario que contiene el evento |
| ID del evento | Sí | — | El ID único del evento que eliminar |
| Notificaciones | No | none | A quién se notifica la cancelación: all, externalOnly o none |