Git 統合
AI Agent 向け: このページの Markdown 版は https://ankole.agentbull.com/ja-JP/docs/git-integration/index.md、ドキュメント索引は https://ankole.agentbull.com/ja-JP/llms.txt にあります。
Ankole Agent は、自身の Worker 上にある標準のシェルツールを使って git コマンドを実行します。通常の会話でも Background Agent Job でも、同じツールをそのまま利用できます。
永続 /workspace 内の git リポジトリは通常のシェルツールやファイル操作ツールで扱え、Worker インスタンスの入れ替えやイメージの更新を行ってもそのまま保持されます。
agent が git でできること
Agent は command ツールを使い、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
ワークスペース(/workspace/jobs/<job-id>/ または sessions/<id>/)にリポジトリをクローンし、ファイル編集ツールやパッチ適用ツールで変更を加えたうえで、コミットとプッシュを行います。これらの操作はすべてシェル経由で、Worker のユーザー権限のもとで実行されます。
通常の会話では、フォアグラウンドでシェルツールとファイルツールを使用します。一方、作業を Background Agent Job に委任した場合は、Job ごとに独立したワークスペースで処理が進み、完了後に結果を返すか、通知を出さずに終了します。このワークフローの詳細は Background Agent Jobs を参照してください。
必要なもの
- Git の認証情報。 GitHub(Cloud または Enterprise)では、Pod → Connections(
Ankole.Connectors)で GitHub App インストールまたは個人 OAuth アカウントを接続する方法を推奨します。Ankole が Turn スコープのGIT_ASKPASSクレデンシャルヘルパー(POST /api/internal/connectors/git-credentials)を自動注入するため、WorkerEnvに静的トークンを保存しなくても HTTPS 経由でgit clone・git fetch・git pushを認証できます。それ以外の Git ホストを使う場合は、Console → Environment variables で SSH キーや PAT をGIT_SSH_KEYやGIT_TOKENなどの暗号化変数として保存してください(詳しくは Environment variables を参照)。 - Worker からアクセス可能なリポジトリ。 Worker から git ホストへネットワーク経由で到達できる必要があります。プライベートネットワーク環境では、Worker から対象の git サーバーへ接続できるか事前に確認してください。Docker Compose 環境では、Worker コンテナは
ankole_workersネットワークに接続されており、コントロールプレーンとインターネットの双方に通信できるため、パブリックな git ホストへそのままアクセスできます。Helm チャートでnetworkPolicy.enabledを有効にした場合も、Worker Pod からコントロールプレーン、DNS、パブリックアドレスへは通信できますが、プライベートアドレス上の git サーバーについては、該当するアドレス帯がnetworkPolicy.workerDeniedCIDRsに含まれている限りアクセスできません。 - モデルプロファイル(個別指定が必要な場合のみ)。 Agent は上書きしない限りサイトと Pod のモデルプロファイルを継承し、Background Agent Job は既定で
heavyを使用して未設定時はprimaryへフォールバックします。Background Agent Job で専用の Provider やモデルを使いたい場合にのみ、heavyプロファイルを設定してください。
workspace
git リポジトリは、セッションまたは Job ごとのワークスペースにクローンされます。
/workspace/
└── jobs/<job-id>/
└── your-repo/ # cloned here
├── .git/
└── ... # the working tree
/workspace 内のリポジトリは、Worker の入れ替えやイメージの更新を行っても維持されます。ただし、ストレージ障害に備えるため、変更内容はリモートリポジトリへプッシュするか、別途バックアップを取ってください。ビルド成果物や納品物を /workspace の外へ共有する場合は、/drive(たとえば /drive/ChatDrive や /drive/Public、FUSE 非対応の Worker ではフォールバックの ankole-files put)へ直接書き出します(詳しくは ファイル管理 を参照)。
実践例
PR をレビューするコーディング Agent をセットアップする手順は次のとおりです。
- Pod → Connections で GitHub App または個人 OAuth アカウントを接続します(GitHub 以外のホストでは Console → Environment variables に暗号化した SSH キーまたは PAT を保存します)。
- Agent を作成します。サイトおよび Pod の既定モデルプロファイルが自動で継承されるため、通常の会話や Background Agent Job で別のモデルを使いたい場合にのみ個別の上書きや
heavyプロファイルを設定します。 - Meta Ankole → Agents でその Agent の
AGENTS.md規約を編集し、リポジトリ名、レビュー基準、ブランチ命名規約を記載します。 - チャネルで Agent に次のように依頼します。「
your-repoの最新 PR をレビューしてください。クローンしてチェックアウトし、テストを実行したうえで、見つかった問題点を報告してください。」 - 依頼を受けると、Agent は
commandツールを使ってクローン、チェックアウト、テスト実行を進め、結果を報告します。この一連の作業は会話の中で直接進めることも、Background Agent Job に委任することも可能です。
このガイドではないもの
このページは git 自体のチュートリアルではなく、Agent が標準の git コマンドをどう実行するかに焦点を当てています。また、CI/CD 連携の機能でもありません。Ankole 自体が CI を実行することはありませんが、リポジトリ側の CI をコマンドから起動できる構成であれば、Agent がシェルコマンド経由で起動することは可能です。さらに、専用のコードレビュー自動化機能を提供するものでもありません。Agent は Persona で指示された方針に従い、シェルツールを使ってコードを読み解きレビューを行います。
次のステップ
- シェルツールについては Code execution を参照してください。
- バックグラウンド実行については Background Agent Jobs を参照してください。
- Git の認証情報については Environment variables を参照してください。
- Agent のドライブについては File management を参照してください。