指南
GitHub 接进企业知识库:按仓库权限搜议题和文档
把 GitHub 接进 Duaer 知识库,员工直接问议题、拉取请求和 README 等文档;公开仓库全员可搜,私有仓库按 GitHub 读权限。
Duaer 能在 GitHub 里搜到什么?
Duaer 索引最近推送的 100 个仓库:每个仓库最近更新的 500 个议题和拉取请求,连同评论;以及默认分支上的 Markdown 文件,例如 README 和 docs 目录,每个仓库最多 200 个。代码不索引。
员工可以问「发票金额差一分钱的问题后来怎么修的?」,Duaer 从议题评论里找到答案并附出处,点出处就在 GitHub 上打开那个议题。
怎么把 GitHub 接进 Duaer?
- 在 GitHub 里创建一个个人访问令牌:经典令牌勾选 repo、read:org 和 read:user;细粒度令牌给内容、议题、拉取请求和元数据的只读权限。账号要能看到希望大家搜到的仓库。
- 在 Duaer 里新建“GitHub API”凭证,填这个令牌;GitHub Enterprise 还要填服务器地址(例如 https://git.acme.com/api/v3)。也可以用“GitHub OAuth2 API”凭证。
- 所有者或管理员打开「知识库」›「数据来源」,在「GitHub」卡片上选择这个凭证,点「连接」。
- 稍等索引完成后,问一个答案就在议题或 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;细粒度令牌需要内容、议题、拉取请求和元数据的只读权限。
同组
把网盘、SharePoint 文件变成能问答的知识库:Duaer 怎么连
把网盘、SharePoint、Notion、Jira、Salesforce、Zendesk 等接进 Duaer 知识库,文件不搬家,回答附出处,每人只看到有权看的内容。
知识库AI 搜索怎么守住文档权限:Duaer 沿用原系统的权限
AI 搜索要守住文档权限,就得按每个人在原系统里的权限过滤结果,而且在生成回答之前就过滤。Duaer 的知识库沿用来源的权限:一份文档只对在原处能打开它的人可见,回答也只用这些内容。
知识库ServiceNow 接进企业知识库:按用户条件和角色搜索
把 ServiceNow 接进 Duaer 知识库,员工直接问知识文章、事件和请求项;文章按用户条件开放,工单由当事人、处理组和服务台搜到。
知识库Zendesk 工单和帮助中心接进企业知识库
把 Zendesk 接进 Duaer 知识库,客服直接问工单和帮助中心文章,按 Zendesk 角色权限和用户细分开放,终端用户搜不到。
知识库AI 回答怎么附出处、不胡编:Duaer 的做法
要让 AI 回答附出处、不胡编,关键是三条:只从提问人能看的资料里找答案,每句话标明出自哪份文件,找不到依据就不答。Duaer 的知识库默认就这样回答。