建立自訂 - Amazon Q Developer
連線至資料來源自訂和您的資料故障診斷

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

建立自訂

本節說明如何使用 Amazon Q 建立自訂。

若要建立自訂，請遵循下列程序：

  1. 依照 透過 IAM Identity Center 開始使用 中的指示，讓使用者訂閱 Amazon Q Developer 專業方案。在訂閱過程中，您將安裝 Amazon Q Developer 設定檔，這是建立自訂的必要程序。

  2. 登入 AWS 管理主控台。

  3. 切換到 Amazon Q Developer 主控台。

  4. 從左側導覽窗格選擇自訂。

  5. 自訂頁面將會出現。

  6. 選擇建立自訂。

  7. 輸入自訂名稱和 (選用) 描述。

    注意

    請使用可為開發人員提供資訊的名稱和描述。您組織中經授權使用 Amazon Q Developer 專業方案的開發人員，將能夠在其 IDE 中透過 AWS 外掛程式查看這些項目。

連線至資料來源

建立自訂之前，您必須連線到包含程式碼基底的資料來源。您的做法取決於資料來源的位置。

如果您的資料來源位於 Github、GitLab 或 Bitbucket 中，您可以使用 AWS CodeConnections 與其連線。否則，請將您的資料放在 Amazon S3 儲存貯體內的資料夾中。

若要進一步了解 CodeConnections，請參閱《開發人員工具主控台使用者指南》中的什麼是連線？

若要透過 CodeConnections 連線至您的資料來源

  1. 在連線至來源提供者下，選取 AWS CodeStar CodeConnections。

  2. 如果您要使用現有的連線，請選擇選取連線。

    選取連線下拉式清單。

    然後在選擇儲存庫選項下，執行下列其中一項操作：

    • 若要使用連線中的所有儲存庫來產生自訂，請選擇使用此連線中的所有儲存庫。

    • 若要選取特定儲存庫來產生自訂，請選擇選取特定儲存庫，然後選擇選擇儲存庫。在快顯視窗中，尋找您要使用的儲存庫，然後選擇新增。

      注意

      雖然自訂中可包含的儲存庫數量並無限制，但您個別選取儲存庫時，則會受限於 100 個儲存庫。如果您想要使用超過 100 個儲存庫，請選擇使用所有儲存庫選項，或將儲存庫放到 Amazon S3 中，並依照指示透過 Amazon S3 連線資料來源。

  3. 如果您想要建立新連線，請選擇建立新連線，然後依照此程序的其餘步驟執行。

  4. 在開啟的快顯視窗中，瀏覽至您的資料來源，並依照主控台中的指示執行。

  5. 建立資料來源之後，請返回建立自訂頁面。

  6. 在選取連線下，從下拉式清單中選取您的連線。

若要透過 Amazon S3 連線至您的資料來源

  1. 在連線至來源提供者下，選取 Amazon S3。

    Amazon S3 儲存貯體選項按鈕。

  2. 選擇瀏覽 Amazon S3。

  3. 瀏覽至您的程式碼基底並記下 URI。程式碼基底必須位於 Amazon S3 儲存貯體內的資料夾中，而非儲存貯體的根目錄。

    如需詳細資訊，請參閱《Amazon S3 使用者指南》中的建立、設定和使用 Amazon S3 儲存貯體和存取控制最佳實務。

  4. 將 URL 貼入標示為輸入 Amazon S3 URI 的欄位中。

在建立自訂之前，您可以選擇新增標籤。

若要進一步了解標籤，請參閱《標記您的 AWS 資源使用者指南》。

依照上述程序執行後，選擇建立自訂。

自訂和您的資料

Amazon Q 自訂會使用您的內容，以組織開發人員的形式對您顯示建議。

不過，AWS 不會在未直接為您的企業提供服務的任何環境中儲存或使用您的內容。

AWS 不會使用您的內容向其他客戶提供程式碼建議。

Amazon Q 不會參考其他客戶 (或您) 的程式碼檢閱。

如需詳細資訊，請參閱 Amazon Q Developer 服務改善。

建立自訂功能故障診斷

  • 您可能會收到錯誤：Total size of the provided repositories exceeds the maximum allowed size of number for a customization.

    在這種情況下，請從資料來源中移除儲存庫，然後再試一次。

  • 您可能會收到錯誤：Insufficient data to create a customization. Add more files from supported languages and retry.

    為了讓使用特定語言編寫的程式碼能夠用來建立自訂，在您的資料來源中至少須有 10 個檔案包含使用該語言的程式碼。您的資料來源至少須包含 2 MB (雖然建議包含接近 20 MB，且最多為 20 GB) 來自支援語言的原始程式碼檔案。

    某些檔案即使是使用相關語言，仍不計入 2 MB 中。例如，重複的檔案和使用不支援格式的檔案都不會計入。

    如果您收到此錯誤，請新增更多包含自訂重點程式設計語言的檔案，然後再試一次。

  • 您可能會收到錯誤：Encountered an issue when retrieving some of the selected repositories from CodeConnections. Check the customization's log deliveries for details.

    如果您收到此錯誤，請嘗試使用連線可存取的有效儲存庫，再次建立或更新自訂。