企业 Agent 连接遗留系统时，难点常在系统边界：模型已经生成正确建议，旧系统却没有正式 API；页面能够录入，执行器又无法判断后台是否真正受理。此时需要把接入能力、提交权和结果确认分成独立契约，避免将工具返回成功当成业务成功。

下面以合同续签登记为工程示例，不对应实际客户。架构建议不承诺任何旧系统都可无人值守接入，也不包含绕过验证码、风险校验或账号授权的方法。

## 系统架构：控制面决定，执行面观察

控制面保存业务身份、输入版本、审批范围、允许通道与停止条件。执行面运行接口适配器、文件导入任务或受控页面操作，并回传观察结果。结果核对服务负责解释业务回执，人工接管入口处理不能自动确定的任务。

不应让执行面自行扩大动作范围。一个页面工具即使能访问多个功能，也只能执行当前任务允许的动作。模型生成的操作建议属于待验证输入，不能直接变成可以随意点击的权限。

控制面与执行面之间传递不可变的动作摘要，包含对象、版本、字段摘要、审批期限与适配器版本。执行前重新校验，避免“审核时是一组内容，提交时已经变成另一组内容”。凭据保存在受控凭据服务或执行环境，不进入模型上下文和普通任务日志。

## 技术路线：能力声明先于工具调用

在这份天远大数据通道契约示例中，`verification_mode` 字段只声明结果核对方式，不代表工具可信度评分。它可以是远端编号查询、批次明细核对或人工确认；缺少可用方式时，控制面不得开放自动写入。

```yaml
contract_version: 1
channel: legacy_browser
object_type: contract_renewal
allowed_actions: [read_status, submit_reviewed_renewal]
verification_mode: manual_receipt
writable: false
adapter_version: legacy-form-v1
on_session_expired: pause
on_page_mismatch: pause
on_submit_timeout: reconcile_only
```

`writable: false` 是该示例的起始状态。只有授权、页面契约、审批与回执验证都完成，才允许通过受控配置开启写入。不能因为更换了工具，就把原本不具备的核对能力补成默认真值。

接口、文件和页面通道应分别声明限制。正式接口可能只读；文件交换可能只能批次反馈；页面通道可能依赖可用会话；人工通道可能有明确处理时段。调度器应根据限制决定等待、降级为建议或暂停，不把所有超时都作为同一种可重试错误。

