简介:本文面向开发者和运维人员,说明两类智能体的边界与核心差异,提供选型打分表、部署权限检查清单和分阶段迁移验收标准。读者可据此判断适用方案,并在上线前设定可执行的回滚步骤,降低误操作和长期运行带来的风险。
终端编程智能体在命令行或开发终端中运行,围绕一个代码仓库工作。它的主要任务是阅读项目、定位问题、修改代码、运行测试和解释编译错误。
全栈任务智能体在代码之外,还负责文件处理、定时任务、消息通知、长期记忆和多渠道接入。它的运行时间通常长于一次开发会话。
判断两者的标准很简单:你的任务以代码仓库为中心,还是以持续运行的多类任务为中心。前者适合终端编程智能体,后者适合全栈任务智能体。两者的能力范围会随产品版本变化,选型前应以所选方案的官方文档为准。
| 对比维度 | 终端编程智能体 | 全栈任务智能体 |
|---|---|---|
| 主要入口 | 命令行、开发终端 | 对话入口、消息渠道、调度器 |
| 运行方式 | 以交互式为主 | 交互式与后台自动化并存 |
| 数据范围 | 当前项目目录和代码 | 文件、数据源、消息、历史任务 |
| 记忆类型 | 会话上下文为主 | 会话上下文加长期记忆 |
| 模型依赖 | 依赖一个或多个模型服务 | 依赖模型服务,并可能调用更多外部工具 |
| 数据留存位置 | 通常在本地项目目录和会话日志中 | 取决于记忆库和日志部署位置,需单独核验 |
| 可观测性要求 | 执行日志、测试结果 | 调度日志、任务状态、告警、审计记录 |
| 部署复杂度 | 较低 | 较高,组件更多 |
| 主要风险 | 错误修改代码或执行错误命令 | 长期运行中权限扩大、任务失控、记忆过期 |
| 运维重点 | 依赖版本、项目环境 | 服务可用性、调度、记忆、渠道和审计 |
表中的离线能力、成本和数据留存位置差异较大,取决于具体模型服务和部署方式。这些项目需要在试点阶段实测,不应直接沿用类别描述。
第一步:列出任务清单。 为每个待自动化的任务记录以下字段:任务类型、执行频率、涉及的系统数量、是否需要写入、数据敏感级别。
第二步:按四个维度打分。 每项按 1 到 3 分计算,分数越高表示复杂度或风险越高。
| 维度 | 1 分 | 2 分 | 3 分 |
|---|---|---|---|
| 任务持续性 | 单次交互 | 每日或每周执行 | 持续监听或实时触发 |
| 跨系统数 | 仅代码仓库 | 2 个系统 | 3 个及以上系统 |
| 权限敏感度 | 只读 | 写入本地工作目录 | 写入外部系统或发送消息 |
| 运维人力 | 个人维护 | 小团队维护 | 有专职运维 |
第三步:根据总分选型。 以下阈值是建议起点,应结合试点结果调整:
第四步:做一周试点。 在真实任务上运行一周,记录误操作次数、人工介入次数和任务完成时间,再决定是否扩大范围。
以下命令以类 Unix 系统为例。不同发行版的用户管理命令略有差异,具体安装方式和版本要求以所选方案的官方文档为准。
python3 --versionnode --version
输出版本应满足所选方案文档中的最低要求。版本不符时,先升级运行时,不要通过降低检查来绕过。
sudo useradd --system --create-home agent-runnersudo mkdir -p /srv/agent/workspacesudo chown agent-runner:agent-runner /srv/agent/workspacesudo chmod 750 /srv/agent/workspace
智能体只能访问这个目录。不要把它指向用户主目录、系统配置目录或生产数据目录。
凭证不应写入代码、配置模板或版本库。一种做法是把凭证保存在只有 root 可读的文件中,启动时读入环境变量:
sudo install -m 600 -o root -g root /dev/null /etc/agent/model_keysudo sh -c 'printf "%s" "<你的凭证>" > /etc/agent/model_key'export MODEL_API_KEY="$(sudo cat /etc/agent/model_key)"
生产环境应优先使用密钥管理系统。无论采用哪种方式,都应设置轮换周期,并在怀疑泄露时立即吊销。
ls -ld /srv/agent/workspacesudo -u agent-runner touch /srv/agent/workspace/.probe && sudo -u agent-runner rm /srv/agent/workspace/.probe
第一条命令的预期结果是目录属主为 agent-runner,权限为 drwxr-x---。第二条命令应无报错。如果智能体账户能写入工作目录之外的路径,说明权限配置有误,应在继续前修正。
| 检查项 | 要求 | 验证方法 |
|---|---|---|
| 凭证来源 | 不在代码和版本库中 | 全文搜索仓库中的凭证前缀 |
| 凭证轮换 | 建议不超过 90 天 | 检查密钥管理记录 |
| 工具白名单 | 只启用任务需要的工具 | 查看配置文件中的工具列表 |
| 网络出口 | 默认关闭,按需开放域名 | 在受限环境中测试外连 |
| 写入范围 | 仅限工作目录 | 执行越界写入测试,应被拒绝 |
| 人工确认 | 删除、发送、部署默认需要确认 | 触发一次高风险操作,确认会暂停 |
| 超时与重试 | 单步超时和重试上限已设定 | 模拟超时,检查是否按配置停止 |
| 审计字段 | 包含时间、操作者、工具名、参数摘要、结果、耗时 | 抽查日志条目是否完整 |
| 日志脱敏 | 不记录凭证和个人敏感信息 | 搜索日志中的凭证和手机号格式 |
| 失败告警 | 失败任务发送通知 | 制造一次失败,确认通知到达 |
超时和重试参数需要按任务调整。一个参考起点是单步超时 300 秒,重试不超过 2 次。
从终端编程智能体迁移到全栈任务智能体,不只是替换模型或工具。迁移前应完成以下工作:梳理已有任务和工作流,把个人习惯中隐含的规则写成明确条目,只迁移已确认的历史配置和记忆,重新设计权限边界。
迁移应分三个阶段进行。
| 阶段 | 入口条件 | 验收指标 | 回滚动作 | 责任人 |
|---|---|---|---|---|
| 阶段 0:只读分析 | 只读权限已配置,审计日志已开启 | 连续 7 天无越权访问;输出与人工结果一致率不低于 90%(建议值) | 撤销凭证,清空会话记忆 | 运维负责人 |
| 阶段 1:低风险写入 | 阶段 0 验收通过;写入范围限于输出目录 | 误写次数为 0;每次写入都有审计记录 | 备份当前输出目录,再从快照还原 | 开发负责人 |
| 阶段 2:审批执行 | 阶段 1 验收通过;审批流程已接入 | 审批记录完整率 100%;超时未处理任务不超过 1% | 暂停调度器,冻结任务队列,保留全部日志 | 业务负责人 |
出现严重问题时,按以下顺序操作:
回滚的关键是先保留证据,再恢复数据。直接删除日志或记忆库会让复盘无从进行。
会话上下文只在一次对话或一次任务中有效。长期记忆会在多次任务之间保留,因此需要单独设计规则。
| 记忆类型 | 示例 | 建议保留期限 | 删除方式 |
|---|---|---|---|
| 用户偏好 | 输出格式、常用目录 | 90 天后复核一次 | 用户可在界面中删除 |
| 历史任务 | 任务结果摘要 | 30 天 | 到期自动清理 |
| 已确认规则 | 审批阈值、禁止操作清单 | 直到规则被修改 | 修改时同步更新版本记录 |
写入记忆前应过滤个人敏感字段,例如身份证号、手机号和密码。过期的规则比没有规则更危险,因为它会持续影响判断。
把自动化当成无人值守。 定时任务没有超时和告警时,失败会静默发生,直到下游数据出错才被发现。纠正方法是为每个定时任务配置超时、重试上限和失败通知。
长期记忆无限保留。 旧的项目规则和已废弃的联系人会继续影响输出。纠正方法是为每类记忆设置保留期限,并安排定期复核。
在生产主机上以高权限运行。 一次误操作就可能影响整台主机。纠正方法是使用独立账户,先以只读权限起步,再按阶段逐步开放写入。
两类智能体的差别在于工作中心不同。终端编程智能体以代码仓库为中心,适合开发流程。全栈任务智能体以持续任务为中心,适合跨系统自动化。选型时,先完成任务清单和打分,再做一周试点。进入生产前,必须完成权限隔离、审计日志、失败告警和回滚演练。