Duaer

指南

GitHub 接进企业知识库:按仓库权限搜议题和文档

把 GitHub 接进 Duaer 知识库,员工直接问议题、拉取请求和 README 等文档;公开仓库全员可搜,私有仓库按 GitHub 读权限。

Duaer 能在 GitHub 里搜到什么?

Duaer 索引最近推送的 100 个仓库:每个仓库最近更新的 500 个议题和拉取请求,连同评论;以及默认分支上的 Markdown 文件,例如 README 和 docs 目录,每个仓库最多 200 个。代码不索引。

员工可以问「发票金额差一分钱的问题后来怎么修的?」,Duaer 从议题评论里找到答案并附出处,点出处就在 GitHub 上打开那个议题。

怎么把 GitHub 接进 Duaer?

  1. 在 GitHub 里创建一个个人访问令牌:经典令牌勾选 repo、read:org 和 read:user;细粒度令牌给内容、议题、拉取请求和元数据的只读权限。账号要能看到希望大家搜到的仓库。
  2. 在 Duaer 里新建“GitHub API”凭证,填这个令牌;GitHub Enterprise 还要填服务器地址(例如 https://git.acme.com/api/v3)。也可以用“GitHub OAuth2 API”凭证。
  3. 所有者或管理员打开「知识库」›「数据来源」,在「GitHub」卡片上选择这个凭证,点「连接」。
  4. 稍等索引完成后,问一个答案就在议题或 README 里的问题,看出处是否指向那里。

谁能搜到哪个仓库的内容?

  • 公开仓库:整个 Duaer 组织。
  • 私有和内部仓库:在 GitHub 上对这个仓库有读权限的人,包括协作者、团队成员,以及通过组织基础权限能读的人。

GitHub 用户按公开邮箱对应到 Duaer 成员;仓库属于组织时,也按这个人在组织内的验证邮箱对应。对应不上的人搜不到私有仓库,数据来源卡片上会显示受影响的条目数。令牌列不出某个私有仓库的协作者时(需要推送权限),这个仓库的内容不对任何成员开放,卡片上会提示缺的权限。

有哪些限制?

  • 最多 100 个仓库;每个仓库最多 500 个议题和拉取请求、200 个 Markdown 文件,单个文件不超过 1 MB;每个议题最多读前 100 条评论。
  • 不索引代码、Discussions、Wiki、拉取请求的代码审查评论、发布和 Actions。

想看 Duaer 怎么把知识搜索和事项跟进放在一起,打开 Duaer 官网。

常见问题

Duaer 会改动 GitHub 里的内容吗?

不会。Duaer 只读取议题、拉取请求和文档建索引,不写入、不评论。

Duaer 会索引 GitHub 上的代码吗?

不会,只索引议题、拉取请求和默认分支上的 Markdown 文件。

Duaer 连 GitHub 需要什么令牌权限?

经典令牌需要 repo、read:org 和 read:user;细粒度令牌需要内容、议题、拉取请求和元数据的只读权限。

同组