概述

本文档详细说明如何在AgentWorks控制台中对 Agent 实例执行相应操作。

实例类

一、查看实例

1.1 功能说明

通过查看实例，您可以了解 Agent 实例的运行状态、基础配置、网络信息、模型配置和 Skill 绑定等详细信息。

1.2 操作步骤

方式一：通过实例列表查看概要信息

1. 登录 DuClaw 企业版控制台
2. 在左侧导航栏选择 Agent 管理 > Agent 实例，可看到您已创建的Agent实例列表
3. 如需筛选实例，可使用列表上方的搜索框搜索

方式二：进入实例详情查看完整信息

1. 在实例列表中，点击目标实例的名称
2. 进入实例详情页，通过顶部 Tab 页签查看不同维度的信息

注意事项

• 实例处于「创建中」状态时，部分信息可能尚未生成，请等待状态变为「运行中」后再查看完整信息
• API Key 等敏感信息在详情页中以脱敏形式展示（如 sk-****xxxx），如需查看完整值请点击「显示」按钮
• 实例 ID 是全局唯一标识，提交工单或排查问题时请提供该 ID

二、重启实例

2.1 功能说明

重启实例将对 Agent 实例执行关机后再开机的操作。重启后实例的公网 IP、内网 IP 和已绑定的数据不会发生变化。

2.2 前置条件

• 实例当前状态必须为 「运行中」
• 已停止或创建中的实例不支持重启操作

2.3 操作步骤

方式一：单台重启

1. 登录 DuClaw 企业版控制台
2. 在左侧导航栏选择 Agent 管理 > Agent 实例
3. 找到目标实例，点击操作列的 「更多」 下拉按钮
4. 在下拉菜单「实例状态」分组中，点击 「重启」
5. 在弹出的确认对话框中，确认重启

方式二：从详情页重启

1. 进入目标实例的详情页
2. 点击页面顶部操作区的 「重启」 按钮
3. 在弹出的确认对话框中，点击 「确定」

方式三：批量重启

1. 在实例列表中，勾选需要重启的多台实例（左侧复选框）
2. 点击列表上方的 「重启」 按钮
3. 在弹出的确认对话框中，确认已选实例列表，点击 「确定」 按钮

注意事项

• 重启过程中实例将暂时无法提供服务，请在业务低峰期执行
• 重启不会影响实例的配置信息（模型配置、Skill 绑定、安全组规则等）
• 重启不会影响实例的公网 IP 和内网 IP 地址
• 批量重启时，仅支持批量重启状态为「运行中」的实例

三、停止实例

3.1 功能说明

停止实例将对 Agent 实例执行关机操作。实例停止后不再对外提供服务，但实例的配置信息、内网 IP、公网 EIP 绑定关系均保留不变。按量付费实例停止后计算资源将持续计费。

3.2 前置条件

• 实例当前状态必须为 「运行中」
• 已停止或创建中的实例不支持此操作

3.3 操作步骤

方式一：单台停止

1. 登录 DuClaw 企业版控制台
2. 在左侧导航栏选择 Agent 管理 > Agent 实例
3. 找到目标实例，点击操作列的 「更多」 下拉按钮
4. 在下拉菜单「实例状态」分组中，点击 「停止」
5. 在弹出的确认对话框中，点击 「确定」 按钮
6. 实例状态变为「关机中」，稍后变为「已停止」

方式二：从详情页停止

1. 进入目标实例的详情页
2. 点击页面顶部操作区的 「停止」 按钮
3. 在弹出的确认对话框中，点击 「确定」

方式三：批量停止

1. 在实例列表中，勾选需要停止的多台实例
2. 点击列表上方的 「停止」 按钮
3. 在弹出的确认对话框中，点击 「确定」 按钮
4. 所有已选实例将依次执行关机

3.4 停止后的影响

项目	影响
Agent 服务	停止对外提供服务，所有请求将返回不可用错误
计算资源计费	实例不会停止计算费用
公网 EIP	保持绑定关系，EIP 仍继续计费
内网 IP	保留不变
托管路由	路由保留但请求会失败（后端不可达）
配置信息	全部保留（模型配置、Skill 绑定、安全组等）
监控数据采集	停止采集，但历史数据保留

