发布日期：2026-10-29

AI智能体接入企业系统，是把业务页面、用户权限、任务执行和结果交付连接起来，让员工在原有系统里提交工作、查看进度并使用结果。本文依据截至2026年10月29日核验的官方文档，以材料管理系统增加“AI核对”按钮为例，说明如何配置业务规则、从后端创建任务、连接内部工具，以及把报告交回原页面。操作示例使用七牛云AgentAPI；公司原有的身份验证、材料权限、审批和结果验收仍由业务系统负责，接入方案需要分别处理任务状态、文件交付与异常恢复。

先选一个有明确结果的业务入口

接入的起点，是选定员工要完成的一件具体工作，并定义交付什么结果。

例如，员工已经在材料管理系统上传合同和附件。过去需要下载文件、逐项检查，再把问题填回系统。加入“AI核对”后，员工仍使用原页面，后台组织材料检查，最后展示差异清单，交给工作人员复核。

第一版可以限定为：核对名称、日期、金额及附件是否一致，输出问题、依据位置和待补充事项。涉及法律判断或无法确认的内容，标为待人工复核。这里是示范性业务设计，不代表平台内置合同审查功能。

开发团队需要连接三部分：员工使用的业务页面、负责权限和任务管理的公司后端，以及执行分析与工具调用的Agent服务。原有登录、业务数据库和审批流程可以继续使用。

配置业务规则，再让后端引用同一份配置

Agent需要知道公司的检查要求、可用工具和输出格式，开发团队应先验证这些配置，再连接正式业务入口。

以七牛云AgentAPI为例，2026年10月核验的Portal文档提供四步测试流程：创建智能体、配置环境、创建会话、发送消息。智能体配置包含任务要求和工具，环境配置执行所需的软件与网络条件。

使用下文的应用侧自定义工具时，可按官方工具示例选择Native运行时，并先验证工具调用与结果回传。

可以先用脱敏文本验证下面的业务要求，再接入正式材料：

按公司提供的检查清单核对材料，逐项列出发现的问题、引用依据和待补充事项。没有找到依据时写“无法确认”；不得自行补造金额、日期或条款。输出差异清单，提交工作人员复核，不执行审批。

验证通过后，记录智能体ID、版本和环境ID。官方文档支持在API中引用这些配置；固定版本可以让同一任务使用可追溯的规则，之后修改配置也便于分批验证。

原始PDF、扫描件能否处理，还取决于所选模型、运行时和解析工具。首次接入可先使用已提取的文本，把“读懂材料”和“调用接口”分别验证。

公司后端提交任务，保存自己的任务号

业务页面应调用公司后端，由后端校验用户和材料归属，再调用Agent接口。

例如，后端为一次检查生成自己的任务号，保存提交人、材料ID、检查规则版本及Agent会话ID。员工之后查询进度或下载报告时，后端仍按原有权限检查，不能只凭一个会话ID放行。

AgentAPI官方产品概述明确，业务用户与资源归属、任务与会话的关联、工具审批及结果验收由应用负责。把用户ID写进备注，并不会自动建立业务用户之间的权限隔离。

下面是创建会话的请求结构，发送到同一区域服务的POST /v1/sessions。字符串为说明性占位符，version中的1需替换为实际整数版本；API Key保留在公司后端，通过x-api-key请求头传入。

JSON请求同时设置content-type: application/json。服务地址从接入准备页选择，智能体、环境和会话使用同一区域的资源。

{
  "agent": {
    "type": "agent",
    "id": "从Portal复制的智能体ID",
    "version": 1
  },
  "environment_id": "从Portal复制的环境ID",
  "metadata": {
    "business_task_id": "公司后端生成的任务号"
  }
}

保存响应中的id作为会话ID。后端先订阅该会话的事件流，再向POST /v1/sessions/{id}/events提交输入。首次可以发送脱敏文本，验证接口链路：

{
  "events": [{
    "type": "user.message",
    "input": {
      "parts": [{
        "type": "text",
        "text": "核对以下脱敏材料：主表金额100元，附件金额120元。请列出差异及依据，不执行审批。"
      }]
    }
  }]
}

请求成功只说明输入已接收，最终结果要从后续事件和产物中获取。页面可以显示“已提交”，由后端继续跟踪；这些业务状态名称由公司系统定义。

