智能体如何接入现有业务系统？

已有业务系统可以继续维护业务数据和规则，智能体负责理解用户请求，并在授权范围内调用明确的业务能力。接入工作主要是确定接口、调用身份、数据范围和结果反馈，而后把这些能力配置到适用的任务中。

谷雨G2rain智能体平台用 Runtime 组织执行，Model Nexus 接入模型，MCP Registry 管理工具发现和调用，Studio 与 Agent App 管理运行资料和交互。具体企业系统仍需要提供对应接口并完成场景联调。

先判断问题需要知识，还是需要业务数据

“如何申请功能开通”可以查操作手册；“我的功能开通了吗”需要查询当前业务记录；“帮我提交开通申请”会产生新的业务动作。先把问题按这三类区分，能够确定哪些内容进入知识库，哪些需要工具，哪些还需明确执行条件。

不必一次接入所有接口。可以先选取一个用途明确的只读查询，确认结果、身份与访问范围，再逐步扩展。

对接前，双方需要准备什么

信息	需要说明的内容
业务动作	要查询或处理什么，何时算完成。
接口条件	可用的调用地址、认证方式、输入与返回内容。
用户与组织	调用代表谁，属于哪个组织，可访问哪些对象。
错误情况	不存在、未授权、超时和业务拒绝分别怎样反馈。
运行责任	谁维护接口和配置，失败时由谁定位和处理。

如果外部系统使用独立账号体系，需要先设计身份映射与凭据使用方式。调用者的组织、用户或数据范围应由受控服务上下文确定，避免直接采信对话中提供的身份声明。

一个接入设计示例：查询功能开通状态

以下是接入设计示例，用于说明职责，不表示该业务接口已作为内置工具提供。

1. 明确输入：选择要查询的功能；用户与组织来自登录会话及服务授权上下文。
2. 提供查询能力：业务系统根据接口规则查找当前用户有权访问的开通记录。
3. 整理结果：返回可解释的状态、查询时间和必要的业务说明。
4. 接入工具：配置工具的用途、参数、调用方式与结果映射，并绑定到适用的 Skill。
5. 组织回答：Runtime 调用相应工具，结合结果回答当前状态；若需要解释流程，可同时参考已发布知识。
6. 记录与核对：对照业务系统检查查询结果、执行记录和异常反馈。

问答与查询的分工由此明确：知识解释“如何办理”，业务系统给出“目前是什么状态”。具体配置入口见Agent 平台模块导览。

权限应该在哪里判断

工具注册和 Skill 绑定表达可使用的能力，用户是否可以执行当前业务动作，还需要身份、应用授权、岗位权限和数据归属共同判断。

接入时至少验证两类请求：有权用户能否取得正确结果，无权用户能否被拒绝。不同组织、不同岗位，以及同一组织下不同业务对象的可见范围，都应按实际业务规则测试。分层职责见企业权限模型。

查询接通后，怎样扩展到提交和修改

先明确哪些输入必须提供、哪些业务条件必须满足，以及执行成功、拒绝和状态不确定分别如何反馈。需要用户确认的动作，应在产品流程中安排明确的确认环节；业务接口自身仍需执行授权和状态校验。

还要约定超时后怎样查询结果、重复请求怎样识别，以及出现错误后如何处理。工具涉及状态变化时，应根据实际业务设计幂等和恢复规则，再验证 Runtime 与下游服务之间的协作。

如何判断第一项接入完成

用真实测试账号验证允许和拒绝两种情况；对照业务系统核对结果；模拟不可用或超时；检查用户是否得到清晰反馈，以及维护人员能否从执行记录定位调用。完成后再扩展新的工具与任务。

前端应用如需接入统一主壳，可继续阅读应用接入。如果当前只需要手册与 FAQ 查询，可以先从企业知识库问答或智能客服产品开始。

讨论接口对接时，可通过联系方式提供业务动作、接口说明、身份体系和目标用户范围，便于确定第一项可验证的接入任务。