Git 集成
面向 AI Agent:本页的 Markdown 版本位于 https://ankole.agentbull.com/zh-Hans-CN/docs/git-integration/index.md,全站文档索引位于 https://ankole.agentbull.com/zh-Hans-CN/llms.txt。
无论是在日常对话还是后台 Agent 任务中,Ankole Agent 都可以调用 Worker 提供的 Shell 工具运行标准 Git 命令。
Agent 在专属 Worker 上通过常规 Shell 与文件工具操作持久化 /workspace 目录中的 Git 仓库;即使销毁容器实例或更换镜像,仓库数据依然保留。
agent 能用 git 做什么
借助 command 工具,Agent 会以 Worker 运行用户的身份执行 Git 命令:
git clone https://github.com/your-org/your-repo.git
git checkout -b feature/agent-fix
git add -A && git commit -m "Fix: resolve the null-pointer case"
git push origin feature/agent-fix
Agent 先将代码仓库克隆到工作空间(位于 /workspace/jobs/<job-id>/ 或 sessions/<id>/ 下),随后使用文件编辑与补丁工具修改代码,并通过 Shell 完成提交和推送,全程均以 Worker 用户身份运行。
在普通对话中,Agent 直接在前台调用 Shell 和文件工具;若将工作委派给后台任务,任务会在独立工作区中运行,结束后按约定回传结果或静默退出。详见 后台 Agent 任务。
需要什么
- 配置 Git 凭证。 对于 GitHub(含 GitHub Enterprise),推荐直接在 Pod → 连接(Connections)(
Ankole.Connectors)中配置 GitHub App 安装或个人 OAuth 授权:Ankole 会在每轮执行时自动注入绑定当前回合权限的GIT_ASKPASS凭证助手(调用控制面POST /api/internal/connectors/git-credentials),使git clone、git fetch与git push无需在 Worker 环境变量中存放静态令牌即可直接完成 HTTPS 认证。若对接其他 Git 托管平台,仍可在 Console → 环境变量中将 SSH 密钥或个人访问令牌(PAT)保存为加密变量(如GIT_SSH_KEY或GIT_TOKEN),详见 环境变量。 - 打通 Worker 到代码仓库的网络。 Worker 必须能够连接目标 Git 主机;若部署在私有网络中,请先确认 Worker 到 Git 服务器的路由可达。采用 Docker Compose 部署时,Worker 容器位于
ankole_workers网络中,可同时访问控制面和公网,因此能够直接连接公网上的 Git 主机。采用 Helm Chart 部署并开启networkPolicy.enabled时,Worker Pod 可访问控制面、DNS 和公网地址;但若 Git 服务器位于私有网段,且该网段仍列在networkPolicy.workerDeniedCIDRs中,连接就会被拦截。 - 按需配置模型档案。 Agent 默认继承站点与 Pod 的模型档案,后台 Agent 任务默认走
heavy档案并按heavy → primary顺序跨 Agent、Pod 与站点层级自动回退;仅当需要为该 Agent 或后台任务指定专属提供商与模型时,才需单独设置覆盖档案。
工作空间
Git 仓库会克隆到按 Session 或按任务隔离的工作空间目录中:
/workspace/
└── jobs/<job-id>/
└── your-repo/ # 克隆到这里
├── .git/
└── ... # 工作树
替换 Worker 或升级镜像后,/workspace 中的仓库数据仍会保留。不过,若要防范底层存储故障导致的数据丢失,仍需及时推送至远程仓库或另行备份。如需将构建产物或交付件共享到 /workspace 之外,Agent 可直接写入 /drive(如 /drive/ChatDrive 或 /drive/Public;在不支持 FUSE 的 Worker 上则回退使用 ankole-files put),详见 文件管理。
一个完整示例
下面以配置一个负责审查 PR 的研发 Agent 为例:
- 在 **Pod → 连接(Connections)**中连接 GitHub App 或个人 OAuth 账号(对接非 GitHub 代码托管服务时,则在 Console → 环境变量中配置加密的 SSH 密钥或 PAT)。
- 创建 Agent——它会自动继承站点与 Pod 默认模型档案;仅在需要定制日常对话或后台任务模型时,再单独配置覆盖槽位或
heavy档案。 - 在 Meta Ankole → Agents 中编辑该 Agent 的
AGENTS.md契约,写明目标代码仓库、审查标准与分支命名约定。 - 在频道中向 Agent 发送指令:“审查
your-repo上最新的 PR:克隆仓库、检出分支、运行测试,并汇报发现的问题。” - 收到指令后,Agent 会克隆仓库、切换分支、通过
command工具运行测试并回复审查结果。整套流程既可在当前对话中直接完成,也可委派给后台 Agent 任务执行。
本指南不是什么
- 不是 Git 教程:Agent 直接运行标准 Git 命令,无需特殊语法。
- 不是内置 CI/CD 服务:Ankole 本身不托管 CI 流水线;但如果目标仓库支持通过命令行触发 CI,Agent 可在 Shell 中直接调用。
- 不是固定的代码审查流水线:Agent 如何审查代码完全取决于其人设与使命文件定义,底层统一通过 Shell 工具执行。
下一步
- 了解 Shell 工具的用法,请参阅 代码执行。
- 了解后台执行机制,请参阅 后台 Agent 任务。
- 了解如何安全存储 Git 凭证,请参阅 环境变量。
- 了解如何使用 Agent 云盘,请参阅 文件管理。