---
url: https://docs.zenavo.app/zh-CN/zenavo-agent
---

# Zenavo Agent

Zenavo Agent 是控制台里自带的助手。问它部署为什么失败、哪些服务挂了、某个功能怎么配置：它会查看你的项目、读取日志和部署记录，然后回答。需要修改时，它会提出建议，修改只有在你在页面里确认之后才会执行。

如果想用自己的 AI 智能体（Claude Code、Cursor 等），请看 [AI 智能体（MCP）](https://docs.zenavo.app/zh-CN/ai-agents)。

## 打开

在任意控制台页面点右侧边缘的 **Zenavo Agent**；手机上点右下角的圆形按钮。Agent 知道你当前打开的是哪个页面，所以在某个服务的页面问"这个服务为什么一直重启？"，说的就是这个服务。

点 **新对话** 重新开始，点时钟图标查看之前的对话。对话只有你自己能看到，属于你当时打开的工作区。

想要更大的空间，就点左侧边栏搜索框下方的 **Zenavo Agent**，以整页打开 Agent：左边是之前的对话，右边可以从推荐的问题开始。右上角的 **在侧栏中打开** 会把当前对话带回到你来时那个页面的侧栏里；侧栏上的全屏图标则反过来，把对话整页打开。只有设置了 Zenavo Agent 的地方才会显示这个入口；方案不包含它时，页面会说明如何升级。

## 能做什么

不需要确认就能查看：

- 工作区里的项目、服务、端口和域名，以及每个服务是否在运行
- 服务的运行日志、部署记录和部署日志
- 服务环境变量的**名称**（变量值对它隐藏）
- 适合你想部署的应用的[模板](https://docs.zenavo.app/zh-CN/deploy/templates)

可以提出、由你确认后执行：

- 部署整个项目或单个服务
- 回滚到之前的某次部署
- 重启服务
- 设置或删除环境变量

提出的修改会以卡片形式出现在对话里，带 **确认** 和 **取消** 按钮。你确认之前什么都不会改；如果你直接发了新消息，这个修改就不会执行。确认后的修改以你在工作区里的角色执行，所以 Agent 能做的永远不会超过你在控制台里能做的，这些修改也会出现在[审计日志](https://docs.zenavo.app/zh-CN/account/audit-log)里，并标明是通过 Zenavo Agent 做的。

账单、服务器、域名、成员和新建项目仍在各自的控制台页面里操作，Agent 会给你链接。

## 密钥不进对话

Agent 永远看不到环境变量的值。要设置密码、密钥或 Token，让 Agent 去设置这个变量：确认卡片里有一个输入框，你在里面输入值，值会加密保存，不会发给 Agent。不要把密钥直接粘贴到对话里。

日志来自你自己的服务，Agent 只把它们当作数据，不会执行日志里写的指令。

## 方案与额度

Zenavo Agent 为 [Dev 及以上方案](https://docs.zenavo.app/zh-CN/account/plans)的功能。每个工作区每月有一定积分：Dev 30、Pro 100、Team 300、Enterprise 不限。每次回答都会消耗一些积分，任务越长消耗越多。用完后 Agent 暂停，到下一个自然月（UTC）恢复。Pro 及以上可以把对话切换到能力更强的进阶模型，积分消耗更快。

Free 方案下，面板会介绍 Agent 能做什么，并提供升级按钮。

Agent 可能会出错。根据它的回答行动之前请先核查，确认每个修改之前请看清楚内容。