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

前提条件

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

  1. 安装必要的依赖项:
pip install requests
  1. 在 Zoom Marketplace 中设置服务器到服务器 OAuth 应用:

    • 前往 Zoom Marketplace
    • 点击“Develop” → “Build App”
    • 选择“Server-to-Server OAuth”应用类型
    • 使用必需的作用域配置应用:
      • /meeting:write:admin
      • /meeting:read:admin
      • /recording:read:admin
    • 记下您的 Account ID、Client ID 和 Client Secret
  2. 设置环境变量:

export ZOOM_ACCOUNT_ID=your_account_id
export ZOOM_CLIENT_ID=your_client_id
export ZOOM_CLIENT_SECRET=your_client_secret

示例用法

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_idstrNoneZoom 账户 ID(来自服务器到服务器 OAuth 应用)
client_idstrNone客户端 ID(来自服务器到服务器 OAuth 应用)
client_secretstrNone客户端密钥(来自服务器到服务器 OAuth 应用)

工具包函数

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

速率限制

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

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

有关详细的速率限制,请参阅 Zoom API 速率限制

开发者资源