本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用 Amazon Q Developer 開發功能
Amazon Q Developer 可協助您開發程式碼功能,或對整合開發環境 (IDE) 中的專案進行程式碼變更。您會說明要完成的任務,而 Amazon Q 會使用目前專案或工作區的內容來產生程式碼來實作變更。Amazon Q 可協助您建置 AWS 專案或自己的應用程式。
您可以開始一個全新的專案,或在 IDE 中處理未結的專案。當您在現有專案中開發 時,Amazon Q 會使用工作區根目錄中的所有相關檔案作為內容來產生程式碼。Amazon Q 會篩選掉 檔案中定義的.gitignore
檔案或資料夾,並且只會使用支援的檔案類型來產生程式碼。如需支援的檔案類型清單,請參閱下列 IDE 的 GitHub 連結:
-
IDEs JetBrains 支援的檔案類型 – https://github.com/aws/aws-toolkit-jetbrains/blob/main/plugins/core/jetbrains-community/src/software/aws/toolkits/jetbrains/services/telemetry/TelemetryUtils.kt
-
支援的檔案類型 Visual Studio Code – https://github.com/aws/aws-toolkit-vscode/blob/master/packages/core/src/shared/filetypes.ts
若要開始使用,請開啟新的或現有的專案,然後在 Amazon Q 聊天面板/dev
中輸入 。新的聊天索引標籤會開啟,您可以在其中與 Amazon Q 互動,為您的功能產生新的程式碼。
使用 開發功能 /dev
若要在 IDE 中使用 Amazon Q 處理程式碼任務,請完成下列步驟。
-
在 IDE 中,開啟新的或現有的專案或工作區,以便開發功能。
-
選擇 Amazon Q 圖示以開啟 Amazon Q 聊天面板。
-
在 Amazon Q 聊天面板
/dev
中輸入 ,後面接著您要完成的任務描述,或是您要解決的問題。您可以提供任務的簡要概觀,或新增更多詳細資訊。Amazon Q 使用您的描述和專案中的程式碼來產生程式碼。以下是您可以要求 Amazon Q 實作的程式碼變更範例:
/dev Create a new REST API endpoint /api/authenticate to handle user authentication. This endpoint should accept POST requests with user credentials and return a JWT token upon successful authentication. Additionally, update the user management system to integrate with the new authentication endpoint and enforce authentication for relevant API endpoints.
您也可以
/dev
只輸入 來查看範例任務。 -
新的標籤將開啟。如果您尚未輸入任務或問題的描述。
-
Amazon Q 開始為您所描述的任務產生程式碼。在程式碼產生期間,Amazon Q 提供其採取的步驟摘要,以及其使用或更新以建議新程式碼的檔案摘要。此步驟可能需要幾分鐘的時間。
如果您希望 Amazon Q 停止產生程式碼,請選擇停止。未完成的程式碼產生會計入此任務的程式碼產生配額。停止產生後,您可以選擇輸入另一個任務描述,以繼續處理任務。
或者,Amazon Q 可以在單獨的開發環境中測試其程式碼建議,然後在聊天視窗中向您展示。如需詳細資訊,請參閱測試 '/dev' 建議。
-
在 Amazon Q 為您的任務產生程式碼後,它會提供包含建議變更的檔案清單。選擇檔案以檢視具有變更的檔案差異。
-
若要使用所有建議的程式碼變更更新您的檔案,請選擇接受所有變更。您也可以接受和拒絕個別檔案的變更。若要接受個別檔案變更,請將游標停留在檔案名稱上,然後選擇綠色核取記號。若要拒絕變更,請選擇紅色 X。您也可以選擇接受剩餘的變更,以套用您尚未接受的任何變更。
接受程式碼變更後,就無法復原。如果您拒絕程式碼變更,您可以將滑鼠游標移至檔案名稱並選擇箭頭來還原程式碼。然後,您可以選擇再次接受或拒絕程式碼變更。
-
如果您對提議的變更不滿意,您可以提供可改善項目的意見回饋。選擇提供意見回饋並重新產生,然後描述您希望 Amazon Q 進行的變更。
Amazon Q 會根據您的意見回饋產生新的程式碼。當產生的程式碼符合您的需求時,請選擇接受所有變更或接受個別檔案,以更新專案或工作區中的程式碼。
-
在您更新程式碼之後,Amazon Q 會提示您開始處理新的任務。
若要開始處理專案或工作區中的另一個任務,請選擇是,我有另一個任務。您先前的對話和產生的程式碼不會用作新任務的內容。
若要結束功能開發工作階段,請選擇否,謝謝。若要繼續使用 Amazon Q 聊天或啟動另一個工作流程,請開啟新的聊天索引標籤。
最佳實務
若要充分利用 Amazon Q 的功能開發,請遵循下列最佳實務:
-
提供您想要進行的新功能或程式碼變更的詳細說明,包括程式碼應達成的具體目標。這可讓 Amazon Q 提出全面且可實作的程式碼變更。如需範例,請參閱 範例任務。
-
您的功能一次不應要求更新超過 5 個檔案。要求 Amazon Q 進行較大的變更可能會影響功能實作的品質和管理性。如果您的檔案差異包含對許多檔案的變更,請嘗試減少功能描述的範圍。
範例任務
以下是您可以要求 Amazon Q 執行的特徵開發任務範例,以及您可能提供的對應描述。
-
更新回應式配置的 CSS 樣式:透過更新 CSS 樣式來增強應用程式的配置回應能力。專注於調整不同螢幕大小的配置,確保各種裝置間的最佳顯示。
-
修正使用者設定檔映像上傳:解決讓使用者無法上傳設定檔映像的問題。調查檔案上傳程序、確保適當的檔案類型驗證,並解決任何伺服器端錯誤,以防止上傳成功。
-
程式碼可讀性重構程式碼:重構特定程式碼模組的可讀性,以改善該程式碼模組的可讀性。將複雜的函數分解為更小、更易於管理的單位,並套用有意義的變數和函數名稱,以更清楚。
-
實作聯絡表單的輸入驗證:將用戶端和伺服器端輸入驗證新增至聯絡表單,以防止提交空白或無效的資料。針對任何驗證失敗,向使用者顯示適當的錯誤訊息。
-
解決導覽功能表中的中斷連結:調查並修正應用程式導覽功能表中中斷的連結。更新 URLs或路由,以確保所有導覽連結導向正確的頁面。
-
最佳化映像載入以加快頁面載入速度:最佳化應用程式金鑰頁面上的映像載入,以減少頁面載入時間。實作延遲載入或非同步載入技術,以排定顯示可見內容的優先順序。
-
新增關鍵 API 端點的錯誤記錄:透過實作關鍵 API 端點的記錄來增強錯誤處理。記錄相關的錯誤詳細資訊,例如請求參數和堆疊追蹤,以方便偵錯和故障診斷。
-
更新 API 端點的文件:檢閱和更新現有 API 端點的文件,以反映最近的變更或新增。確保使用 API 的開發人員資訊的準確性和完整性。
-
為效率重構資料庫查詢:分析和最佳化資料庫查詢,以提高效率並減少資源消耗。識別和消除備援查詢、最佳化索引,並在適用時考慮快取策略。
配額
使用 Amazon Q 進行特徵開發可維持下列配額:
-
每個任務的程式碼產生 – 您可以提供意見回饋以為指定的開發任務重新產生程式碼的次數,包括初始程式碼產生。每次啟動新任務時都會重設此配額。
-
程式碼專案大小 – Amazon Q 可用來產生新程式碼的程式碼檔案或資料夾大小上限。
資源 | 配額 |
---|---|
每個任務的程式碼產生 | 10 |
程式碼專案大小 | 200 MB 未壓縮 50 MB 壓縮 |