个性化 AI 智能体

​

方案架构

如果直接基于模型 API 构建 Agent，开发团队还需要自行处理任务循环、上下文延续、工具协议、权限确认、消息状态与异常中断等通用能力。 Qoder Agent SDK 提供 Qoder Agent Harness 的运行与控制能力，团队只需围绕五个核心要素完成配置：定义用户与任务、注入业务上下文、接入业务工具、设置权限边界，以及设计适配用户的产品界面，从而将研发资源集中于真正影响业务效果的部分。

​

方案优势

​

优势 01：复用 Agent Harness，显著减少重复建设

Qoder Agent SDK 把任务循环、上下文延续、工具协议、权限询问、消息状态和中断恢复作为可复用运行原语交给开发者，让第一个场景更快形成闭环，后续场景沿用同一套技术模式，从而显著降低企业逐场景重建运行框架的成本。

​

优势 02：效果建立在真实上下文和企业工具之上

宿主应用把当前文件、客户、合同、工单或项目直接交给 Agent，再通过企业工具提供最新数据、制度规则和确定性计算；模型负责理解、规划和协同，权威结果由业务系统或专用工具计算，使产出更贴近企业约束、更易复核与评测。

​

优势 03：同一底座可以形成完全不同的业务产品

底层复用同一套会话、工具、权限和执行事件，界面围绕岗位最自然的工作方式设计，让桌面办公、设备维修、供应链等 Agent 无须被压缩成同一种对话界面，企业可据此形成差异化的业务产品。

​

优势 04：从回答问题升级为可控地完成任务

Agent 围绕目标持续读取信息、调用工具、生成业务成果并等待人的决定；SDK 在关键工具调用前把授权交给宿主，Hooks 和消息流把工具开始、成功、失败与拒绝等状态交给宿主，使企业建立可观测、可接管、可回写的任务闭环。

​

业务场景

以下场景采用固定合成数据展示业务入口、产品界面与流程形态。时间数据为参考作业口径和 PoC 验收目标，Agent 用时从材料齐备起算，不含人工审批、系统执行、对外沟通和异常返工；正式效果应使用客户授权任务集与同口径人工基线验证。

​

场景 01：桌面办公 Agent — AI Native 办公助手

围绕明确的任务目标，Agent 可读取授权文件、制定执行计划并调用办公工具，最终生成汇报 PPT、数据核验表与行动项清单。

• 客户问题： 经营资料分散在文件夹、表格、会议纪要和 PPT 模板中，相关人员需要在多个文件之间反复切换、核对数据，并手动整理汇报材料。
• 触发条件： 员工在办公产品中创建复盘任务，并授权 Agent 访问相关文件。
• Agent 动作： 读取并分析授权文件，制定执行计划，调用企业文档、表格与演示文稿工具，生成汇报材料和数据核验表；发现预算、版本或数据口径冲突时，向员工发起确认。
• 交付结果： 汇报 PPT、数据核验表和行动项清单。
• 完成定义： 原本约需 1 个工作日的跨文件整理工作，由 Agent 在约 15 分钟内形成待审核成果包，关键结论与数据均可追溯至来源文件。
• 人工闸口： 最终数据口径、文件保存位置及任务分派由员工确认。

​

场景 02：Coding Agent — 从理解代码库到交付可审查修改

基于当前代码仓库与任务上下文，Agent 可检索代码、编辑文件、运行测试，并交付可审查的代码补丁。

• 客户问题： 开发者需要先理解代码结构与工程约束，再依次完成实现定位、文件修改、测试验证和 Diff 审查，处理链路较长且信息分散。
• 触发条件： 开发者提交功能需求或缺陷修复任务。
• Agent 动作： 读取项目说明与开发规范，检索相关代码并制定执行计划；在授权范围内编辑文件、运行命令和测试，最终汇总代码差异、测试结果与潜在风险。
• 交付结果： 可审查的代码补丁、Diff、测试结果及风险提示。
• 完成定义： 小型修复通常需要人工投入 2–4 小时，Agent PoC 的目标是在 15 分钟内形成可审查补丁。在示例任务中，Agent 用时 8 分 36 秒完成 3 个文件的修改，并通过 18 项测试。
• 人工闸口： 安装依赖、执行高风险命令、提交代码、推送远程仓库及创建合并请求前，均由开发者确认。

​

场景 03：销售管理 Agent — 数百项物料的识别、匹配与报价

