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

# Google Calendar

启用 Agent 使用 Google Calendar 来查看和安排会议。

## 先决条件

### 安装依赖项

```shell theme={null}
pip install tzlocal
```

### 设置 Google 项目和 OAuth

参考：[https://developers.google.com/calendar/api/quickstart/python](https://developers.google.com/calendar/api/quickstart/python)

1. 启用 Google Calendar API

   * 前往 [Google Cloud Console](https://console.cloud.google.com/apis/enableflow?apiid=calendar-json.googleapis.com)。
   * 选择项目并启用。

2. 前往 API 和服务 -> OAuth 同意屏幕

3. 选择用户类型

   * 如果您是 Google Workspace 用户，请选择内部。
   * 否则，请选择外部。

4. 填写应用详情（应用名称、徽标、支持电子邮件等）。

5. 选择范围

   * 点击添加或删除范围。
   * 搜索 Google Calendar API（确保您已启用 Google Calendar API，否则范围将不可见）。
   * 根据需要选择范围
     * 从下拉列表中勾选 `/auth/calendar` 范围
   * 保存并继续。

6. 添加测试用户

   * 点击添加用户并输入您希望在测试期间允许的用户电子邮件地址。
   * 注意：在“测试”模式下，只有这些用户才能访问应用的 OAuth 功能。
     其他任何用户将收到访问被拒绝的错误。
   * 要使应用可供所有用户使用，您需要将应用的
     状态移至“生产”。
     在此之前，请确保在应用使用敏感或受限范围的情况下，已获得 Google 的完全验证。
   * 点击返回到控制台。

7. 生成 OAuth 2.0 客户端 ID

   * 前往凭据。
   * 点击创建凭据 -> OAuth 客户端 ID
   * 选择应用类型为桌面应用。
   * 下载 JSON。

8. 使用 Google Calendar 工具
   * 将下载的凭据路径作为 `credentials_path` 传递给 Google Calendar 工具。
   * 可选：设置 `token_path` 参数以指定工具应创建 `token.json` 文件的位置。
   * `token.json` 文件用于存储用户的访问和刷新令牌，并在授权流程中自动创建（如果尚不存在）。
   * 如果未显式提供 `token_path`，文件将在默认位置（您当前的工作目录）创建。
   * 如果选择指定 `token_path`，请确保您提供的目录具有写入权限，因为应用程序在身份验证过程中需要创建或更新此文件。

## 示例

以下 Agent 将使用 GoogleCalendarTools 来查找今天的事件。

```python cookbook/tools/googlecalendar_tools.py theme={null}
from agno.agent import Agent
from agno.tools.googlecalendar import GoogleCalendarTools
import datetime
import os
from tzlocal import get_localzone_name

agent = Agent(
    tools=[GoogleCalendarTools(credentials_path="<PATH_TO_YOUR_CREDENTIALS_FILE>")],
    show_tool_calls=True,
    instructions=[
        f"""
        You are scheduling assistant . Today is {datetime.datetime.now()} and the users timezone is {get_localzone_name()}.
        You should help users to perform these actions in their Google calendar:
            - get their scheduled events from a certain date and time
            - create events based on provided details
        """
    ],
    add_datetime_to_instructions=True,
)

agent.print_response("Give me the list of todays events", markdown=True)
```

## Toolkit 参数

| 参数                 | 类型    | 默认     | 描述                                               |
| ------------------ | ----- | ------ | ------------------------------------------------ |
| `credentials_path` | `str` | `None` | 包含 OAuth 2.0 Client ID 的 credentials.json 文件的路径。 |
| `token_path`       | `str` | `None` | 存储用户访问和刷新令牌的 token.json 文件的路径。                   |

## Toolkit 函数

| 函数             | 描述             |
| -------------- | -------------- |
| `list_events`  | 列出用户主要日历中的事件。  |
| `create_event` | 在用户主要日历中创建新事件。 |

## 开发者资源

* 查看 [Tools](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/googlecalendar.py)
* 查看 [Cookbook](https://github.com/agno-agi/agno/blob/main/cookbook/tools/googlecalendar_tools.py)