跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

Agent 参与者

最后更新 查看 MarkdownAgent 设置

Agent Participant 可将服务器端 Agent 添加到 RealtimeKit 会议。任何能够建立 WebSocket 的后端(Cloudflare Worker、Durable Object 或你自己的服务器)都可以连接。无需客户端 SDK 或浏览器。

目前,Agent 可以接收实时会议活动,例如转录内容、参与者状态和广播。未来计划增加更多功能,包括发送消息和处理会议媒体。

Agent 可以执行的操作

参与者使用 RealtimeKit SDK 的浏览器和应用
RealtimeKit 会议
Agent 参与者由预设配置
我的代码Durable ObjectWebSocket ↔ JSON
参与者↔RealtimeKit 会议
Agent 参与者加入会议RealtimeKit 会议
Agent Participant监听 →Worker 或 Durable Object
Worker 或 Durable Object发送(规划中)→Agent Participant

Agent 是会议参与者。其预设决定加入会议的方式,其订阅决定接收哪些事件。

有关创建预设和选择订阅的信息,请参阅构建 Agent。有关 Agent 与人类参与者功能的比较,请参阅功能矩阵。

工作原理

我的 Worker
我的 Durable Object
Agent Participant
RealtimeKit 会议
使用 agent 预设添加参与者
start(token)
携带 token + 订阅进行升级
以可见或隐藏参与者身份加入
session.started
转录、加入、广播
以 JSON 形式发送已订阅事件
  1. 使用已配置的预设,通过 create-participant-api为 Agent 创建参与者。
  2. Durable Object 使用该 Agent 的参与者令牌打开 WebSocket。
  3. Agent 会加入会议,并转发你订阅的事件。
  4. 会话结束时,服务器会发送 session.ended 并关闭 WebSocket。

使用 Durable Objects 构建 Agent

选择 Agent

请决定会议参与者是否应该看到 Agent。无论选择哪种方式,Agent 收到的事件都相同。

你的 Agent 示例 其他参与者能否看到它
隐藏 Agent 合规监控、质量审核、实时会议分析 否
可见 Agent 显示在参与者列表中的会议记录员 是

目前尚不支持 Agent 讲话或发送聊天消息。请参阅功能矩阵。

计费

只要 Agent 保持连接,就会作为参与者计费。即使其他人都已离开,已连接的 Agent 也会使会话保持活动状态,因此后端必须将其移除。请参阅计费与结束会话。

参考

  • 构建 Agent:创建预设,在 Durable Object 中运行 Agent,并连接 WebSocket。
  • 事件:事件类型、载荷和传递规则。
  • 功能矩阵:Agent 与人类参与者的功能比较。

这篇文档对您有帮助吗?