企信接入 ShareAgent 架构 Agent 需求方案

版本：v0.4 | 创建日期：2026-10-14 | 更新日期：2026-10-20

需求来源：FS 需求 2026-07-16-25775、关联原始反馈、用户沟通、双端前端核验

优先级：P1（沿用原稿）

文档状态：草稿，待评审

本稿已合并客服项目背景及最新产物展示结论：沿用企信壳子与 RTC 消息规范，按六类产物承接 ShareAgent 结果；过程展示业务步骤，文件与业务卡片独立成消息，HTML 图表及动态看板通过新页打开。以下为产品目标，尚不代表全部链路已上线。

需求变更记录

依赖需求 Story 列表

一、需求概述

1.1 客户反馈

客户反馈结论： 企信当前未接入 ShareAgent 架构 Agent，FS 客服团队希望先将互联群 AI 小蜜蜂切换到新架构。底层能力不限定 AI 小蜜蜂，需支持任意符合资格的 ShareAgent 架构 Agent。

项目背景补充： 原客服助手对每次提问的处理较独立，连续追问时难以承接前文。升级 ShareAgent 架构，主要为接续用户与 Agent 的对话、改善图片解析，并复用客户已有知识与技能。用户也可在互联群内直接要求生成服务报告，由 Agent 整理获准读取的群消息并交付文件，无需切到独立入口。上下文改善是本期核心目标，以原客服问题的连续问答回归验证效果。

1.2 系统现状

• ShareAgent 独立入口已支持文本、业务卡片、文件、动态看板，以及等待用户回答、确认或填写表单后继续任务。
• 企信已有 AI 助理入口、流式文本和部分业务卡片。现有消息展示机制与 ShareAgent 的交互和产物范围不同，不能直接照搬独立入口。
• 文件存在转发到企信的入口，但不能据此认为新 Agent 已能自动将产物发送到客服互联群。
• 线上已观察到 Markdown 表格、文件附件、HTML 图表、动态看板入口及客户字段卡片。表格并不等同于带筛选、分页的 CRM 对象列表；动态看板与普通 HTML 文件可采用相近外观，但数据加载和访问权限不同。
• 补充信息和业务确认属于执行交互，不单列为产物类型；其群内提交身份和任务恢复方式仍需评审。

现状依据为本次双端前端核验；尚不代表所有线上版本及移动端均具备相同行为。具体证据独立维护，不作为产品规则。

线上样例	已观察到的展示	本期含义
	带标题栏和网格的文本表格	复用表格结构，不据此扩展 CRM 列表操作
	普通 HTML 文件与独立看板分别有卡片	外观统一，保留不同数据加载语义
	客户名称及字段值卡片	优先复用实际业务数据卡片

1.3 竞品现状

参考用户提供的飞书群助手截图：执行中展示步骤状态，完成后展示结构化结果。本期借鉴其过程与结果分层方式，步骤采用业务描述，不展示技能名称、命令参数和原始执行明细；不据截图推断飞书完整产品能力。

竞品截图	来源	图中证明	不能证明	对当前任务的意义
	用户提供的实际测试截图	群回复可包含表格与结果说明	不证明其权限机制或全部工具执行方式	群内结果保留结构，不必退化为纯段落

1.4 产品价值

客服团队可在原互联群中连续答疑、解析图片，并直接形成基于群内信息的服务报告，减少重复描述问题和切换独立 Agent 入口。通过统一的渠道规则，其他符合资格的 Agent 也能接入，避免逐个定制；用户可以明确知道哪些任务能完成、哪些需到 Agent 独立入口处理。

1.5 需求目标

1. 企信群可添加并调用符合资格的 ShareAgent 架构 Agent，不限定 AI 小蜜蜂。
2. 每次执行沿用提问人权限与既定群上下文，交付企信能承接的结果。
3. 不支持的操作在执行前受限；异常返回明确结果，不出现空白完成、无限等待或重试造成重复执行。

二、产品方案

2.1 整体产品方案

沿用企信界面与 RTC 消息规范，承接知识答复、文本表格、文件附件、HTML 图表、动态看板及业务数据卡片六类结果。

主流程：添加有权使用的 Agent → 群成员按现有入口提问 → 校验身份与渠道可用能力 → 执行支持的任务 → 回传消息/附件或明确受限原因。

2.2 具体方案说明

2.2.1 Agent 选择与群内使用