![接入方式需要依据授权与实际能力选择](https://developer.qcloudimg.com/http-save/yehe-11439120/a6524e2d39e0976e190557e1e903e637.jpg)

## 流程图：结果核对是一条独立路径

```mermaid
flowchart TD
  A[业务输入与审批] --> B[控制面校验契约]
  B --> C{具备写入与核对条件}
  C -->|否| M[只读建议或人工交接]
  C -->|是| D[保存不可变动作摘要]
  D --> E[记录提交意图]
  E --> F[执行面一次提交]
  F --> G[核对服务读取结果]
  G -->|对象版本与回执一致| H[确认完成]
  G -->|结果不确定| U[冻结并保留未知]
  U --> M
```

这里的核对服务只读，不持有重提权限。把两种权限隔离，可以减少恢复程序为了“修复任务”再次写入旧系统的风险。只读失败可以有限重试，但写入后的不确定状态不进入普通重试队列。

## 状态持久化与执行令牌

业务键应该代表一个具有唯一业务含义的动作，例如某合同某版本的一次续签登记。调度批次编号只用于追踪，不替代业务键。输入版本更新后是否允许新动作，需要由流程定义，不能由执行器自动生成新键规避去重。

任务表至少保存：业务键、输入版本、契约版本、动作摘要、当前状态、尝试令牌、执行器身份、远端回执和核对来源。状态可以收敛为准备中、待提交、可能已提交、已确认、人工处理；“可能已提交”不能被恢复程序直接改回待提交。

领取执行权使用数据库原子条件更新，同时匹配当前状态和输入版本。持久化提交意图后，执行器才能发起动作。另一个工作进程即使拿到重复消息，也应看到任务已经处于未决状态并停止提交。数据库连接超时或写入失败时，不允许先执行远端再补记录。

## 并发与崩溃窗口不能只靠租约

租约到期不意味着原执行器已经停止。它可能暂时失联，却仍在操作目标页面。如果旧系统不支持栅栏令牌，单纯把租约交给新执行器，就会出现两个写入者。接管前需要隔离原执行环境，确认没有未决动作，并保留停止证据。

崩溃可能发生在意图落盘后、点击前，也可能在远端受理后、回执落盘前。两种窗口在本地都可能只留下未决任务，因此恢复程序必须保守核对。不能靠一张本地截图推导远端没有受理，更不能为了提高完成率自动再点一次。

回执写入也需要条件约束。远端对象、输入版本与尝试令牌不一致时，应作为冲突事件保留。人工已经确认的结论不能被迟到消息覆盖。事件顺序与最终业务状态是两种信息，审计记录需要同时保留。

![完成判断依赖业务编号与版本，而非按钮状态](https://developer.qcloudimg.com/http-save/yehe-11439120/d6240b7bc9846949afcfe610aa649761.jpg)

## 失败恢复与降级策略

会话失效、权限撤销和页面结构不符，进入暂停与人工维护；远端提交超时，进入只读核对；文件导入部分成功，按业务键拆分核对。没有可查询结果时，保留人工步骤，而不是尝试未授权的隐藏接口。

维护窗口里修复选择器或交换模板后，新版本先在测试样本上验证。旧版在途任务保留原契约版本，能解释的结果再确认；不能解释的任务转人工。适配器升级和任务重放分成两个操作，避免一次部署同时改变页面操作与历史业务含义。

恢复成本也要进入容量设计。人工队列持续增长，说明自动化覆盖、核对条件或任务量需要调整；不应通过取消审核、缩短等待或盲重试掩盖问题。暂停某类写入而保留只读建议，可以是一种正常降级状态。

## 测试边界与发布门

测试包括：重复消息与乱序到达、两个执行器竞争、数据库写入失败、提交前后崩溃、远端回执延迟、页面多目标匹配、权限中途撤销、文件部分成功、接管时原执行器仍存活，以及跨契约版本恢复。开发集之外保留不同排序、缺字段与新文案样本。

每个测试需要明确预期：是否允许副作用、最终由谁确认、需要哪些证据、能否继续自动运行。对不能证明远端未受理的情况，正确结果可以是暂停。接受这一结果，比把所有任务都包装成已成功更符合生产安全要求。

本地契约测试只能验证状态决策，不能证明旧系统的真实提交语义。上线前仍需在获得授权的测试环境验证结果查询、隔离和恢复。发布门应同时覆盖业务正确性、维护工作量、人工恢复成本与可退出性；关键能力缺失时，收缩到只读或建议阶段。



企业 Agent 连接遗留系统时，难点常在系统边界：模型已经生成正确建议，旧系统却没有正式 API；页面能够录入，执行器又无法判断后台是否真正受理。此时需要把接入能力、提交权和结果确认分成独立契约，避免将工具返回成功当成业务成功。

企业 Agent 遗留系统架构：接入通道与结果确认边界

将遗留系统接入拆为控制面与执行面，约束授权通道、写入租约、结果核对和未知状态，避免将页面点击误当业务完成。

架构设计

人工智能

后端

企业Agent对接遗留系统需解耦接入、提交与结果确认，以合同续签为例，通过控制面决策、执行面观察及独立核对服务确保业务成功。强调不可变动作摘要、条件回执写入及保守恢复策略，防止重复提交与错误确认，保障生产安全。

代码解释

验证码

数据库

大数据

Agent

Solid

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

企业 Agent 遗留系统架构：接入通道与结果确认边界-腾讯云开发者社区-腾讯云

企业 Agent 遗留系统架构：接入通道与结果确认边界

企业 Agent 遗留系统架构：接入通道与结果确认边界

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