Agent Kavor:让对话随你同行
让 CodingAgent 继续工作,自己离开电脑,也能保持联系。Agent Kavor 让你通过 Channels 发送请求、查看回复并 参与决策。首个可用的 Channel 是 WhatsApp。
Agent Kavor 不是另一个模型,也不是替代 CodingAgents 的托管 agent,而是通过 Channels 与它们沟通的体验。 工作仍在 Kavor 的 Workspaces 中进行。Channel 也不是 Node 或 Canvas Connection:它传递对话,图谱仍决定 agent 的上下文与能力。
开始之前
- 保持 desktop 上的 Kavor 正在运行、已登录且能联网。电脑不能进入睡眠。
- 准备好 Workspace 和已配置的 CodingAgent,包括 harness 及其身份验证。
- 使用你有权关联为设备的 WhatsApp 账户。Self-chat 是最简单的起点。
请求仍受 CodingAgent 配置、provider 限制和人工控制约束。手机上的消息不能绕过 desktop 上等待中的审批。
1. 在 desktop 关联账户
- 在 Kavor 顶部栏打开 Channels。
- 开始关联 WhatsApp。扫描 QR code,或选择 Link with a code,然后在对应的 WhatsApp 账户中确认。 关联代码不是短信登录。
- 等待连接确认。一次明确发起且成功完成的关联会启用 Channel。
- 在 Personal chat 中选择 Self-chat。如果关联的是另一个账户,也可以将 Another number 配置为 个人收件目标。设置自动保存。
设置中的发送测试只使用显示的个人目标,不会启动 CodingAgent 工作,也不会向所有群组广播。使用前请确认目标。
2. 在 Self-chat 选择 Workspace 和 agent
打开 WhatsApp 中的个人对话。引导会先让你选择 Workspace,再选择 CodingAgent。回答这些选择,并在发送第一个请求前 检查上下文确认信息。
观看 WhatsApp 中选择 Workspace 和 agent 的演示 → (在新标签页中打开)
个人对话会保留选择。无需重新关联即可查看或切换上下文:
| 你的目标 | 命令 |
|---|---|
| 查看已选 Workspace 和 agent | /context |
| 列出 Workspaces | /workspaces |
| 在个人对话中切换 Workspace | /workspace "我的项目" |
| 列出 Workspace 中的 agents | /agents |
| 选择默认 agent | /agent "Reviewer" |
| 查看运行状态而非请求分析 | /status |
| 查看可用命令和示例 | /help |
请使用 Kavor 实际显示的名称。使用 @Reviewer 这样的明确提及,可以向另一个 agent 发请求而不改变默认选择。
状态查询显示运行状态,不证明实现已通过测试或评审。
3. 远程参与工作
向已选 agent 发送明确请求,例如:
检查当前任务的测试结果,不要修改代码。告诉我哪些通过、哪些失败,以及你实际查阅了什么证据。
在同一对话中跟进进度和回复。如果 agent 需要决策,请使用对应问题提供的选项或要求的格式回答。 发送确认不等于完成确认。
观看远程请求及 CodingAgent 完整回复 → (在新标签页中打开)
你可以交换图片、视频、音频和文件,可带文字也可不带。能否理解这些格式取决于 harness 及可用工具;Kavor 不承诺 自动转录,也不保证每个 agent 都能理解任意媒体。
受管理的附件及其临时副本会在成功上传七天后过期。读取或重试不会延长期限。附件过期后请重新发送;过期不会删除 你的原始文件或消息文字。
4. 用 Workspace 群组区分项目
如果需要持续绑定项目的对话,而不想在 Self-chat 中切换 Workspace,可以使用群组。
- 关联后,在 Workspace groups 选择所需 Workspaces 并确认创建群组。也可以在 Workspace 的 Channels 标签中 管理关联并选择已有群组。
- 检查每个 Workspace 的结果。新群组名为
Kavor · Workspace 名称。 - 打开群组,通过
/agents和/agent "名称"选择 CodingAgent,或明确提及一个 agent。
群组的 Workspace 固定不变。你可以在该项目内切换默认 agent,但 /workspace 不能更换群组的项目。
新增 Workspaces 不会自动获得群组。
观看 Workspace 专属群组的创建与打开过程 → (在新标签页中打开)
谨慎选择参与者。 默认的 All messages 允许参与者发送请求并回答问题。Mentions & replies 要求提及关联账户、
使用 @kavor 标记,或引用 Kavor 消息进行回复。这是在过滤激活条件,不是逐人权限系统。添加成员可能意味着将操作
你的 agents 工作的权限委托给他们。
连接、隐私与恢复
- 电脑不可用: WhatsApp 不会把 Kavor 变成托管服务。恢复 desktop 后先检查真实状态,再考虑重发可能已产生效果的操作。
- agent 未回复: 查看
/context和/status,再检查 desktop 上的登录、对话框或待审批事项。 沉默不代表成功,也不授权重复破坏性请求。 - 连接中断: 使用 Channels 中的重连控件。停止会保留关联;取消关联是另一项操作。 自动重连不得撤销明确的停止或禁用选择。
- 问题或选择已过期: 检查上下文并请求最新选择,不要假定旧选项仍指向同一目标。
- 隐私边界: 执行与关联凭据留在电脑上,但消息经过 WhatsApp 服务,附件使用 Kavor 管理的临时存储。 只发送你有权共享的内容。
- WhatsApp 边界: 集成使用关联设备,而不是 Meta 托管的 WhatsApp Business API。账户规则、限制和封禁仍由 Meta 控制。