Reuniones y Google Calendar

El calendario permite al agente de IA convertir una conversación en una reunión real. Está configurado en en AI → Calendario y lo utiliza un agente a través de cuatro herramientas: espacios disponibles, reservar, reprogramar y cancelar.

Google Calendar es el proveedor disponible hoy. El tiempo de ejecución en sí está escrito en una interfaz neutral para el proveedor, por lo que los tipos de reuniones, las reservas y las herramientas de los agentes no dependen de las características específicas de Google.

Conexión de una cuenta

Presione Conectar Google Calendar. La ventana de autorización se abre con un estado único que está vinculado a su bot y a su cuenta y vence después de cinco minutos , usa PKCE y regresa a una dirección de redireccionamiento exacta. El acceso solicitado se limita a la lista del calendario, los eventos del calendario y la información de disponibilidad.

El token de actualización se almacena cifrado y nunca se vuelve a mostrar. la conexión La tarjeta muestra solo la etiqueta de la cuenta y uno de cuatro estados: Conectado, Acceso caducado, Desactivado o Error. Si el acceso caduca, vuelva a conectar la cuenta .

Desconectar calendario está bloqueado mientras un agente activo todavía tiene las herramientas de calendario habilitadas: el panel nombra a esos agentes. Primero elimine las herramientas o ponga en pausa el agente .

Tipos de reunión

Un tipo de reunión es lo que realmente ofrece el agente. Cada uno contiene:

• Nombre que se muestra a usted en los informes y al cliente en el evento.
• Calendario elegido de la cuenta conectada. El identificador del calendario guardado se almacena cifrado y no se vuelve a mostrar, por lo que al editar un tipo de reunión se le solicita que elija el calendario una vez más.
• Duración — de 5 a 480 minutos.
• Zona horaria: un nombre de IANA como Europe/Berlin. Define lo que significan las horas disponibles de a continuación.
• Horas disponibles: de 1 a 28 intervalos semanales indicados como límites HH:MM por día de la semana. Los intervalos no deben superponerse; un intervalo cuyo final es antes de su inicio transcurre después de la medianoche.
• Aviso mínimo: de 0 a 1440 minutos antes de la salida, por debajo del cual se rechaza la reserva .
• Con qué anticipación se permiten reservas: de 1 a 366 días.
• Búfer antes y Búfer después: de 0 a 1440 minutos cada uno, libre durante toda la reunión.
• Tipo de reunión habilitado: solo se pueden ofrecer o reservar los tipos habilitados.

Mostrar espacios disponibles muestra una vista previa del resultado real para la próxima semana, utilizando el calendario conectado en lugar de una simulación.

Cómo se elige un espacio

La disponibilidad se calcula a partir de cuatro entradas a la vez: las horas semanales del tipo de reunión , los intervalos de ocupación informados por el calendario, los buffers y las reservas que ya existen para esa conexión. Las salidas de los candidatos se toman cada 15 minutos; de forma predeterminada, se devuelven 10 espacios y nunca más de 20.

Las horas se muestran en la zona horaria del cliente y se almacenan en UTC, por lo que un cambio de horario de verano cambia la hora local ofrecida en lugar del momento almacenado.

La reserva es deliberadamente cuidadosa:

1. El slot elegido se vuelve a validar, inmediatamente antes de escribir algo.
2. Una reserva pendiente se almacena con una clave de idempotencia, por lo que una solicitud repetida No se puede crear una segunda reunión.
3. El evento se crea en el calendario, opcionalmente con un enlace de video.
4. Si el proveedor se agota o responde con un error que se puede volver a intentar, busca la reserva mediante su clave de idempotencia antes de volver a intentar algo, por lo que un tiempo de espera ambiguo no produce un duplicado.
5. Sólo entonces se confirma la reserva. El identificador del evento del proveedor y el enlace de la reunión se almacenan cifrados.

Reprogramar y cancelar sigue la misma disciplina, y una reserva cuyo espacio ya no está disponible falla en lugar de realizar una sobreventa.

Los estados de reserva son Pendiente, Confirmado, Reprogramado, Cancelado, y Error.

Dar las herramientas a un agente

En el editor del agente, en Herramientas permitidas, habilite las acciones de calendario que desea:

• Mostrar espacios disponibles
• Reservar una reunión
• Reprogramar una reunión
• Cancelar una reunión

Cada herramienta de calendario habilitada debe enumerar al menos un tipo de reunión habilitada actual ; De lo contrario, el control de lanzamiento se niega a activar un agente. Un agente activo solo puede usar herramientas de calendario; todavía no se puede ejecutar ninguna otra herramienta en producción.

El modelo nunca elige un calendario, un cliente o una solicitud sin procesar. Sólo puede proponer una llamada cuyos argumentos coincidan con el esquema cerrado de la herramienta, y el bot, el suscriptor y los tipos de reuniones permitidos se toman del servidor. contexto. Las llamadas de herramientas tienen una fecha límite de 15 segundos, están determinadas por el turno y la posición de la llamada, y se almacenan con enlaces de reuniones y detalles de contacto redactados.

Informes

AI → Analytics muestra las acciones del calendario y los resultados de las reservas junto a otras métricas de agentes, y AI → Calendar enumera las reservas en sí.

Solución de problemas

• Las herramientas de calendario están habilitadas, pero no hay ningún tipo de reunión habilitado: cree una o habilite una existente antes de activar el agente.
• No se pudo cargar la lista del calendario: es posible que sea necesario volver a conectar la cuenta ; se puede ingresar manualmente un identificador de conexión como respaldo temporal de .
• No hay espacios libres en la próxima semana: verifique las horas semanales, el aviso mínimo de , los buffers y si el calendario está completamente ocupado.
• El tipo de reunión está en uso y no se puede eliminar: las herramientas de calendario de un agente activo de hacen referencia a él.

Páginas relacionadas

• Respuestas y agentes de IA: configuración y herramientas del agente.
• Fuentes de conocimiento: de qué responde el agente.
• Integraciones: otros servicios conectados.