本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon Q Developer for GitHub (預覽版)
**注意**
Amazon Q Developer for GitHub 為預覽版本，並可能有所變更。
[Amazon Q Developer for GitHub 或 GitHub Enterprise Cloud](https://github.com/marketplace/amazon-q-developer) 可讓您針對軟體開發工作流程使用 Amazon Q Developer 功能。透過專門的開發代理程式，您可以實作新想法、檢閱品質問題的程式碼，以及透過單元測試解決漏洞。一旦代理程式完成任務，您就可以提供意見回饋，代理程式會對先前的解決方案進行迭代。如需詳細資訊，請參閱[Amazon Q Developer 代理程式](#github-agents)。
您可以透過 [https://github.com/marketplace/amazon-q-developer](https://github.com/marketplace/amazon-q-developer) 存取 Amazon Q Developer 整合，並授權它提供組織儲存庫的存取權。若要開始使用 Amazon Q Developer for GitHub，請參閱 [快速入門：安裝、使用 GitHub 中的功能，以及提高用量限制](github-quickstart.md)。
**重要**
若要安裝 Amazon Q Developer 應用程式並授權存取 GitHub 儲存庫，您必須符合 GitHub 組織的需求。如需詳細資訊，請參閱 *GitHub 文件*中的[安裝 GitHub 應用程式的需求](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app)和[組織中的角色](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)。
**注意**
Amazon Q Developer 與 GitHub 的整合會在美國境內處理資料。如需詳細資訊，請參閱 [Amazon Q Developer 中的跨區域處理](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/cross-region-processing.html)。
**注意**
Amazon Q Developer for GitHub (預覽版) 目前不會使用您的內容來改善服務。如果未來啟用此功能，我們會適時通知您，並提供讓您選擇退出此類使用的方式。
**Topics**
+ [安裝 Amazon Q Developer 應用程式並授權存取](#github-concepts-set-up)
+ [Amazon Q Developer 代理程式](#github-agents)
+ [註冊應用程式安裝](#github-concepts-register-app-install)
+ [在 GitHub 中使用瀏覽器延伸模組](#github-concepts-extensions)
+ [在 GitHub 問題和提取請求中使用斜線命令](#github-slash-commands)
+ [快速入門：安裝、使用 GitHub 中的功能，以及提高用量限制](github-quickstart.md)
+ [在 GitHub 中使用 Amazon Q Developer 開發功能和進行迭代](github-feature-development.md)
+ [在 GitHub 中使用 Amazon Q Developer 檢閱程式碼](github-code-reviews.md)
+ [在 Amazon Q Developer 主控台中提高用量限制和設定詳細資訊](github-register-app-install.md)
+ [設定已註冊的安裝詳細資訊](github-configuration.md)
+ [Amazon Q Developer for GitHub 問題故障診斷](github-troubleshooting.md)
## 安裝 Amazon Q Developer 應用程式並授權存取
身為GitHub組織管理員，您可以[https://github.com/apps/amazon-q-developer](https://github.com/apps/amazon-q-developer)免費從 安裝和設定 Amazon Q Developer 應用程式，而無需設定 AWS 帳戶即可開始使用。在安裝過程中，您可以選擇提供 GitHub 組織中所有或所選儲存庫的存取權。安裝並授權後，您就可以取得 GitHub 中 Amazon Q Developer 功能的免費用量。您可以在 [Amazon Q Developer 主控台](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github)中註冊應用程式安裝，以增加免費用量。如需詳細資訊，請參閱[快速入門：安裝、使用 GitHub 中的功能，以及提高用量限制](github-quickstart.md)。
**重要**
若要安裝 Amazon Q Developer 應用程式並授權存取 GitHub 儲存庫，您必須符合 GitHub 組織的需求。如需詳細資訊，請參閱 *GitHub 文件*中的[安裝 GitHub 應用程式的需求](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app)和[組織中的角色](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)。
**注意**
如果您的 GitHub 企業組織已啟用 IP 允許清單，那麼您必須在 GitHub 應用程式上接受允許的 IP 位址。您也可以選擇自動新增 IP 位址至允許清單。如需詳細資訊，請參閱 *GitHub 文件*中的[允許 GitHub 應用程式存取](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps)和[啟用允許的 IP 位址](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#enabling-allowed-ip-addresses)。
下列 IP 位址可用於存取您的 GitHub 資源：
```
34.228.181.128
44.219.176.187
54.226.244.221
```
## Amazon Q Developer 代理程式
從編碼、測試和部署到故障診斷，Amazon Q Developer 代理程式在整個軟體開發生命週期提供支援。
+ **Amazon Q 開發代理程式** - 建立問題並新增功能開發標籤後，Amazon Q Developer 會自動實作您的新功能和錯誤修正。Amazon Q Developer 會建立提取請求，其中包含變更和變更摘要。您也可以在問題註解中使用 `/q dev` 斜線命令初始化功能開發，而不套用標籤。如需詳細資訊，請參閱[在 GitHub 中使用 Amazon Q Developer 開發功能和進行迭代](github-feature-development.md)。
+ **Amazon Q 程式碼檢閱代理程式** - 當新的提取請求建立，或關閉的提取請求重新開啟時，Amazon Q Developer 會自動執行程式碼檢閱，並提供有關程式碼品質、潛在問題和安全疑慮的意見回饋。Amazon Q Developer 也會針對已識別的問題產生修正，您可以進行檢閱並選擇遞交提取請求。程式碼檢閱包含內有執行緒問題清單的程式碼檢閱摘要。您可以在提取請求註解中使用 `/q` 命令與 Amazon Q Developer 互動，以提出有關程式碼檢閱問題清單的問題。
在現有提取請求內的後續遞交並不會觸發自動程式碼檢閱。您可以使用 `/q review` 斜線命令在提取請求內初始化其他程式碼檢閱。如需詳細資訊，請參閱[在 GitHub 中使用 Amazon Q Developer 檢閱程式碼](github-code-reviews.md)。
**重要**
Amazon Q Developer 應用程式會嘗試在您授權存取的GitHub儲存庫中自動建立 **Amazon Q 開發代理**程式標籤。如果標籤未自動建立，或意外刪除，您可以在 中手動建立標籤GitHub。標籤必須命名為 **Amazon Q 開發代理**程式，才能將其識別並處理為 Amazon Q 開發人員標籤。如需詳細資訊，請參閱文件 *GitHub 文件*中的[建立標籤](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label)。
## 註冊應用程式安裝
GitHub 的 Amazon Q Developer 整合為免費提供，不需設定 AWS 帳戶即可開始使用。您每月獲得有限的功能開發調用，以及每月程式碼檢閱的有限行數。您可以透過 AWS 帳戶註冊 Amazon Q Developer 應用程式安裝，以增加免費用量。如需詳細資訊，請參閱[在 Amazon Q Developer 主控台中提高用量限制和設定詳細資訊](github-register-app-install.md)。
**重要**
若要在 Amazon Q Developer 主控台中註冊應用程式安裝，您必須符合 GitHub 組織的需求。如需詳細資訊，請參閱 *GitHub 文件*中的[安裝 GitHub 應用程式的需求](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app)和 [OAuth 應用程式和組織](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations)。
## 在 GitHub 中使用瀏覽器延伸模組
您可以在支援的瀏覽器中使用 Amazon Q Developer 擴充功能，快速新增標籤以在GitHub問題中開發功能，而無需搜尋標籤功能表。
Amazon Q Developer 延伸模組適用於下列瀏覽器：
+ [Google Chrome](https://chromewebstore.google.com/detail/amazon-q-github-issue-hel/oefafjbablenakmhacfllkmpaeabnnfi)
+ [Mozilla Firefox](https://addons.mozilla.org/en-US/firefox/addon/amazon-q-github-issue-helper)
+ [Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/amazon-q-github-issue-helper/poghackjbfhejeppjaegbnblangjbmmc)
## 在 GitHub 問題和提取請求中使用斜線命令
您可以在 GitHub 問題內的註解中或提取請求中使用斜線命令，以調用 Amazon Q Developer 來執行開發任務或提供支援。
+ `/q dev` - 在 GitHub 問題中調用 Amazon Q Developer，以自動實作新功能和錯誤修正。Amazon Q Developer 會建立提取請求，其中包含變更和變更摘要。
+ `/q review` - 調用 Amazon Q Developer 以在建立或重新開啟提取請求時，自動執行程式碼檢閱。程式碼檢閱提供了有關程式碼品質、潛在問題和安全疑慮的意見回饋，以及建議的修正和包含執行緒問題清單的程式碼檢閱摘要。在提取請求註解中使用 `/q` 與問題清單互動。對現有提取請求的後續遞交並不會觸發自動檢閱。
+ `/q help` - 提供有關 Amazon Q Developer for GitHub 的資訊，包括斜線命令、功能、自訂詳細資訊，以及《Amazon Q Developer 開發人員指南》**中 [Amazon Q Developer for GitHub (預覽版)](#amazon-q-for-github) 文件的連結。