> ## 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.

# Zoom

**Zoom** 使 Agent 能够与 Zoom 互动，允许它通过 Zoom API 安排会议、管理录制文件并处理各种与会议相关的操作。该工具包使用 Zoom 的服务器到服务器 OAuth 身份验证来实现安全的 API 访问。

## 前提条件

Zoom 工具包需要进行以下设置：

1. 安装必要的依赖项：

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

2. 在 Zoom Marketplace 中设置服务器到服务器 OAuth 应用：
   * 前往 [Zoom Marketplace](https://marketplace.zoom.us/)
   * 点击“Develop” → “Build App”
   * 选择“Server-to-Server OAuth”应用类型
   * 使用必需的作用域配置应用：
     * `/meeting:write:admin`
     * `/meeting:read:admin`
     * `/recording:read:admin`
   * 记下您的 Account ID、Client ID 和 Client Secret

3. 设置环境变量：

```shell theme={null}
export ZOOM_ACCOUNT_ID=your_account_id
export ZOOM_CLIENT_ID=your_client_id
export ZOOM_CLIENT_SECRET=your_client_secret
```

## 示例用法

```python theme={null}
from agno.agent import Agent
from agno.tools.zoom import ZoomTools

# 使用凭证初始化 Zoom 工具
zoom_tools = ZoomTools(
    account_id="your_account_id",
    client_id="your_client_id",
    client_secret="your_client_secret"
)

# 创建一个具有 Zoom 功能的 Agent
agent = Agent(tools=[zoom_tools], show_tool_calls=True)

# 安排会议
response = agent.print_response("""
安排一次团队会议，具体详情如下：
- Topic: Weekly Team Sync
- Time: Tomorrow at 2 PM UTC
- Duration: 45 minutes
""", markdown=True)
```

## 工具包参数

| 参数              | 类型    | 默认值    | 描述                             |
| --------------- | ----- | ------ | ------------------------------ |
| `account_id`    | `str` | `None` | Zoom 账户 ID（来自服务器到服务器 OAuth 应用） |
| `client_id`     | `str` | `None` | 客户端 ID（来自服务器到服务器 OAuth 应用）     |
| `client_secret` | `str` | `None` | 客户端密钥（来自服务器到服务器 OAuth 应用）      |

## 工具包函数

| 函数                       | 描述           |
| ------------------------ | ------------ |
| `schedule_meeting`       | 安排新的 Zoom 会议 |
| `get_upcoming_meetings`  | 获取即将举行的会议列表  |
| `list_meetings`          | 根据类型列出所有会议   |
| `get_meeting_recordings` | 获取特定会议的录制文件  |
| `delete_meeting`         | 删除已安排的会议     |
| `get_meeting`            | 获取特定会议的详细信息  |

## 速率限制

Zoom API 的速率限制因端点和账户类型而异：

* 服务器到服务器 OAuth 应用：100 次请求/秒
* 会议端点：根据账户类型有特定的限制
* 录制文件端点：速率限制较低，请查阅 Zoom 文档

有关详细的速率限制，请参阅 [Zoom API 速率限制](https://developers.zoom.us/docs/api/#rate-limits)。

## 开发者资源

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