注意事项

• 停止实例后，通过该实例提供的所有 Agent 服务将立即中断
• 如果实例通过 API 网关方式访问，停止后调用方将收到错误响应
• 按量付费实例停止后不会停止计算资源计费，绑定的公网 EIP 仍会产生费用
• 包年包月实例停止后不退费，计费周期不变
• 如需恢复服务，在实例列表中点击 「更多」>「开启」 即可重新启动
• 批量停止时，仅可批量停止状态为「运行中」的实例

3.5 开启已停止的实例

1. 在实例列表中找到状态为「已停止」的实例
2. 点击操作列的 「更多」 下拉按钮
3. 在下拉菜单「实例状态」分组中，点击 「开启」
4. 实例状态变为「启动中」，稍后恢复为「运行中」

也可通过详情页顶部的「开启」按钮操作，或在列表中勾选多台已停止实例后点击上方「启动」按钮批量开启。

四、释放实例

4.1 功能说明

释放实例将永久删除 Agent 实例及其关联的资源。此操作不可逆，请谨慎执行。

4.2 前置条件

• 按量付费实例：状态为「运行中」或「已关机」实例才可释放
• 包年包月实例：不支持释放
• 建议在释放前备份重要数据（配置文件、Skill 等）

4.3 操作步骤

方式一：单台释放

1. 登录 DuClaw 企业版控制台
2. 在左侧导航栏选择 Agent 管理 > Agent 实例
3. 找到目标实例，点击操作列的 「更多」 下拉按钮
4. 在下拉菜单「实例状态」分组中，点击 「释放」

5. 在弹出的确认对话框中，阅读释放影响说明：

6. 点击 「确定」 按钮，提示用户释放成功

方式二：批量释放

1. 在实例列表中，勾选需要删除的多台实例
2. 点击列表上方的 「批量操作」 下拉按钮
3. 选择 「释放」
4. 在弹出的确认对话框中，确认信息，点击 「确定」 按钮

4.4 释放后的资源处理

资源类型	释放后行为
Agent 实例	永久删除，不可恢复
内网 IP	释放回子网地址池
公网 EIP	自动解绑，EIP 保留（如不再需要请手动释放 EIP 以停止计费）
托管路由	自动删除（通过 API 网关方式创建的）
Skill 空间绑定	自动解绑，空间和 Skill 不受影响
消费者授权	自动取消授权，消费者本身保留
安全组关联	自动解除关联，安全组不受影响
配置文件	随实例一起删除
监控数据	保留 15 天后自动清理

注意事项

• 此操作不可逆，实例一旦释放将无法恢复，请务必确认后再操作
• 释放前请确认是否有其他服务或用户依赖该实例
• 如果实例通过 API 网关方式访问，释放后相关路由将失效，依赖该路由的调用方会收到错误响应
• 释放实例后，关联的公网 EIP 会变为「未绑定」状态并继续计费，请及时处理
• 建议释放前导出实例的高级配置文件（SOUL.md、AGENTS.md 等）作为备份
• 批量释放时，仅支持批量释放按量付费实例

五、重装系统

5.1 功能说明

重装系统将清除实例内的所有数据，并重新安装指定镜像。适用于需要将实例恢复至初始状态、实例环境异常无法修复、需要更换镜像版本等场景。

5.2 前置条件

• 实例状态为「运行中」或「已停止」
• 重装前请确保已备份重要数据（配置文件、业务数据等）

5.3 操作步骤

1. 登录 DuClaw 企业版控制台
2. 在左侧导航栏选择 Agent 管理 > Agent 实例
3. 找到目标实例，点击操作列的 「更多」 下拉按钮
4. 在下拉菜单「运维」分组中，点击 「重装系统」

5. 在弹出的重装配置页面中：

• 选择镜像类型：公共镜像 / 自定义镜像
• 选择具体镜像版本
• 重新设置管理员密码（密码规则：8-32 位，至少包含大写字母、小写字母、数字、特殊符号中的三种）
• 重新设置模型配置

6. 点击 「确定」 按钮
7. 实例进入「重装中」状态，完成后恢复为「已停止」状态

