GitHub コネクタを使用してgithub.comをエージェントに接続し、問題、プル要求、ワークフローを管理します。 ポータルで Builder > コネクタを 使用してコネクタを構成します。
Note
このチュートリアルでは、問題、PR、およびワークフロー操作のGitHub コネクタについて説明します。 調査中のコード コンテキストについては、「 ソース コードの接続」を参照してください。 GitHub Enterprise Cloud については、「Connect GitHub Enterprise Cloud」を参照してください。
Prerequisites
- 実行中の状態のアクティブなエージェント
- エージェントで使用する
github.comリポジトリへのアクセス - エージェント ロール: 管理者 または 標準ユーザー
GitHub コネクタのセットアップを開く
- ポータルでエージェントを開きます。
- Builder > コネクタに移動します。
- [ コネクタの追加] を選択します。
- GitHub OAuth コネクタを選択します。
認証方法の選択
1 つの方法を選択します。
| Method | いつ使用するか |
|---|---|
| OAuth | ユーザー主導のアクセスの対話型設定 |
| PAT | サービス アカウントまたは非対話型セットアップ |
OAuth フロー
- [OAuth] を選択します。
- [GitHub にサインイン] を選択します。
- GitHub ポップアップ承認を完了します。
- 状態が [ 接続済み] と表示されたことを確認します。
PAT フロー
- PAT を選択します。
- 必要なスコープを持つGitHub トークンを貼り付けます。
- 接続を選択します。
- 状態が [ 接続済み] と表示されたことを確認します。
GitHub コネクタのランタイム操作を確認
コネクタを保存した後、チャット プロンプトでテストします。
List recent issues from owner/repo and summarize the top 3 risks.
最終チェックポイントとして直接検証プロンプトを使用します。
Get me recent issues from owner/repo.
操作に必要なアクセス許可
| Operation | OAuth/PAT の最小値 |
|---|---|
| リポジトリメタデータ/コンテンツの読み取り |
repo プライベート リポジトリの場合 (パブリック専用のpublic_repo ) |
| 問題の一覧表示または作成 | Issue 機能を利用できるリポジトリへのアクセス |
| プル要求操作 | PR 対応リポジトリ アクセス |
接続の問題解決
| 症状: | 考えられる原因 | 修正 |
|---|---|---|
| コネクタが切断されていることを示す | トークンの期限切れまたは取り消し | OAuth の再認証または PAT のローテーション |
| Issue の読み取りは機能するが、PR アクションは失敗する | PR アクセス許可の不足 | PR アクセス許可を付与して再試行する |
| コネクタがプライベート リポジトリにアクセスできない | トークン スコープが狭すぎます | プライベート リポジトリには repo スコープを使用する |
| ポップアップが開かない | ブラウザー ポップアップがブロックされました | ポータル ドメインのポップアップを許可する |