Z Tag
管理组织服务与凭证配置

GitHub

配置 GitHub PAT,让 ZAI 调用 GitHub API。

适用于组织 Owner / Admin;成员的个人连接器同样适用

在连接器的 访问内容 → 添加访问 中,从 服务预设 选择 GitHub,使用 推荐配置。

获取与填写凭证

  1. 登录 GitHub,在账号 Settings → Developer settings → Personal access tokens → Fine-grained tokens 创建 Token。
  2. 选择资源所有者、允许的仓库和所需 Repository permissions。只读查询按实际 API 选择读取权限;修改代码、Issue 或 Pull request 需要对应写入权限。组织可能要求审批。
  3. 复制生成后显示的 Token,填入 PAT。不添加 Bearer 前缀。

官方说明:管理 personal access token。

服务地址

推荐配置固定使用 https://api.github.com,以 Bearer 方式发送 PAT;其他地址改用 自定义。

API 访问范围

这份凭证只用于调用 GitHub API,不能用来拉取或推送代码;拉取、推送代码和 LFS 文件请在连接器的 访问内容 分区中配置,参见 Git 仓库。

能访问哪些仓库和资源由 Token 本身的权限决定。要限制到具体 API 路径或请求方法,切换到 自定义,在 访问目标 的 协议、路径和内网设置 里填写。

ZAI 可以用预装的 GitHub CLI(gh)或 HTTP 请求,通过这份凭证查看和处理仓库、Issue 与 Pull request;能做哪些操作,同样由 Token 的权限决定。

验证

保存后请 ZAI 读取一次当前账号(GET /user),确认凭证可用;再读取一次目标仓库(GET /repos/<owner>/<repo>),确认 Token 能访问它。Token 未获准访问该仓库,或组织尚未批准这个 Token 时,会返回 404 或 403。其余排查见验证与排错。

本页目录