使用 GitHub 連接器將 github.com 連接到代理程式，以管理問題、拉取請求和工作流程。 透過入口網站的 Builder > Connectors 設定連接器。
Note
本教學涵蓋了 GitHub 連接器，用於議題、公關及工作流程操作。 關於調查期間的程式碼上下文，請參見 Connect 原始碼。 關於企業雲GitHub，請參見 Connect GitHub Enterprise Cloud。
先決條件
- 處於 運行 狀態的主動代理人
- 你想讓代理程式使用的
github.com存放庫存取權限 - 代理角色： 管理員 或 標準使用者
打開 GitHub 連接器設定
- 在入口網站中開啟您的 Agent。
- 前往 產生器 > 連接器。
- 選擇 新增連接器。
- 選擇 GitHub OAuth 連接器。
選擇驗證方法
選擇一種方法：
| Method | 何時使用 |
|---|---|
| OAuth | 使用者主導存取的互動設定 |
| PAT | 服務帳號或非互動式設定 |
OAuth 流程
- 選擇 OAuth。
- 選取 [登入 GitHub]。
- 完成 GitHub 彈出視窗授權。
- 確認狀態顯示 已連接。
PAT 流程
- 選擇 PAT。
- 貼上具有必要權限的 GitHub Token。
- 選擇 連線。
- 確認狀態顯示 已連接。
確認 GitHub 連接器執行階段作業
儲存接頭後，用聊天提示測試：
List recent issues from owner/repo and summarize the top 3 risks.
使用直接驗證提示作為最終檢查點：
Get me recent issues from owner/repo.
依操作規定的必要權限
| 運算 | OAuth/PAT 最低標準 |
|---|---|
| 閱讀資料庫的元資料/內容 |
repo 用於私人儲存庫（public_repo 僅限公開儲存庫） |
| 列出或建立問題 | 具備 Issue 功能的儲存庫存取權限 |
| 提取要求作業 | 具備 PR 功能的存放庫存取權 |
對連接進行疑難排解
| 癥狀 | 可能的原因 | 修復 |
|---|---|---|
| 連接器顯示已斷線 | 代幣已過期或撤銷 | 重新驗證 OAuth 或旋轉 PAT |
| 問題讀取正常，但 PR 動作失敗 | 缺少 PR 權限 | 授予 PR 權限並重試 |
| 連接器無法存取私人存放庫 | 代幣範圍太窄 | 針對私人存放庫使用 repo 範圍 |
| 彈出視窗無法打開 | 瀏覽器彈出視窗被封鎖 | 允許入口網站網域的快顯視窗 |