企业资料通过文件或业务工具接入

资料接入需要同时确定“Agent能读什么”和“后端凭什么允许它读”。

文件型材料可通过Files API上传，再把返回的文件ID加入会话资源，并指定读取路径。根据官方文件文档，上传文件对象和挂载到会话是两个步骤；业务后端应先检查材料权限，再组织上传与挂载。

需要查询内部数据时，可以把已有接口封装成自定义工具，例如“读取本任务获准的材料摘要”。工具只返回检查所需字段，避免把整个数据库交给Agent自行检索。

AgentAPI的工具文档说明，自定义工具的业务代码在应用进程中执行。Native运行时发出agent.custom_tool_use后，公司后端检查参数和权限、调用业务函数，再用user.custom_tool_result回传结果，通过custom_tool_use_id关联原调用。

工具查询失败也应回传明确的错误结果，避免会话一直等待；写回、审批等业务操作仍由公司后端决定是否允许。

因此，这条接入路径可以由公司后端访问它原本有权访问的内部接口，无需先部署自托管worker。第三方系统凭证也应由后端管理，不能放进任务提示词，或由浏览器任意指定使用哪个凭证库。

如果文件与命令必须在自有设施执行，可另行评估自托管worker。官方当前要求Native运行时，且输入、工具参数与结果仍会经过AgentAPI及模型服务；它不等于整个系统离线运行。

页面展示进度，后端核对报告后再回写

任务状态、执行进度和最终报告，需要由后端关联到同一个业务任务。

根据官方事件文档，实时进度可通过SSE事件流接收，历史记录可以查询。后端保存消费进度并按事件ID去重，连接断开后恢复读取；涉及写库、通知等操作时，还要避免重复执行。

事件流路径为GET /v1/sessions/{id}/events/stream，历史查询为GET /v1/sessions/{id}/events；两者都由后端使用保存的会话ID访问。

不需要持续连接时，可以配置Webhook通知后端。它提供资源和生命周期通知，不携带完整报告。2026年10月核验的文档注明，每条投递最多尝试3次，通知可能重复或乱序，重要任务仍应定期回查。

Webhook接收地址需要满足官方公网HTTPS要求。如果公司不提供这类接收端，可以由后端消费事件流并查询历史。

后端收到通知后，需要验签、可靠保存，再按资源ID查询详情。收到会话停止事件时，还要检查停止原因：是在等工具结果、需要确认、达到限制，还是已经交付了本轮结果。

文件交付也有单独的路径。官方文档要求云端产物写入/mnt/session/outputs/，再由应用列出、下载会话文件；沙箱里的任意文件不会自动成为可下载报告。

后端通过GET /v1/files?scope_id={会话ID}查询文件列表，再用选中文件的ID调用GET /v1/files/{file_id}/content下载内容。

如果预期文件尚未出现在列表中，应按官方文件指南稍后重查，并根据任务要求确认文件名和内容，避免取错产物。

后端取得报告后，检查差异项、依据位置和待补充事项是否齐全，保存到业务系统，再向原页面提供受权限控制的查看或下载入口。工作人员确认后，才进入后续审批。

上线前，把异常和业务结果一起验收

一次接入是否完成，要看员工能否在原系统中取得可用结果，以及异常是否有明确处理方式。

可以先围绕同一个材料核对任务，检查下面几种情况：

  • 换一个无权查看材料的账号，确认后端拒绝读取和下载。

  • 重复点击提交、重复收到通知，确认不会重复创建业务操作或覆盖报告。

  • 关闭页面后再打开，确认能按业务任务号查回进度和已有结果。

  • 工具查询失败或报告缺少依据时，确认页面显示待处理，并保留人工接手入口。

长任务还应核对执行时限。七牛云2026年10月更新的会话文档列明，云端沙箱运行时长与CLI命令执行上限默认各为1小时，更长时限需要部署配置和沙箱服务支持；保留会话历史也不等于任何运行时都能自动恢复。

按照官方产品概述与事件文档的职责划分，Agent服务管理执行，公司系统负责业务身份、资料权限、操作审批和结果验收。本文给出的是文档核验后的接入方案，未进行线上API实测；资料截至2026年10月29日。

参考资料

相关文章

七牛云产品