注意事项

• 重装系统会清除实例内所有数据，包括用户上传的文件和自定义配置，请提前备份
• 重装后管理员密码将变更为新设置的密码
• 批量重装：在列表中勾选多台实例 → 点击「批量操作」→「批量重装系统」

六、远程登录（VNC）

6.1 功能说明

通过 VNC 远程登录到 Agent 实例的终端，可直接在实例中执行命令、查看日志、调试问题。

6.2 前置条件

• 实例状态为 「运行中」

6.3 操作步骤

1. 在实例列表中，找到目标实例
2. 点击操作列的 「远程登录」 按钮（主按钮）
3. 浏览器将打开一个新的 VNC 终端窗口

4. 在终端中输入登录凭证：

   • 用户名：root
   • 密码：创建实例时设置的管理员密码
5. 登录成功后即可执行命令

也可从实例详情页顶部点击「远程登录」按钮进入。

常见问题

Q：实例重启后 Agent 服务没有自动恢复怎么办？

A：请检查以下几点：

1. 确认实例状态已恢复为「运行中」
2. 通过远程登录（VNC）进入实例，检查 Agent 进程是否正常启动
3. 检查安全组规则是否放通了所需端口
4. 如问题持续，尝试「停止」后重新「开启」实例

Q：误删了实例能否恢复？

A：不能恢复。实例释放后数据将被永久清除。建议对重要实例的配置文件定期备份，做好防护

Q：释放实例后还会继续产生费用吗？

A：实例本身不再计费，但以下资源可能继续产生费用：

• 未释放的公网 EIP（按量计费）

请在释放实例后检查并清理不再需要的关联资源。

Q：批量操作有数量限制吗？

A：单次批量操作最多支持 100 台实例。

网络类

一、解绑/换绑 EIP

1.1 功能说明

弹性公网 IP（EIP）用于为 Agent 实例提供公网访问能力。您可以解绑 EIP 以关闭公网访问，或解绑后重新将 EIP 绑定到实例以开通公网访问。

1.2 解绑 EIP

1. 找到目标实例，点击 「更多」>「网络和安全」>「解绑 EIP」
2. 在弹出的确认对话框中，确认解绑信息,点击 「确定」
3. 解绑后实例将无法通过公网访问

1.3 绑定 EIP

1. 找到目标实例，点击操作列的 「更多」 下拉按钮
2. 在下拉菜单「网络和安全」分组中，点击 「绑定 EIP」

3. 在弹出的对话框中：

• 选择已有 EIP：从当前地域未绑定的 EIP 列表中选择
• 创建公网IP：跳转至EIP控制台新购 EIP

4. 点击 「确定」
5. 绑定成功后，实例详情的「网络配置」中将显示公网 IP 地址

注意事项

• 绑定 EIP 不需要停止实例，可在运行中直接操作
• 解绑 EIP 后，EIP 仍保留在账户中并继续计费（按量付费），如不再需要请前往 EIP 控制台进行释放
• 一个实例同一时刻只能绑定一个 EIP
• 绑定公网 EIP 后，请参照《百度内部业务上百度公有云安全规范》配置安全组规则，避免暴露不必要的端口

二、关联安全组

2.1 功能说明

安全组是实例级别的网络访问控制策略，通过配置入站/出站规则来控制实例的网络流量。一个实例可以同时关联多个安全组，规则取并集。

2.2 关联安全组

1. 找到目标实例，点击操作列的 「更多」 下拉按钮
2. 在下拉菜单「网络和安全」分组中，点击 「关联安全组」

3. 在弹出的对话框中选择要关联的安全组（支持多选），点击 「确定」
4. 新安全组规则立即生效

注意事项

• 关联/解除关联安全组不需要停止实例，规则立即生效
• 每个实例至少需要关联一个安全组，不可全部解除
• 多个安全组的规则取并集（合并生效），请注意规则冲突
• 安全组是在服务器外部做防护，如果实例本身配置了防火墙（如 iptables），需要在防火墙中做相应设置
• 建议为生产实例关联最小权限的安全组，仅开放 Agent 服务所需的端口