ALMANACCONNECTORv0.4.0 · f3d38b2

企业知识接入与问答编排

让群聊里的经验,不再随着聊天记录沉下去。

Almanac Connector 像一条企业知识传送带:把飞书群聊和附件可靠地送进 AiInsight,再把有出处的答案送回正确的群。

先看它解决什么问题

它不制造知识;它把接入、检索和回复做成可追踪、可重试、有边界的流程。

流程演示数据
INCOMINGKNOWLEDGE ROUTE
群消息

新版差旅制度今天起生效

财务制度群 · 10:24

附件

2026 差旅标准 v3.pdf

2.4 MB · 已更新

群消息

收到,谢谢!

财务制度群 · 10:27

飞书清洗隔离AiInsight原群
示例回答 · 有出处

国内出差住宿标准已更新,具体以新版制度第 3 章为准。

引用 · 2026 差旅标准 v3

WHY · 为什么需要它

知识并不缺,
缺的是一条可靠的路。

很多企业已经拥有答案,只是答案被聊天时间线、重复附件和模糊来源埋住了。

01

聊过,不等于留下

经验、制度和解决办法散落在消息与附件里。时间一久,新同事不知道它存在,老同事也很难找回。

02

收进来,不等于可用

重复转发、机器人回声和“收到、谢谢”不断制造噪声。未经整理的信息越多,搜索反而越难。

03
???

答出来,不等于可信

没有来源的答案无法判断依据,也不知道什么时候应该停止自动回答、转给人来确认。

Almanac Connector 把这三段断开的路接起来

WHAT · 它具体做什么

一条传送带,
做好五件事。

从“收”到“管”,每一步都围绕同一个目标:让知识的来路、边界和去向可控。

5CORE
CAPABILITIES

飞书已经打通实时消息、历史消息、附件和群内 @回复;S3 兼容存储与外部文件服务目前只负责知识输入,并需要应用侧注册具体客户端。

HOW · 它怎么工作

跟着一条消息,走完整条传送带。

一位同事在群里发布制度更新,并附上一份文件。点击每一站,看看它如何变成可追溯的答案。

第 1 站 ·

接住原始信息

飞书的新消息、历史消息和附件,都能进入同一条知识链路。消息先清洗聚合,附件绕过消息聚合并原样交给 AiInsight;来源、时间、版本和群聊位置会一起保留。
这一步留下群聊位置发送时间原始附件

1 / 5 站 · 这是流程示意,不代表实时处理速度

GUARDRAILS · 关键护栏

两个重要选择:查哪里的知识,什么时候不该回答。

01

场景隔离

知识可以汇总,边界不能消失

场景决定“能查什么”,原群决定“回到哪里”。

当前知识边界财务SCENE
可检索财务群消息与附件
×不可检索研发场景知识
回答位置发起问题的财务

提示 同一场景可包含多个授权群,但回复仍回到提问所在的原群。

02

可信度护栏

宁可请人接手,也不编一个完整答案

当前默认门槛是 0.55;没有可靠引用,或分数低于门槛,都会停止硬答。

证据分数 · 流程演示0.72
门槛 0.55
达到门槛,并且有可用引用

可以回答,并保留出处

回答中显示引用标题;可点击的引用链接在当前部署配置中默认关闭。

回答 证据够,才让自动化继续。

PROOF · 当前工程证据

这是工程底座,
不是业务成绩单。

下面的数字说明当前代码经过什么验证,不代表在线用户数、业务命中率、吞吐量或生产 SLA。

755项自动化测试通过当前提交本地复验 · 3 条第三方弃用警告
58个源代码文件通过严格类型检查0 个类型问题
3类连接器边界飞书可运行 · S3/外部文件服务需接具体客户端
12交互回答路径的超时上限不是平均响应时间承诺
Ruff 检查通过

当前还有 3 条第三方飞书 SDK 弃用警告,不影响本次测试通过,后续需要随 SDK 升级处理。

口径:almanac-connector v0.4.0 · commit f3d38b2 · 基于当前仓库代码与测试结果

BOUNDARY · 职责边界

Almanac 把路修好,
AiInsight 负责把知识读懂。

ALMANAC CONNECTOR

它负责“送对”

  • 01接入不同来源并统一格式
  • 02清洗、去重并保留来源
  • 03检查业务场景与知识边界
  • 04管理检查点、失败、重试和对账
  • 05把答案送回发起问题的原群
AIINSIGHT

它负责“读懂”

  • 01OCR、文件解析、切分和索引
  • 02检索排序与证据召回
  • 03生成回答并检查内部引用
也不是:任意群都能使用的通用聊天机器人

NOW · 现在能说到哪一步

能力已经可验证,
生产边界也必须说清楚。

准确口径是“具备知识接入与问答闭环能力”,而不是“已经完成规模化生产验证”。

01

AiInsight 闭环已有代码与部署配置支持

实际环境是否完整启用,仍取决于服务密钥、目标知识库和验收结果。

具备
02

引用标题可以显示

可点击链接默认关闭,需要先完成接收人的访问权限验证。

受控
03

群成员权限自动同步暂未开启

仓库内 DC2 部署清单保持关闭,等待操作验收后再启用。

待验收
04

仓库内 DC2 部署清单保持单副本

扩容前需要共享附件暂存,并补充单消费者与回复协调机制。

边界
05

大文件读取还不是流式处理

进入大文件生产场景前,需要继续增强。

待增强
06

Preview 只检查输入质量

它不生成语义知识、不回答问题,也不保存附件二进制。

边界
07

敏感信息与权限失败默认保守

文本会经过凭据检测与脱敏;身份或 ACL 映射失败时拒绝放宽范围,附件内容安全检查由 AiInsight 承担。

护栏

THE SIMPLE VERSION

业务继续在飞书里工作,
知识不必继续困在飞书里。

Almanac Connector 把零散消息变成一条可追踪的知识路径:收得进、理得清、隔得开、答得回,也知道什么时候该停下来请人判断。

查看工程边界