基于 CRM 中的当前商机，Agent 可读取客户与产品信息，调用企业报价工具生成多套方案，并在同一页面完成对比。

• 客户问题： 客户预算、产品组合、历史成交价、履约成本、折扣政策和审批权限分散在 CRM、产品目录与报价表中。销售人员需要反复查询和试算，毛利或折扣越界通常到审批阶段才会暴露。
• 触发条件： 收到重点客户询价，或销售人员在当前商机中发起报价策略生成请求。
• Agent 动作： 读取客户、商机与产品信息，调用企业报价工具生成多套可选方案，并统一对比价格、毛利、需求匹配度及审批路径。
• 交付结果： 多套报价方案、毛利测算、需求匹配度与审批路径，并可继续生成 CPQ 草稿、发起折扣审批和更新 CRM。
• 完成定义： 报价方案符合企业定价政策、毛利护栏与审批规则，推荐方案与数据依据保持一致。
• 人工闸口： 销售人员选择最终方案；折扣力度与提交范围由 Deal Desk 或授权管理人员确认后，再写回业务系统。

​

场景 04：招投标经营决策 Agent — 在资源投入前完成 Go / No-Go 判断

解析招标文件，关联企业资质、历史项目与财务模型，生成包含决策依据的 Go / No-Go 简报。

• 客户问题： 政企投标周期紧、材料多，销售、交付、财务与法务团队需要在有限时间内共同评估资格条件、交付能力、预期毛利、竞争态势与关键风险。
• 触发条件： 系统接收到新的招标公告或招标文件。
• Agent 动作： 解析招标公告与文件，调用企业资质库、历史项目、资源数据和财务模型，拆解并核验关键要求，生成决策简报、经济性测算与风险清单。
• 交付结果： Go / No-Go 决策简报、经济性测算及风险清单。
• 完成定义： 原本约需人工准备 2 个工作日的决策材料，由 Agent 在约 20 分钟内形成待审核简报，关键结论均附有数据或文件依据。
• 人工闸口： 是否参与投标、预算投入及正式提交，均由经营负责人审批。

​

场景 05：合同审查与谈判 Agent — 把风险、依据和修改建议放在同一工作面

调用合同审查与制度检索工具，生成条款级风险卡、制度依据、修改建议与审批路径，并建立合同原文与审查结论之间的关联。

• 客户问题： 法务人员需要结合合同原文、交易背景、企业制度、合作方档案和审批矩阵识别风险，定位相关条款、判断影响并提出谈判建议。所需信息分散，人工审查耗时较长。
• 触发条件： CRM 商机进入合同谈判阶段，或业务人员上传新的合同版本。
• Agent 动作： 调用企业接入的合同审查与制度检索工具，识别条款风险，定位原文与制度依据，生成修改建议及审批路径，并建立原文、风险与建议之间的对应关系。
• 交付结果： 条款级风险卡、制度依据、修改建议与审批路径。
• 完成定义： 一份 38 页合同的人工首轮审查约需 4 小时，Agent 可在约 10 分钟内形成审查初稿，每项风险均可追溯至具体条款与适用规则。
• 人工闸口： 正式法律判断、红线版本、制度例外及审查结果写回合同系统前，均需由企业法务确认。

​

场景 06：客诉与售后工单 Agent — 从多系统排查走向可执行的处理方案

工单进入后，Agent 可读取客户与产品上下文，调用跨系统工具还原事件时间线、分析可能原因并生成处理建议。

• 客户问题： 复杂客诉涉及订单、物流、设备日志、服务记录、质保政策和补偿权限。客服人员需要跨系统核实信息，并协调技术、仓储与服务团队共同处理。
• 触发条件： 客诉或售后工单进入系统。
• Agent 动作： 读取当前客户、产品与工单信息，调用 CRM、订单、物流、知识库及诊断工具，还原事件时间线，分析可能原因，生成处理计划与客户沟通草稿，并标记需要升级审批的补偿方案或关单条件。
• 交付结果： 事件时间线、原因分析、处理计划及客户沟通草稿。
• 完成定义： 原本约需人工跨系统排查 90 分钟的复杂工单，由 Agent 在约 6 分钟内形成待确认的处理建议，并保留相关数据依据。
• 人工闸口： 补偿承诺、对外发送及工单关闭，均由授权人员确认。

​

场景 07：供应链履约异常 Agent —在异常发生时快速形成跨系统处置方案

