本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用 Amazon Q Developer 產生內嵌建議 Amazon Q 可即時為您提供程式碼建議。當您撰寫程式碼時，Amazon Q 會根據您現有的程式碼和註解自動產生建議。個人化建議的大小和範圍因情況而異，從單行註解到完整函式都有可能。 當您開始輸入單行程式碼或註解時，Amazon Q 會根據您目前和之前的輸入內容提供建議。檔案名稱也會納入考量。 當您下載 Amazon Q 延伸模組時，內嵌建議會自動啟用。若要開始使用，只要您開始編寫程式碼，Amazon Q 就會開始產生程式碼建議。 您也可以自訂 Amazon Q 針對軟體開發團隊的內部程式庫、專屬演算法技術和企業程式碼樣式所產生的建議。 **Topics** + [暫停使用 Amazon Q 提供建議](#toggling-suggestions) + [Amazon Q 程式碼完成的實際情形](#what-is-walkthrough) + [在 AWS 編碼環境中產生內嵌建議](setting-up-AWS-coding-env.md) + [使用快速鍵](actions-and-shortcuts.md) + [使用程式碼參考](code-reference.md) + [程式碼範例](inline-suggestions-code-examples.md) ## 暫停使用 Amazon Q 提供建議 選擇您的 IDE，以查看在 Amazon Q 中暫停和繼續內嵌程式碼建議的步驟。 ------ #### [ Visual Studio 程式碼 ] 1. 在 VS Code 中，從 IDE 視窗底部的元件匣中選擇 **Amazon Q**。 Amazon Q 任務列會在 IDE 視窗頂端開啟。 1. 選擇**暫停自動建議**或**繼續自動建議**。 下圖顯示 VS Code 中的 Amazon Q 任務列。 ![\[VS Code 中的 Amazon Q 任務列。\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/VSC-taskbar.png) ------ #### [ JetBrains ] 1. 在 JetBrains IDE 中，從 IDE 視窗底部的狀態列中選擇 **Amazon Q**。 Amazon Q 任務列會在狀態列上方開啟。 1. 選擇**暫停自動建議**或**繼續自動建議**。 下圖顯示 JetBrains IDE 中的 Amazon Q 任務列。 ![\[JetBrains IDE 中的 Amazon Q 任務列。\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/JB-taskbar.png) ------ #### [ Eclipse ] 1. 在 Eclipse IDE 中，於 IDE 右上角選擇 **Amazon Q** 圖示。 1. 在 Amazon Q 聊天索引標籤開啟的情況下，選擇索引標籤右上角的省略符號圖示。Amazon Q 任務列隨即開啟。 下圖顯示 Eclipse IDE 中的 Amazon Q 任務列。 ![\[Eclipse IDE 中的 Amazon Q 任務列。\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/eclipse-taskbar.png) 1. 選擇**暫停自動建議**或**繼續自動建議**。 ------ #### [ Visual Studio ] 1. 從視窗的邊緣選擇 Amazon Q 圖示。 1. 選取**暫停自動建議**或**繼續自動建議**。 下圖顯示 Visual Studio 中的 Amazon Q 任務列。 ![\[Visual Studio 中的「開發人員工具」功能表。\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/vstudio-toggle-suggestions.png) ------ #### [ AWS Cloud9 ] Amazon Q 不支援在 AWS Cloud9中將建議切換為開啟和關閉。 若要停止接收 Amazon Q 建議 AWS Cloud9， AWS Cloud9 請從您用來存取的角色或使用者中移除授予 Amazon Q 存取權的 IAM 政策 AWS Cloud9。 ------ #### [ AWS Lambda ] 若要在 Lambda 中停用或重新啟用 Amazon Q 程式碼建議： 1. 在 Lambda 主控台中，開啟特定 Lambda 函式的畫面。 1. 在**程式碼來源**區段中，從工具列選擇**工具**。 1. 從下拉式功能表中，選擇 **Amazon Q 程式碼建議**。 ------ #### [ Amazon SageMaker AI Studio ] 1. 在 SageMaker AI Studio 主控台中，從視窗底部選擇 Amazon Q。 Amazon Q 面板將會開啟。 1. 選擇**暫停自動建議**或**繼續自動建議**。 ------ #### [ JupyterLab ] 1. 在 JupyterLab 主控台中，從視窗底部選擇 Amazon Q。 Amazon Q 面板將會開啟。 1. 選擇**暫停自動建議**或**繼續自動建議**。 ------ #### [ AWS Glue Studio Notebook ] 1. 在 AWS Glue Studio Notebook 主控台中，從視窗底部選擇 Amazon Q。 Amazon Q 面板將會開啟。 1. 選擇**暫停自動建議**或**繼續自動建議**。 ------ ## Amazon Q 程式碼完成的實際情形 本節示範 Amazon Q 如何協助您編寫完整的應用程式。此應用程式會建立 Amazon S3 儲存貯體和 Amazon DynamoDB 資料表，以及驗證這兩個任務的單元測試。 在這裡，Amazon Q 可協助開發人員選擇要匯入的程式庫。開發人員使用方向鍵即可切換查看多個建議。 ![\[區塊自動完成功能範例。\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/whatis-demo-1.gif) 在這裡，開發人員輸入註解，說明想要編寫的下一行程式碼。 Amazon Q 正確預測要呼叫的方法。開發人員可以使用 Tab 鍵接受建議。 ![\[alt_text\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/whatis-demo-2.png) 在這裡，開發人員準備定義常數。 Amazon Q 正確預期第一個常數將是 `REGION`，其值將是 `us-east-1`，這是預設值。 ![\[alt_text\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/whatis-demo-3.png) 在這裡，開發人員準備編寫程式碼，此程式碼將在使用者與 Amazon S3 和 DynamoDB 之間開啟工作階段。 Amazon Q 熟悉 AWS APIs和 SDKs，建議正確的格式。 ![\[alt_text\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/whatis-demo-4.1.png) 開發人員只撰寫了將建立儲存貯體的函式名稱。但根據該名稱 (及內容)，Amazon Q 就能提供完整的函式，並搭配 try/except 子句來完成。 請注意使用 `TEST_BUCKET_NAME, which is a constant declared earlier in the same file.` 的情形 ![\[alt_text\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/whatis-demo-5.png) 開發人員才剛開始輸入將建立 DynamoDB 資料表的函式名稱。Amazon Q 就能知道後續內容。 請注意稍早為 DynamoDB 工作階段建立的建議帳戶，甚至在註解中也有提及此帳戶。 ![\[alt_text\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/whatis-demo-6.png) 當 Amazon Q 提議完成單元測試類別時，開發人員執行的只有撰寫單元測試類別的名稱和少數工作。 請注意稍早在相同檔案中建立的兩個函式的內建參考。 開發人員才剛開始輸入將建立 DynamoDB 資料表的函式名稱。Amazon Q 就能知道後續內容。 請注意稍早為 DynamoDB 工作階段建立的建議帳戶，甚至在註解中也有提及此帳戶。 ![\[alt_text\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/whatis-demo-7.png) Amazon Q 僅根據註解和內容，就能提供整個主要函式。 ![\[alt_text\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/whatis-demo-8.1.png) 剩下的就只有主要防護機制，Amazon Q 知道怎麼做。 Amazon Q 僅根據註解和內容，就能提供整個主要函式。 ![\[alt_text\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/whatis-demo-9.png) 最後，開發人員會從編碼所在的相同 IDE 的終端執行單元測試。 ![\[alt_text\]](http://docs.aws.amazon.com/zh_tw/amazonq/latest/qdeveloper-ug/images/whatis-demo-10.png)