> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plazbot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Calendar

> Nodo de Calendario e integración con Google Calendar de Plazbot

### Introducción

Este nodo se encarga de realizar operaciones de lectura y registro con el calendario de Google integrado.

<img style={{ borderRadius: '0.5rem', width: '500px', display: 'block', margin: '0 auto' }} src="https://mintcdn.com/plazbot/bTtw7JfHRFfT5J0p/images/automation/calendar-1.png?fit=max&auto=format&n=bTtw7JfHRFfT5J0p&q=85&s=019b78acf9e45faf00c0d83c34bc689c" alt="Automatizaciones" width="1104" height="795" data-path="images/automation/calendar-1.png" />

### Integracióm con Google Calendar

Con el nodo de Google Calendar puedes realizar las siguientes operaciones:

* **\[Recurso: evento]** Crear eventos
* **\[Recurso: evento]** Listar eventos
* **\[Recurso: calendario]** Verificar disponibilidad

***

### Parámetros

* **Fecha inicio, fecha final:**\
  Podrás elegir una variable o, si has abierto un tool en Calendar, podrás asignarlo para que el valor sea asignado automáticamente.

* **Título, descripción:**\
  Podrás elegir una variable o, si has abierto un tool en Calendar, podrás asignarlo para que el valor sea asignado automáticamente.\
  Estos campos estarán disponibles en la operación de **crear evento**.

### Consideraciones

* El **calendario principal** tiene como nombre el **correo que has integrado**.
* Al asignar **asignación automática** en tools, se realizará la asignación de fechas **relativa al timezone configurado** para el workspace.
* Cuando uses la **asignación manual** para fecha inicio y fecha final, deberá tener el formato: YYYY-MM-DDTHH:mm:ss.sss±HH:mm

Esto lo puedes definir manualmente en la acción **"Editar campos"** o en un **prompt del nodo IA**.

### Prompts con Tools

* Cuando un tool es definido de forma **automática**, **requiere ser llamado manualmente en el prompt**.
* En la parte donde definas tu flujo, esta llamada debe tener una estructura similar a:

ejecutar la herramienta "Nombre de la herramienta"

* Debes colocar el **nombre exacto de la herramienta** con el fin de que pueda ejecutarse correctamente.

### Tools

Este nodo se encarga de realizar operaciones de lectura y registro con el calendario de Google integrado.

<img style={{ borderRadius: '0.5rem', width: '500px', display: 'block', margin: '0 auto' }} src="https://mintcdn.com/plazbot/bTtw7JfHRFfT5J0p/images/automation/calendar-2.png?fit=max&auto=format&n=bTtw7JfHRFfT5J0p&q=85&s=3a828b616d2840db46cd8af5a24a9c99" alt="Automatizaciones" width="877" height="723" data-path="images/automation/calendar-2.png" />

<Tip>
  ✅ En tools se habilitará la **asignación automática de valor** para los siguientes parámetros:

  * `fecha inicio`
  * `fecha final`
  * `título`
  * `descripción`

  Esto significa que, si deseas que la IA asigne el valor dependiendo de la conversación realizada, podrás hacerlo.\
  Tú podrás elegir **qué parámetro será asignado automáticamente**.
  Para activarlo presionar el icono de varita mágica ubicado en cada Campo a editar
</Tip>

Para poder agregar un tool, deberas tener creado un nodo IA, al tener está tendrás habilidado la creación de tool.

<img style={{ borderRadius: '0.5rem', width: '500px', display: 'block', margin: '0 auto' }} src="https://mintcdn.com/plazbot/bTtw7JfHRFfT5J0p/images/automation/calendar-3.png?fit=max&auto=format&n=bTtw7JfHRFfT5J0p&q=85&s=f7576d6fae5bb5183e199241ddbf538c" alt="Automatizaciones" width="906" height="880" data-path="images/automation/calendar-3.png" />

La plataforma usa dos tipos de tools:

👉 **Tools Manuales**

* Son tools donde **obligatoriamente debes brindar contexto** al momento de definir que tu "tool" será manual.
* Es necesario ya que el **nodo IA validará primero los tools manuales**, intentando hacer *match* con alguna instrucción o mensaje dado por el usuario.

<img style={{ borderRadius: '0.5rem', width: '500px', display: 'block', margin: '0 auto' }} src="https://mintcdn.com/plazbot/bTtw7JfHRFfT5J0p/images/automation/calendar-4.png?fit=max&auto=format&n=bTtw7JfHRFfT5J0p&q=85&s=8935d29b5bf1062de851af471ca74250" alt="Automatizaciones" width="330" height="425" data-path="images/automation/calendar-4.png" />

⚡ Ejemplo de uso

* Tool configurado para **obtener los eventos de un día definido**\
  (nótese que no está incluido en un flujo; más bien es un *trigger* que espera que el usuario tenga esa intención).

👉 **Tools Automáticos**

* Son tools donde **no se brinda el contexto en la configuración del "tool"**, sino que el contexto es dado **en el propio prompt**, con el fin de que forme parte de un flujo.
* La principal diferencia con los tools manuales es que **el tool será ejecutado por llamado del prompt y no por alguna intención del usuario.**

<img style={{ borderRadius: '0.5rem', width: '500px', display: 'block', margin: '0 auto' }} src="https://mintcdn.com/plazbot/bTtw7JfHRFfT5J0p/images/automation/calendar-5.png?fit=max&auto=format&n=bTtw7JfHRFfT5J0p&q=85&s=e809fd75d2cd06a4a969c787cc37ff52" alt="Automatizaciones" width="336" height="270" data-path="images/automation/calendar-5.png" />

⚡ Ejemplo de uso

* En un flujo de **cita médica**, después de haber definido el motivo y la fecha en la que el usuario desea asignar una cita, se llama a una herramienta que permite **conocer la disponibilidad en un día específico**.
