zgi

企业内网部署 Agent，先检查什么？企业内网部署 Agent，先检查五个边界：任务能接触哪些资料、能调用哪些工具、每一步由谁确认，以及失败后能不能找到原因。资料范围没有锁定，模型答得再顺也可能引用错文件；工具没有边界，一次误调用就会把试验变成生产动作；运行过程没有记录，出了问题只能凭最后一句回答猜测。

开源 AI Agent Runtime：制度版本问答员工问“差旅住宿标准是多少”，知识库里可能同时有今年制度、去年制度和某个地区的补充通知。若 Agent 只按相似度取一段文字，回答看起来流畅，却可能引用了过期版本。更可靠的流程是先判断问题适用范围，再让检索结果带着版本和来源进入回答。

开源 AI Agent Runtime：培训题生成一份内部操作手册有几十页，培训负责人想出十道题，检查员工是否理解关键步骤。直接把整份资料交给模型，常见结果是题目重复、答案过于笼统，或者问到了资料没有说明的内容。

开源 AI Agent Runtime：客服截图怎样变成工单？客服群里经常出现一张错误截图，里面可能有错误码、页面标题和一串被截断的提示，但没有账号、发生时间或复现步骤。让 Agent 直接总结，工单看起来完整，后续却找不到受影响用户，也无法判断紧急程度。

审批一直没人处理，Workflow 怎么做超时升级？内容上线前需要负责人确认，流程已经发出提醒，但两天后仍没有结果。继续发送同样的消息，只会制造更多通知；直接跳过审批，又会让风险落到执行人员身上。

不同请求走不同流程，ZGI Workflow 怎么配？很多团队把所有请求都交给同一个 Agent，结果是客服问题调用了销售资料，权限申请绕过了审批，内部故障又被当成普通问答。问题通常不在模型大小，而在入口没有定义清楚，流程也没有为不同风险设置不同出口。

知识库权限变了，怎样避免答错？知识库权限调整后，最容易被忽略的是 Agent 仍然可能沿用旧的可见范围。客服、销售和产品看到的资料不同，回答自然也会不同。处理这类问题，先把“谁能看什么”写清楚，再检查回答是否引用了当前授权范围内的资料。用 ZGI 可以把知识资产、权限和人工复核放进同一条问答流程。

工作流失败后，怎样快速定位？一个工作流没有产出结果时，直接重跑往往只会得到另一个失败。更有效的排查方式，是把问题拆成输入、知识、模型、工具和人工确认五层，逐层确认哪一层出现异常。用 ZGI 管理 Agent Runtime 和工作流时，可以保留每次运行的节点状态，帮助团队定位失败点。

旧模型下线前，客服 Agent 怎么迁移一个已经在线的客服 Agent 仍绑定即将停用的旧模型时，可以按四步迁移：在 ZGI 的“模型渠道”中接入并测试替代模型，先给旧配置跑一份基线，再只修改 Agent 草稿中的模型，用同一批客服问题重新测试，结果通过后创建新的发布版本。

ZGI 文件产物：生成报告后怎样交付企业让智能体生成一份报告，常见的麻烦出现在最后一步：文件确实生成了，却不知道归到哪个任务；链接发给了不该看到的人；流程结束后找不到产物；外部系统只收到一段文字，没有拿到文件。生成动作完成，交付链路仍有几项工作需要安排。

ZGI Agent 发布：配置改了，线上为何还是旧版本Agent 的配置变化要经过保存、测试和发布，线上入口读取的配置范围也需要单独确认。开发者在草稿里改了模型、知识或 Workflow，测试页面可以立即看到变化；已发布入口仍可能继续使用上一版。两边表现不同，并不一定是模型随机性造成的。

ZGI 工作区权限：用户为何看不到资源在 ZGI 中，用户能否看到一项资源，需要经过组织、工作区、成员身份、角色权限和资源范围的连续判断。邀请成功只说明账号进入了某个组织，无法直接证明它已经加入目标工作区，也无法证明当前角色拥有查看或创建对应资源的权限。

ZGI 记忆隔离：多人共用不串号多人共用同一个智能体时，每次记忆读写都要绑定稳定的用户标识，并明确采用账户范围还是终端用户范围。ZGI Agent Memory 会把工作区、Agent、记忆槽、用户范围和用户标识一起作为读写条件。在上游身份映射正确且持续稳定时，不同用户的长期信息会写入不同记录。

ZGI 混合检索：汇集候选并统一重排混合检索把多种检索路径得到的片段汇入同一个候选池，再根据相关性完成筛选和排序。语义检索擅长处理口语和同义表达，关键词与全文检索更容易命中编号、术语和原文短语，图谱检索用于补充实体关系。正确片段没有进入候选池时，应检查检索方法；片段已经出现却排位靠后，再检查重排。

ZGI 运行日志：还原任务与节点状态运行日志需要回答四个问题：哪一次任务出了问题，执行停在哪个节点，该节点收到了什么，随后留下了什么结果。只保存最终报错，团队很难判断问题来自上游输入、当前节点、权限限制还是外部接口。任务级记录用于缩小范围，节点级记录用于重建执行顺序。

ZGI 父子分块：连接检索片段与完整上下文知识库把长文切得太短，定义和适用条件容易落在不同片段；切得太长，候选中会混入大量无关内容。父子分块用两种粒度保存同一份资料：子块负责靠近查询，父块保留更完整的语义范围。检索系统可以先定位短片段，再按父子关系补充上下文。

ZGI Workspace：统一组织 Agent 资源Agent 数量增加后，最先失控的往往是资源关系。同一份制度被复制进多个知识库，同一个工具出现几套参数，模型切换后只有部分流程完成更新。Workspace 用一个明确范围组织 Agent 依赖的模型、知识、数据库、Skills 和 Workflow，并把权限、发布与运行记录接到这套关系上。

ZGI 批量测试：上线前验证 AgentAgent 单次回答正确，只能证明当前输入跑通。上线前还要确认换一种问法、缺少字段、知识更新、工具超时或权限不足时，系统会给出预期结果。批量测试把这些任务保存成可重复运行的样本，每次修改模型、知识、Skill 或 Workflow 后重新执行，比较关键字段和最终状态。

ZGI 模型网关：统一接入与路由大模型企业接入多个大模型后，可以通过模型网关统一管理供应商、访问凭据、默认模型和路由策略。Agent 与 Workflow 调用一个稳定入口，具体使用哪个模型由配置决定。模型发生切换时，还要检查输出结构、工具调用、延迟和失败处理，避免业务流程跟着接口变化反复修改。

ZGI Workflow：让知识检索进入业务流程知识库回答准确，只解决了“找到什么资料”。当企业希望系统继续核对字段、判断条件、发起审批、写入数据或发送通知时，需要把检索结果接入 Workflow。知识提供任务依据，流程负责安排执行顺序、条件分支、人工节点和失败处理。