GitHub 上的 Gemini Code Assist 可做為程式碼審查人員,在提取要求程序中發揮 Gemini 的強大功能。GitHub 專用 Gemini Code Assist 會使用 Gemini 輔助的代理程式,自動摘要說明提取要求並提供深入的程式碼審查,加快審查速度並提升程式碼品質。
在 GitHub 上設定 Gemini Code Assist 後,您可以在提取要求程序的任何階段叫用 Gemini Code Assist 來審查程式碼。您可以直接在提取要求註解中與 Gemini Code Assist 互動,方法如下:
- 針對 Gemini Code Assist 建立的評論提出澄清問題。
- 在註解中加入
/gemini標記,提示 Gemini Code Assist 根據提取要求提出問題。
Gemini Code Assist 會自動從存放區和提取要求中擷取實用資訊,以執行工作。
本文件適用於各種程度的開發人員。並假設您具備 GitHub 的工作知識。
消費者版和企業版
GitHub 上的 Gemini Code Assist 提供消費者版 (直接在 GitHub 安裝) 和企業版 (透過 Google Cloud 安裝)。
下表摘要說明消費者版和企業版的差異:
| 消費者版 | 企業版 (預覽) | |
|---|---|---|
| 設定方式 | 直接在 GitHub 中 | 透過 Google Cloud 管理 |
| 服務條款 | Google 服務條款 | Google Cloud 服務條款 |
| 配額 | 每天 33 個提取要求 | 每天 100 個以上的提取要求 |
| 樣式指南 | 在 GitHub 中設定每個存放區 | 可透過 GitHub 針對每個存放區設定,或透過 Google Cloud 針對多個存放區設定 |
| GitHub 支援 |
GitHub |
GitHub |
注意事項
企業版使用開發人員連線連線,將 GitHub 存放區連結至 Google Cloud。
這個 Developer Connect 連線一律會在
us-east1區域中建立。您必須使用 Gemini Code Assist「代理程式和工具」中的「Code Assist 原始碼管理」部分,建立這個 Developer Connect 連線。如需操作說明,請參閱「在 GitHub 上設定 Gemini Code Assist」。
在 GitHub 上使用 Gemini Code Assist
本節提供完成設定後,在 GitHub 上使用 Gemini Code Assist 的步驟。本節適用於 GitHub 上的 Gemini Code Assist 消費者版和企業版。
事前準備
如要完成本節中的工作,請務必在 GitHub 上設定 Gemini Code Assist。
取得提取要求摘要和意見回饋
如要讓 Gemini Code Assist 針對提取要求進行初步審查,請建立新的提取要求。
開啟新的提取要求時,Gemini Code Assist 會提供初步審查結果。審查準備就緒後,gemini-code-assist[bot] 會自動新增為提取要求的審查人員。Gemini Code Assist 會在提取要求的「對話」分頁中新增問題註解,提供意見回饋,並針對修改過的程式碼部分新增註解。
評論包含下列資訊:
- 問題的嚴重程度,包括「重大」、「高」、「中」和「低」
- 對問題提供意見
- 可直接從 GitHub 提交的程式碼建議
- 參考使用者提供的樣式指南
Gemini Code Assist 不會新增嚴重程度低於為存放區設定的最低嚴重程度門檻的註解。
手動叫用 Gemini Code Assist
Gemini Code Assist 會聆聽任何提取要求貢獻者的留言,並決定是否要回覆。
如要手動叫用 Gemini Code Assist,可以在提取要求的主要留言頁面中,使用下列指令做為問題留言。
| 指令 | 說明 |
|---|---|
/gemini summary |
發布提取要求中的變更摘要 |
/gemini review |
發布提取要求中變更的程式碼審查 |
/gemini |
在註解中手動叫用 Gemini Code Assist |
/gemini help |
可用指令總覽 |
管理 Gemini Code Assist 設定
只要有權限修改組織的 GitHub 應用程式設定,就能管理 Gemini Code Assist 應用程式設定。您可以查看 Gemini Code Assist 應用程式的權限、管理存放區存取權,以及解除安裝 Gemini Code Assist 應用程式。
如要修改設定,請按照下列步驟操作:
- 在 GitHub 上,按一下個人資料相片,然後按一下「Settings」。
- 在「整合」部分,按一下「應用程式」。 系統會顯示 GitHub 應用程式清單。
- 按一下「Gemini Code Assist」旁的「設定」。
疑難排解
如果你在 GitHub 上使用 Gemini Code Assist 的企業版,但 Gemini Code Assist 沒有回應,可能是因為你在設定時使用的 Google Cloud 專案未連結至有效的帳單帳戶。您應確認專案的帳單狀態,並視需要將專案連結至有效的帳單帳戶。
請注意,Developer Connect 提供大量免費層級,且在預先發布期間,使用 GitHub 上的企業版 Gemini Code Assist 不會產生任何費用。您必須擁有有效的帳單帳戶,但只有在用量超出免費方案限制時,才會產生費用。