履约异常发生后，Agent 可调用 ERP、WMS、MES、TMS 及客户承诺数据，识别根因与影响范围，并评估不同处置方案。

• 客户问题： 交付延期通常由订单承诺、库存、生产、采购、物流和客户优先级等多项因素共同造成。供应链人员需要先还原影响范围，再比较库存调拨、订单拆分、物流加急、物料替代及客户沟通等方案。
• 触发条件： 系统监测到履约异常，或相关负责人主动发起异常处理任务。
• Agent 动作： 调用 ERP、WMS、MES、TMS 与客户承诺数据，定位异常根因及受影响订单，测算不同处置方案对交期、成本和客户承诺的影响，并生成待执行清单。
• 交付结果： 异常影响范围、根因链路、处置方案对比及待执行清单。
• 完成定义： 原本约需人工排查和协调 2 小时的异常任务，由 Agent 在约 12 分钟内形成待确认的处置建议。
• 人工闸口： 库存调拨、加急费用及客户承诺变更，均由相应负责人审批。

​

场景 08：项目交付推进 Agent — 将项目风险从会后发现转为持续推进

持续汇集项目系统与过程记录，更新里程碑状态，识别阻塞项及责任人，并生成项目管理摘要与行动计划。

• 客户问题： 项目计划、周报、会议纪要、缺陷、变更和客户反馈分散在不同系统中，项目状态依赖人工汇总，关键依赖与风险往往到例会阶段才被发现。
• 触发条件： Agent 在项目周期内持续运行，或按计划及关键节点触发。
• Agent 动作： 读取项目系统、工单、会议纪要和变更记录，更新里程碑状态，识别阻塞项、关键风险与责任人，生成管理摘要、行动计划及升级建议，并持续跟进未完成事项。
• 交付结果： 项目管理摘要、行动计划与升级建议。
• 完成定义： 原本约需人工投入 1 个工作日准备的项目经营视图，由 Agent 在约 15 分钟内形成待审项目简报。
• 人工闸口： 任务改派、项目范围变更及对客户的承诺，均由项目负责人确认。

​

参考实践

​

实践名称

Qoder Agent SDK × 企业办公与任务系统：桌面办公 Agent 一次生成可审阅的经营复盘成果包

​

实践背景

• 客户或行业：企业经营与办公场景。
• 原有流程：员工手工打开销售明细、预算表、会议纪要和 PPT 模板，统一口径、制作图表、撰写结论、套用模板，再把行动项录入任务系统。
• 核心问题：信息散落在多个文件、预算存在两个版本、口径核对与成果制作依赖人工，冲突与写操作缺少统一确认点。
• 试点范围：以“生成 Q3 经营复盘材料”为例，覆盖材料读取、口径核验、成果生成和行动项写回。

​

实践方案

• 事件如何进入：员工在办公产品中创建“Q3 经营复盘”任务并选择四份授权文件，宿主把任务目标、文件标识、截止时间和输出要求交给 SDK。
• 控制层如何路由：Qoder Agent SDK 启动经营分析 Agent，将目标拆解为材料读取、口径核验、指标计算、结论提炼、成果生成和行动项整理，并保持长生命周期会话。
• Agent 如何执行：通过企业 MCP 工具读取文件，用表格工具计算指标，用演示文稿和文档工具形成成果草案，权威数字由确定性工具计算而非模型估算。
• 结果如何回写：员工确认后，写入工具保存文件、创建内部任务并更新任务系统状态。
• 失败如何回流：发现预算表存在两个版本时暂停相关结论并交员工判断；权限拒绝或超时不调用写工具，成果保留在待审状态。
• 人工在哪些节点决策：预算版本选择、最终数据口径、文件保存、版本覆盖和任务创建。

​

实践流程

​

实践结果

• 完成的闭环：跑通“任务目标—授权文件—多工具执行—人工确认—受控写回”的完整链路，复盘成果不再依赖人工跨文件搬运。
• 已验证能力：System Prompt 角色定义、MCP 工具、长生命周期 Session、消息流和 canUseTool 权限闸口可组合使用。
• 数据或证据：按参考流程人工约需 1 个工作日，Agent 约 15 分钟形成待审成果包；各环节留有工具调用状态、权限请求记录和系统回执。
• 尚未覆盖的范围：跨部门协同复盘、对外汇报发送与长期指标追踪等后续流程。

​

推荐产品组合