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

版本：v0.3 | 创建日期：2026-10-14

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

优先级：P1（沿用原稿）

文档状态：草稿，待评审

本稿沿用已明确的接入范围、提问人权限和最近 10 条群上下文；补充首期渠道能力与异常规则。挂起式问答、业务确认表单、动态看板操作暂不开放，是本稿建议，并非已经上线或用户已逐项确认的结论。

需求变更记录

依赖需求 Story 列表

一、需求概述

1.1 客户反馈

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

1.2 系统现状

• ShareAgent 独立入口已支持文本、业务卡片、文件、动态看板，以及等待用户回答、确认或填写表单后继续任务。
• 企信已有 AI 助理入口、流式文本和部分业务卡片。现有消息展示机制与 ShareAgent 的交互和产物范围不同，不能直接照搬独立入口。
• 文件存在转发到企信的入口，但不能据此认为新 Agent 已能自动将产物发送到客服互联群。
• 动态看板有运行、共享、版本和业务操作；Ask User Question 涉及暂停与恢复任务。两者均超出单纯展示一张卡片的范围。

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

1.3 竞品现状

不涉及。本需求为内部 Agent 能力与企信渠道对齐，不依赖竞品结论。

1.4 产品价值

客服团队可在原互联群中使用新架构 Agent 的问答、检索和文件处理能力。通过统一的渠道规则，其他符合资格的 Agent 也能接入，避免逐个定制；用户可以明确知道哪些任务能完成、哪些需到 Agent 独立入口处理。

1.5 需求目标

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

二、产品方案

2.1 整体产品方案

本期提供群内问答、兼容业务结果和文件交付；不把独立 Agent 工作台整体搬入企信。

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

2.2 具体方案说明

2.2.1 Agent 选择与群内使用

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

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

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

2.2.3 首期能力范围

配套阅读：13 个能力场景的图文说明 · 大图阅读页。原始设计素材与代码示意图区分标注，便于理解下表的界面形态。

下表是本稿的首期目标，不表示现有链路已经完成适配。

限制同时作用于可调用能力、执行过程和最终交付，不能只隐藏按钮或只靠提示词。需要限制的工具及动作由 Agent 平台与企信维护统一渠道规则，群管理员不再重复配置；Agent 独立入口保持原有能力。

2.2.4 文件交付

1. 产物生成完成后，以企信原生图片或附件发送到原群，并关联本次回复，至少显示文件名及可用的大小信息。
2. 复用企信现有类型、大小、预览、下载和安全检查规则，不另行扩大范围。文件的实际访问范围遵循现有群文件规则，不使用个人浏览器临时地址代替群交付。
3. 支持的文件无法生成时显示任务失败原因；文件已生成但不能交付时，显示“文件已生成，但发送失败”，与任务执行失败区分。
4. 文件发送重试仅对已有产物重新鉴权、获取与投递；已成功发送的产物不重复发送。文件失效后告知无法重发，重新生成需由用户明确发起。
5. 多文件允许部分成功，展示成功项与失败项，不把整个任务显示为全部成功。
6. 客服互联群是首期验收场景。内部群可用不能替代互联群验收；不符合跨企业访问规则的文件不得绕过限制发送。

2.2.5 运行状态与异常

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

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 适用版本