Google Calendar | ElevenLabs Documentation

概述

将 ElevenLabs AI 智能体连接到 Google Calendar，管理日程和日历预约。通过此集成，智能体可通过自然对话查看可用时间、创建、更新和删除包含参会者及可选 Google Meet 会议的活动，列出即将开始的活动，并发现可访问的日历。

功能

功能	支持情况
零保留模式（ZRM）	不支持
工具中的附件	不支持——工具仅处理文本

安全警告

安全警告：google_calendar_update_event 和 google_calendar_delete_event 是特权工具。 它们拥有所连接 Google 账户的完整日历访问权限，而不只是智能体创建活动的访问权限。任何可与智能体交谈的人都能更改或取消该日历中的任何活动，包括并非其创建的活动，因为智能体可通过 google_calendar_list_events 查找活动 ID。系统提示词中的确认只是给模型的提示，并非安全控制措施。

仅在已启用身份验证的智能体上启用这些工具，或仅在活动 ID 来自可信来源时启用。请勿将它们添加到公开智能体。活动更新或删除时，始终会通知参会者。

设置

此集成使用 Google OAuth 2.0 进行身份验证。你将授权 ElevenLabs 代表你访问 Google Calendar。

在 ElevenLabs 中点击连接

在 ElevenLabs 集成设置中，点击连接。系统会跳转至 Google 以授权访问。

选择 Google 账户

选择智能体应访问其日历数据的 Google 账户。如果浏览器已登录多个 Google 账户，请选择正确的账户。

授权访问日历

查看所请求的权限，然后点击允许。此集成会请求管理你拥有日历中活动的权限、查看日历列表的权限，以及查看忙闲信息的权限。

OAuth 范围

此集成会请求以下 Google OAuth 2.0 范围：

范围	用途
`calendar.events.owned`	创建、读取、更新和删除你拥有日历中的活动。
`calendar.calendarlist.readonly`	查看账户可访问的日历列表（名称和 ID）。
`calendar.freebusy`	查看跨日历的忙闲情况，不会暴露活动详情。

工作原理

智能体通过工具调用逐步完成预约流程。下方标签页展示高级概述和详细系统提示词。

高级概述

详细系统提示词

发现日历

智能体会列出可访问的日历，以确定用于安排日程的正确日历。对大多数用户而言，这就是主日历。

查看可用时间

智能体会通过以下方式查看忙闲情况：

使用 google_calendar_check_availability 工具查询繁忙时间段。
确认请求的时间是否空闲。
如果请求时间与现有活动冲突，则建议其他时间。
与来电者确认选定时间。

收集参会者信息

确定时间后，智能体会：

收集参会者的全名和邮箱地址。
向来电者复述邮箱以确认。
核实时区信息。

创建活动

智能体会：

使用确认的信息调用 google_calendar_create_event 工具。
如需视频会议，可选择添加 Google Meet 链接。
确认活动已创建，并告知参会者将收到日历邀请。

智能体工具

向智能体添加 Google Calendar 工具后，可使用以下内置工具：

工具	说明
`google_calendar_check_availability`	查看一个或多个日历在指定时间范围内的忙闲情况。返回繁忙时间段，以便智能体找到空闲时段。创建活动前使用此工具，避免冲突。
`google_calendar_create_event`	在 Google Calendar 中创建新活动，可选择添加参会者、地点和 Google Meet 会议。会向所有参与者发送邮件通知。
`google_calendar_list_events`	列出日历在指定时间范围内即将开始的活动，并按开始时间排序。支持在活动摘要、描述、地点和参会者详情中进行自由文本搜索。
`google_calendar_update_event`	特权。更新日历中的任何活动，例如重新安排时间，或修改标题、地点或参会者。仅会修改提供的字段。会通知参会者。
`google_calendar_delete_event`	特权。删除日历中的任何活动，并为所有参会者取消该活动。请先列出活动以查找活动 ID。对于定期活动，请使用某次活动的 ID 或其 recurringEventId（整个系列）。
`google_calendar_list_calendars`	列出所连接 Google 账户可访问的所有日历。返回日历名称和 ID。请在查看可用时间或创建活动前使用此工具，以确定目标日历。

概述

功能