1. 在企信现有添加 AI 助理入口中纳入 ShareAgent 架构 Agent。候选须同时满足架构已开启、状态可用、当前企业可使用、添加人有权绑定；沿用现有群添加权限。
2. 添加后沿用群内已有触发规则。本期不新增主动监听全群、自动参与每条聊天或新的入口。
3. 已有快捷操作若调用新架构 Agent，必须适用同一套渠道限制；不能通过不同入口调用被限制的能力。
4. 已绑定 Agent 被停用、删除或撤销使用权限后，提示不可用；不替用户切换其他 Agent。
5. 添加入口可说明“支持问答、表格、业务数据卡片及文件；图表与看板可打开查看”。具体结果取决于 Agent 配置和已完成适配的能力；不能承诺任意 Agent 都能生成全部类型。

2.2.2 执行身份、上下文与可见范围

• 每次任务以当次提问人为执行主体；群主、Agent 添加人及其他成员的权限不参与代执行。互联群成员身份无法匹配或权限不足时，明确提示，不借用内部人员身份。
• 沿用最近 10 条有效群消息并保留发言人归属；显式选择的消息仍按既有选择语义处理。不自动将群内全部附件交给 Agent。
• 不建设群长期记忆，不将个人会话、个人工作区或个人记忆直接变成全群共享上下文；个人记忆在群渠道的现有隔离规则由平台沿用并验收。
• 结果按企信现有群消息可见规则发送。发送前应按群场景生成内容；不得把无权接收的数据写入群正文后，再依赖详情链接鉴权补救。本期不新增“仅提问人可见”消息模式。
• 打开业务详情或文件时，继续按访问人的现有权限校验。执行权限与结果访问权限分别生效；本期不新增群级业务授权。

2.2.3 首期能力范围

配套体验：六类产物双端场景 Demo。每类展示同一问题在 ShareAgent 与企信中的执行过程和最终结果；默认自动播放，可反复重播。演示数据不作为线上效果或真实业务结果证明。

统一消息结构： 一次回答先在同一条 RTC 消息内更新业务步骤和正文结论，再按产物顺序发送独立卡片。连续产物仅首条展示 Agent 头像与名称；发生其他成员插话或不再连续时，沿用企信现有发送主体展示规则，避免归属不清。每个产物与原问题及任务关联，历史消息可独立识别其归属。

表格与对象卡片的区别： 文本表格展示回答中的结构化信息，不意味着已获得 CRM 对象列表的全部操作能力。客户清单按客户合并最近跟进；跟进记录可以有多行相同客户，但标题须明确口径。业务数据卡片则有对象身份与详情入口，不能把普通文本表格中的名称自动变成业务操作。

不独立列场景的能力： 图片与引用消息属于输入，沿用已支持方式；工具和子 Agent 属于执行过程；群内服务报告属于文件产物；个人工作台不移植到企信。尚未得到实际样式验证的营销、拜访、审批等专属卡片不作为本期独立设计对象，实际出现未知结果时按异常规则反馈。

需用户交互的执行边界： 缺少必要信息时先澄清，不应将信息缺失作为所有产物的默认结局。涉及新建、编辑或流程操作时，必须完成已有业务权限和必要确认；群内确认交互未适配的操作暂不开放，不自动提交，不将其他成员下一条消息视为授权。此项不限制只读分析、文件或看板的正常生成；主任务与子 Agent 均遵守相同规则。

2.2.4 文件交付

1. 生成完成后，在文字结论之后向原群单独发送文件或看板卡片。优先复用 ShareAgent 文件卡片的类型图标、名称、时间及已适配操作；普通文件可补充现有文件大小信息。多文件逐项显示，连续消息不重复发送主体。
2. 点击文件、HTML 图表或看板入口均新页打开，不占用当前聊天侧栏。复用现有预览、下载及安全检查服务，不直接执行群消息内的 HTML，也不使用个人浏览器临时地址交付。
3. 静态 HTML 图表是生成时的数据快照；动态看板在打开或刷新时按访问者身份读取数据。无权访问时提示原因，不回退使用生成者身份。看板无法访问、已删除或已失效时给出明确提示。
4. 查询采用提问人权限，发送前按既有共享规则检查群可接收范围；链接鉴权不能补救已经在群正文、卡片字段或文件快照中暴露的受限内容。互联群须验证跨企业访问，内部群成功不能替代验收。
5. 无法生成文件与文件已生成但发送失败分别反馈。后者提示“文件已生成，但发送失败”，重试只重新鉴权与投递已有产物，不重复执行 Agent 任务或业务写入；已成功发送项不重发。
6. 多文件允许部分成功，逐项标记；失效文件无法重发时说明原因，重新生成须由用户明确发起。类型、大小及下载等规则沿用现有文件服务，不因新架构接入自动扩容。

