Ginitdocs
加载中…

给 agent 用

切片链接、渐进式披露、单文件 CLI,以及 bundle 的跨材料综合梳理。

这一页讲的是那条闭环:自己挑一堆上下文 → 压成一份 → 拿一个链接 → 丢给 ginit 里的 agent,带着这些上下文干活。

图谱页多选 → 存为 bundle → +综合 → 分享 → 链接给 agent

链接之所以是中间那个交接点,是因为它同时解决了两件事:agent 不需要你的飞书权限就能读到内容,而你给出去的边界又是明确的——一个切片链接就是创建者的一次显式授权。

切片

在图谱页点「分享」生成一个切片链接。三种范围:

范围是什么
bundle你自己多选攒出来的那一组(会议 / 文档 / 知识库混着都行)
会议系列 × 周某个系列某一周的那几场会
人 × 时间窗某个人在一段闭区间里参与 / 相关的 context

人 × 时间窗的切片包含这个人相关的议题、已建出的 issue、以及这些的来源会议。「相关」的口径跟议题一致:议题的人名单里含此人——谁提的、谁负责、谁被影响,会上提到但本人不在场也算。起止日自选,不局限一周,所以拿它做周报、总结、汇报分析都行。

把链接发给 agent,它打开看到的第一层就是使用说明。

渐进式披露

切片是分层的,这一点是刻意设计的:

  1. 第一层(免认证):返回给 agent 的 skill 指导 + 目录。目录里每场会带 has_l1 和 l1_chars,agent 据此判断值不值得下钻。
  2. 内容层(要授权):具体正文。认证主体是用户本人,不是 agent,也不是某个服务身份。

会议梳理的正文通过接口直接内联返回——读切片的人不需要飞书权限。这也是为什么内容层必须有授权:它绕过了飞书那一侧的权限判定。

指导语里反复说的一句话是「先用目录判断哪场会相关,再只拉那场,别一次全拉」。

单文件 CLI

无需 pip,一个脚本:

curl -fsSL https://context-infra.opensii.ai/cli.py -o /tmp/ci.py

授权走 device-flow,而且是两步式——「取链接」和「等授权」解耦,所以 agent 不用守着一个进程等人点:

# 打印 auth_url,交给你的用户去点;进程可以直接退出
python3 /tmp/ci.py auth start

# 用户授权后(随时)查一次,或者等到授权为止
python3 /tmp/ci.py auth poll
python3 /tmp/ci.py auth poll --wait

token 存在 ~/.context-infra/token(权限 0600),有效期 30 天;已经授权过的机器直接用,不用再走一遍。

取内容

python3 /tmp/ci.py slice list <token>
命令拿到什么
slice list <token>切片目录
slice get <token> --meeting <id>这场会的梳理正文
slice get <token> --meeting <id> --raw再附上逐字稿指针
slice get <token> --topics全量议题(标题 / 摘要 / 决策 / 待办 / 来源会议)
slice get <token> --issues已建出的 issue

没有梳理的会返回智能纪要原文,并带 l1_status = not_processed——是"还没加工",不是"没有内容"。

典型用法是 --topics 一次拿全量议题做分析,要核对原文时再按需下钻某一场会。

Bundle 综合梳理

bundle 是你自己攒的集合(怎么攒),对它点「+ 综合」跑一次综合抽取:成员材料逐个落盘,模型通读全部之后写一份综合稿,内容包括——

  • 跨材料的主线:这组材料合起来在推进什么
  • 共识与结论(标注来源文件)
  • 冲突、分歧、未决问题(标注来源文件)
  • 演进脉络(时间跨度大的时候)
  • 合并去重后的待办清单(标注负责人和来源)

产出是一份飞书文档 综合梳理:<bundle 名>,由 bot 创建、不开组织链接分享,只把你加成协作者。

每个成员喂进去的材料优先用它自己的那份会议梳理,没有才退回 L0 正文。单成员最多 80k 字符、整组最多 600k,超了截断。

新鲜度看 content_hash(成员 id + 各自的更新时间):它变了说明成员内容更新过,按钮会变成「重新综合」。

综合完点「分享」,就得到上面那个切片链接——这时 agent 读到的是已经压过一轮的综合稿,而不是几十份原始材料。

ACL 与分享边界

bundle 行只对创建者和 admin 可见。成员节点各有自己的权限边界,这里不去推导交集——宁紧勿松。要给别人看,走切片。

这条区分值得记住:bundle 是私人工作台,切片是对外授权。 对外分享一律走切片,因为切片带着"创建者明确同意把这些给出去"这个语义,而 bundle 只是一次选择。

评论

正在加载评论…