博客/产品

如果你使用编码智能体来基于 LiveKit 进行构建,你可能已经注意到,它很擅长快速搭建一个语音智能体。它可以编写智能体代码、接入电话号码、使用智能体调试器或模拟进行测试,并完成部署,全程无需离开你的编辑器或 CLI。

但如果你想围绕智能体做其他事情,比如创建新项目、邀请队友、添加 webhook,或深入排查一通出错的通话,你仍然需要打开 LiveKit Cloud 仪表盘自己动手。

今天,这一切改变了。

LiveKit Cloud API 现已进入开放测试版,它让你的编码智能体能够完成你在仪表盘中(几乎)能做的一切。它可以创建和配置项目、管理成员和 webhook,并拉取智能体通话的转写、日志、trace 和录音。而且它执行所有这些操作时都以你的身份登录,因此只能执行你的角色所允许的操作。

你的编码智能体现在能做什么#链接到本节

设置和管理 LiveKit Cloud#链接到本节

过去,项目设置需要在仪表盘中完成。现在,你的编码智能体可以创建项目、选择其数据区域、开启 PII 脱敏或 Agent Observability、邀请你的队友,并添加你的 webhook。它甚至可以发送测试事件来检查 webhook 是否正常工作。

例如,你可以这样问:

1Create a new LiveKit Cloud project called acme-staging in the EU data region with2PII redaction turned on. Invite dev@acme.com to it, and add a webhook to3https://staging.acme.com/livekit for room and participant events.

你不需要编码智能体也能使用这些功能。LiveKit Cloud API 是一个 REST API,因此如果你的团队管理大量项目,你可以自己编写脚本完成同样的设置。完整的端点列表见 API 参考.

分析你的通话中发生了什么#链接到本节

A coding agent asked "What are the most common issues this week?" runs lk analytics session list --limit 100 --json, flags 142 sessions where the caller interrupted the agent, and concludes that callers interrupt long answers.

如果你的项目已开启 Agent Observability,你的编码智能体现在可以读取你在仪表盘中看到的同一份会话数据:

1lk analytics session list --user-auth                     # recent sessions, filtered by date, room or status2lk analytics session transcript <session-id> --user-auth  # the conversation, turn by turn3lk analytics session logs <session-id> --user-auth        # your agent's logs for that call4lk analytics session traces <session-id> --user-auth      # trace spans5lk analytics session metrics <session-id> --user-auth     # session metrics6lk analytics session recording <session-id> --user-auth   # the audio or chat history

这意味着你可以把一通糟糕的通话交给它,问它哪里出了问题,或者让它查看整整一周的通话:

1Pull my agent's sessions from the last 7 days with lk analytics. Read the transcripts,2group the problems you find, and rank them by how many calls they affected. Tell me3what to fix first. Don't change any code yet.

我们在 LiveKit 自己的文档助手上试过这一点。只需一条提示词,我们的编码智能体就读取了过去一周的 4,321 个会话,并在大约 30 分钟的工作后返回了一份按优先级排序的 8 个问题清单,其中包括由链式工具调用导致的缓慢轮次,以及人们问到但未能得到解答的文档主题。

在此基础上,你的编码智能体可以把一通真实通话转化为模拟场景,修复代码,并重新运行该场景直到通过。

以你的身份登录执行操作#链接到本节

到目前为止, lk cloud auth 会在你的机器上保存一个项目 API 密钥,而该密钥可以在项目中执行任何操作。使用新的登录方式后,CLI 会基于与你的 LiveKit 账户绑定的会话运行:

  • 你在浏览器中登录一次。登录状态持续 30 天,你可以随时通过 lk cloud auth --revoke --user-auth.
  • 每条命令都会获得一个短期令牌,该令牌会根据你在项目中的角色进行校验。
  • 敏感操作仅限项目管理员执行,包括读取转写和录音以及创建 API 密钥。
  • 在你自己的机器上运行智能体仍然需要使用项目 API 密钥。

你现有的用于购买电话号码以及设置 SIP 和 dispatch 的命令,同样适用于新的登录方式。

立即试用#链接到本节

更新 LiveKit CLI,登录,并安装 LiveKit 技能:

1brew update && brew upgrade livekit-cli    # needs 2.19.4 or later2lk cloud auth --user-auth                  # sign in through your browser3lk skills install --global                 # teach your coding agent the new commands

在 Linux 或 Windows 上?请参阅 CLI 文档.

请你在终端中自行执行登录步骤。该步骤需要你在浏览器中确认,因此你的编码智能体无法代你完成。

这些技能会教 Claude Code、Codex、Cursor 及其他编码智能体如何使用新命令。安装完成后,打开你的编码智能体,尝试上述任一提示词。

须知#链接到本节

  • 目前仍是测试版。在稳定版发布前,端点仍可能发生变化。
  • 会话数据需要 Agent Observability。你的编码智能体只能读取在 Agent Observability 开启期间记录的调用。对于通过 API 创建的项目,该功能默认关闭。
  • 只有项目管理员才能读取会话内容。转写记录、日志、trace 和录音可能包含客户数据。
  • PII 脱敏设置会延续生效。如果你的项目已开启该功能,你的编码智能体获取到的转写记录与仪表板显示的同样经过脱敏。
  • API 请求免费。它们受套餐的速率限制。在开始任何计费操作之前,你的编码智能体会先征求你的同意,例如开启 Agent Observability、购买电话号码或运行模拟。
  • 它目前尚不支持 CI。每次调用都以已登录用户的身份执行,并且登录状态每 30 天需在浏览器中续期一次。

相关

11.10.2026

推出适用于 ROS 2 的 LiveKit Portal

阅读
10.08.2026

使用 Agent Simulations 测试语音智能体

阅读
09.22.2026

LiveKit 推出 Private Links

阅读