2.2.5 运行状态与异常

本期不新建任务中心、跨入口任务恢复、用户接管或新的停止任务控件；已有停止能力继续沿用。挂起式问答以后若开放，须另行补齐答题人、超时、取消、重复提交及恢复规则。

业务步骤与结构化结果： 多次底层调用可合并为“读取相关消息”“查询客户资料”“整理结论”等业务步骤；不得将计时动画当作真实进度。失败保留已完成步骤并标明未完成项，不能显示全部完成。最终结果与收起的步骤摘要关联本次提问，重进会话可回看，不重新执行。沿用现有流式可见规则，不为全群额外发送进度消息。

表格和业务卡片的展示及口径统一按 2.2.3，避免将界面组件复用误认为业务操作已开放。

文件示例——群内服务报告： 用户在当前互联群提出生成报告，Agent 依据本次获准读取的群消息，整理问题、处理进展、已解决项及待跟进项；在原群返回简短结论及独立报告文件卡片；若当前 Agent 不具备文件生成能力，应明确说明，不以“已生成”替代实际交付。报告注明实际消息范围和信息缺口，未确认的处理结果不得写成“已解决”。

执行仍按提问人权限。当前既定默认上下文为最近 10 条有效群消息，这不等于整个会话历史或完整服务周期；需要更早消息时，只能使用已授权、已支持的读取范围，范围不足须说明或请用户补充。连续问答应保留必要的用户提问、Agent 回复及指代关系，并沿用发言人归属；不将其他成员插话自动接作当前任务指令。

当前群消息的摘要沿用群内可见范围；如果报告补充 CRM、客户知识库、个人信息等群外来源，查询权限仍属提问人，但群可见正文必须符合既有接收范围。不得将提问人可读直接等同于所有群成员可读；无可验证的群交付范围时，不在群正文暴露该部分内容。文件与业务详情另按访问人鉴权，不新增群级授权或借用内部员工身份。

2.2.6 兼容与影响

• 旧架构 Agent 的候选、绑定和现有行为不改；ShareAgent 渠道限制不应扩大到旧架构或独立 Agent 入口。
• 已绑定 Agent 开启新架构后，下一次调用按当前架构识别，无需要求用户重复添加；运行中任务不切换架构。企信不提供 Agent 架构升级/回滚功能。
• 历史群消息按原有方式读取，不触发重新生成、重新写入或重新发送。
• Web/PC 的入口、状态与消息展示需适配；移动端须按发布支持范围验收相同最终消息和附件，未经验证不宣称新交互可用。
• 本期不新增 CRM 对象、字段或群内个人工作台；Agent 的知识、工具和指令仍在 Agent 平台维护。

2.2.7 验收重点

2.3 待确认事项

当前没有必须由需求提出人先补充才能形成初稿的信息。六类产物及新页打开按本轮用户确认更新；交互表单的具体适配方式仍需评审。以下为研发与发布协同项，不视为已完成的现有能力。

三、规范检查项

3.1 业务文案多语言 Key

复用企信现有文案机制；下列为新增文案建议，Key 在开发时按现有规范分配。

Agent 不可用、无权限等提示优先复用已有词条。AI 生成内容不作为产品静态文案翻译。

3.2 需求埋点

不新增用户行为埋点。复用现有监控观察调用完成率、受限操作、未知结果、文件交付失败和终态缺失，用于灰度判断。

3.3 沙盒/更改集能力

3.4 PaaS 国际化兼容检查

3.5 新对象/新字段 BI 分析申请

3.6 操作日志说明

不新增用户可见日志。运行记录需能关联提问人、群、Agent、任务结果、受限原因及文件发送结果，支持排查重复执行和交付失败；不记录无必要的正文或文件内容。

3.7 需求风险点检测

3.8 上线策略

3.8.1 收费标准

待商业化确认。本期不新设渠道计费方案，沿用经确认的 Agent 版本与资源计费规则，不承诺免费。

3.8.2 上线节奏

• [ ] 全网
• [x] 灰度

灰度出现越权、受限操作仍执行、重复业务写入或结果持续丢失时，停止扩大范围并关闭受影响的新架构渠道能力。此处是渠道发布控制，不是回退 Agent 架构。既有任务须收敛终态，不静默切到旧架构继续。

3.8.3 适用版本