> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ja/resources-context/github-integration.md).

# GitHub連携

本記事では、 **GitHub連携** 機能について説明します。GitHub リポジトリを接続することで、選択したリポジトリのコードを自動または手動で同期し、AI がコードの内容を参照しながら質問への回答やワークフローを実行できるようになります。

## 前提条件

| 操作              | 必要な権限      |
| --------------- | ---------- |
| GitHub リポジトリの接続 | 管理者 / オーナー |
| リポジトリの選択・変更     | 管理者 / オーナー |
| 同期対象ブランチの変更     | 管理者 / オーナー |
| 手動同期            | 管理者 / オーナー |
| 同期設定の変更         | 管理者 / オーナー |
| GitHub の切断      | 管理者 / オーナー |

## GitHub リポジトリを接続する

<figure><img src="/files/gcgLiVQrdCKyIbRP9tjP" alt="GitHub リポジトリの接続画面のスクリーンショット"><figcaption><p>GitHub リポジトリの接続画面</p></figcaption></figure>

1. ワークスペースページで **リソースとコンテキスト** タブを選択します。
2. **コードベース** を選択します。
3. GitHub カードの **GitHubを接続** をクリックします。
4. GitHub の Genesis アプリインストール画面が表示されたら、インストール先の組織と、アクセスを許可するリポジトリを選択してインストールします。
5. Genesis に戻ったら、 **リポジトリを選択** をクリックします。
6. 同期するリポジトリを選択します。
7. **変更を保存** をクリックします。

## リポジトリを選択・変更する

GitHub 接続後、同期するリポジトリの追加・変更が可能です。リポジトリの選択を外すと、そのリポジトリに対応するコードベースは自動的に削除されます。

<figure><img src="/files/ljw3a0ROwJ7vlQcJGPnG" alt="リポジトリ選択画面のスクリーンショット"><figcaption><p>リポジトリ選択画面</p></figcaption></figure>

1. ワークスペースページで **リソースとコンテキスト** タブを選択します。
2. **コードベース** を選択します。
3. **選択されたリポジトリ** セクションの **編集** をクリックします。
4. 同期するリポジトリを選択または選択解除します。
5. **変更を保存** をクリックします。

## 同期対象のブランチを変更する

接続済みのリポジトリごとに、同期するブランチを変更できます。指定しない場合はリポジトリのデフォルトブランチが同期されます。

<figure><img src="/files/3PWLq3ZQr6JQcGwAA510" alt="ブランチセレクターのスクリーンショット"><figcaption><p>ブランチセレクター</p></figcaption></figure>

1. ワークスペースページで **リソースとコンテキスト** タブを選択します。
2. **コードベース** を選択します。
3. **選択されたリポジトリ** セクションで、対象リポジトリの行に表示されている現在のブランチ名のボタンをクリックします。
4. 一覧から同期したいブランチを選択します。検索ボックスにブランチ名を入力して絞り込めます。

## 手動で同期する

GitHub リポジトリの内容を手動で最新状態に更新します。

<figure><img src="/files/A49yWNPkz51ny9BmEGrA" alt="手動同期ボタンのスクリーンショット"><figcaption><p>手動同期ボタン</p></figcaption></figure>

1. ワークスペースページで **リソースとコンテキスト** タブを選択します。
2. **コードベース** を選択します。
3. GitHub カードの **同期** をクリックします。

## 同期設定を変更する

手動同期に加え、プッシュ/コミットイベントに連動した同期や、スケジュールに沿った定期同期を設定できます。

<figure><img src="/files/hmlPHJZ7Bb4yE4SPADRC" alt="同期設定ダイアログのスクリーンショット"><figcaption><p>同期設定ダイアログ</p></figcaption></figure>

1. ワークスペースページで **リソースとコンテキスト** タブを選択します。
2. **コードベース** を選択します。
3. **同期設定** セクションの **設定** をクリックします。
4. 同期タイミングを選択します。
   * **手動同期**: 手動でトリガーした場合のみ同期します。
   * **プッシュ/コミット時に同期をトリガー**: 選択したブランチにコードがプッシュされたときに自動的に同期します。
   * **自動同期を有効にする**: 指定した頻度・時刻で定期的に同期します。**頻度**（毎日 / 毎週 / 毎月）と **時刻** を指定し、**毎週** の場合は **曜日**、**毎月** の場合は **日付** も合わせて指定します。
5. **保存** をクリックします。

## GitHub を切断する

<figure><img src="/files/E9r1M3k6jgkssW8KbUXx" alt="GitHub 切断メニューのスクリーンショット"><figcaption><p>GitHub 切断メニュー</p></figcaption></figure>

1. ワークスペースページで **リソースとコンテキスト** タブを選択します。
2. **コードベース** を選択します。
3. GitHub カードの右端にある **メニュー** (<img src="/files/pTrmcFZqvNfp5VCEKV64" alt="" data-size="line">) をクリックします。
4. **切断** をクリックします。

## トラブルシューティング

### GitHub 連携のエラー

| 状況                                | 原因                              | 対処方法                                             |
| --------------------------------- | ------------------------------- | ------------------------------------------------ |
| **GitHubを接続** からの認証でエラーになる        | GitHub アカウントの権限不足、またはアクセスが拒否された | GitHub アカウントの権限を確認し、再度接続を試みてください                 |
| 「リポジトリの同期に失敗しました」と表示される           | ネットワークエラーまたは GitHub API の一時的な障害 | **同期** を再度クリックして手動同期を試みてください                     |
| 同期が既に進行中というメッセージが表示される            | 別の同期処理が実行中                      | 現在の同期が完了するまで待ってから再試行してください                       |
| 「GitHub の切断に失敗しました」と表示される         | ネットワークエラーまたはサーバーの一時的な障害         | ページを再読み込みして再度試みてください                             |
| 「GitHub インストールの読み込みに失敗しました」と表示される | GitHub 連携情報の取得に失敗した             | ページを再読み込みしてください。解消しない場合は GitHub を一度切断して再接続してください |
| 「コードアーカイブの削除に失敗しました」と表示される        | 削除処理中にエラーが発生した                  | ページを再読み込みして再度試みてください                             |
| 「ブランチを読み込めませんでした」と表示される           | リポジトリのブランチ一覧の取得に失敗した            | ページを再読み込みしてください。解消しない場合は GitHub を一度切断して再接続してください |
| 「ブランチを変更できませんでした」と表示される           | ネットワークエラーまたはサーバーの一時的な障害         | しばらく待ってから再度試みてください                               |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.genesis.autify.com/features-ja/resources-context/github-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.