接入 GitHub 代码库

更新时间:
复制 MD 格式

使用个人访问令牌将 GitHub 代码库接入数字员工后,会话和长期任务可按所选范围访问这些代码库。

适用条件

  • 已创建数字员工。

  • 已准备 Fine-grained PAT 或 Classic PAT,且该令牌有权访问目标组织和代码库。

操作步骤

1. 打开代码访问

点击 设置 > 连接器 > 代码访问。

2. 选择 GitHub Code

  1. 点击 添加代码访问。

  2. 选择 GitHub Code。

  3. 点击 下一步。

3. 填写连接器信息

  1. 连接器 ID:用于唯一标识连接器,创建后不可修改。规则:长度 1–64,仅小写字母、数字和短横线,以字母开头,以字母或数字结尾。

  2. 名称:用于在列表中区分连接。

4. 配置凭证

  1. 填写 个人访问令牌(PAT)。

  2. 点击 校验令牌。校验成功后,页面显示当前 GitHub 账号。

已保存的令牌不会回显。再次校验时需要重新填写 PAT。

5. 选择组

在 组织 步骤中选择个人账号,或选择此 PAT 可见的成员组织。也可搜索组织名称后添加。

搜索结果可能包含非成员组织,加载代码库时会再次校验访问权限。无法读取组织成员关系时,仍可手动搜索组织。

6. 选择代码库

在 接入范围 中选择此连接器允许访问的代码库。确认后点击 下一步。

该组下没有代码库时,请核对组织和 PAT 权限。

7. 配置数据建模

  • 基础建模:固定开启。连接器创建后,对选中的 GitHub 代码库及其基础关系进行建模。

  • Agentic 关联探索:可选。基础建模后,探索其与应用、基础设施和可观测数据等跨来源关系。建模会发起 Chat,按所选模型及实际用量计费。

8. 检查并保存

在 检查并添加 中核对连接器、组织和已选资源数量。确认后点击 保存。

保存后系统会检查连接状态。代码访问列表中出现该连接器。

验证

建议按照下述方案验证连接器是否添加成功:

  1. 在 代码访问 列表中,该连接器的名称、类型 GitHub Code、状态 成功,以及组和已选资源数量与创建时一致。

  2. 打开详情,核对组织与已选代码库。

常见问题

GitHub 拒绝了该令牌

请检查令牌内容、是否过期,以及是否具备目标组织和代码库的访问权限。

无法读取组织成员关系

请确认 PAT 具备 read:org 权限,或改为手动搜索组织。

该组下没有找到代码库

请核对所选组、令牌权限,以及该组下是否已有仓库。

GitHub 接口调用达到限额

请稍后重试。

连接器状态为失败

可重新检查连接状态。仍失败时,请删除后重新创建。