GoogleCalendarToolkit

GoogleCalendarToolkit da a un agente un conjunto de herramientas para trabajar con tu Google Calendar: consultar eventos, crear eventos nuevos y modificar los que ya existen. También le permite saber la fecha y la hora actuales, para entender peticiones como “mañana a las diez”. El agente decide cuándo usar cada herramienta durante la conversación.

Cuándo usarlo

• Un asistente que agenda citas con clientes.
• Consultar la agenda de la semana y avisar de los huecos libres.
• Mover una reunión a otra hora cuando alguien lo pide.

Configuración

Necesitas una credencial Google Calendar, que se conecta iniciando sesión con tu cuenta de Google. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Google Calendar de la cuenta cuyo calendario usa el agente.
Token String	No hace falta rellenarlo: el acceso se toma de la credencial.
Scopes	No hace falta rellenarlo: los permisos se toman de la credencial.

Herramientas

Herramienta	Qué hace
get_current_datetime	Devuelve la fecha y la hora actuales en una zona horaria.
list_events	Lista los eventos del calendario, filtrando por fecha de inicio, fecha de fin y título.
create_new_event	Crea un evento con título, inicio y fin, y opcionalmente lugar, descripción e invitados.
update_exist_event	Modifica un evento existente: título, horario, lugar, descripción o invitados.

Resultado

La salida BaseToolkit es el conjunto de herramientas. Conéctala al conector de herramientas de un agente.

Ejemplo

Una clínica quiere un asistente que dé citas.

1. Añade GoogleCalendarToolkit con la credencial Google Calendar de la agenda de la clínica.
2. Conecta BaseToolkit al agente.
3. En las instrucciones del agente, indica la duración de cada cita y que compruebe con list_events que el hueco está libre antes de crearla.

Buenas prácticas

• Indica en las instrucciones del agente la zona horaria con la que trabajas.
• Para modificar un evento, el agente necesita encontrarlo antes: pídele que lo busque por fecha y título.
• El conjunto no incluye una herramienta para eliminar eventos.

Componentes relacionados

• Calendar Event: una operación concreta sobre eventos.
• Tool Mode: cómo usa un agente las herramientas.