本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
在 CodeCatalyst 中建立問題
開發團隊會建立問題,以協助追蹤和管理其工作。您可以根據您的需求在專案中建立問題。例如,您可以建立問題來追蹤更新程式碼中的變數。您可以指派問題給專案中的其他使用者、使用標籤來協助您追蹤工作等。
請依照這些指示在 CodeCatalyst 中建立問題。
建立問題
開啟 CodeCatalyst 主控台,網址為 https://https://codecatalyst.aws/
。 -
導覽至您要建立問題的專案。
-
在專案首頁上,選擇建立問題。或者,在導覽窗格中,選擇問題。
-
選擇建立問題。
注意
您也可以在使用網格檢視時內嵌新增問題。
-
輸入問題的標題。
-
(選用) 輸入描述。您可以使用 Markdown 新增格式。
-
(選用) 選擇問題的狀態、優先順序和估算。
注意
如果專案的估算設定設為隱藏估算,則不會有估算欄位。
-
(選用) 將任務新增至問題。任務可用來將問題的工作分解為較小的目標。若要新增任務,請選擇 + 新增任務。然後,在文字欄位中輸入任務名稱,然後按 Enter 鍵。新增任務之後,您可以選擇核取方塊,將它們標記為完成,或從核取方塊左側選擇並拖曳任務來重新排序它們。
-
(選用) 新增現有的標籤或建立新的標籤,然後選擇 + 新增標籤來新增標籤。
-
若要新增現有標籤,請從清單中選擇標籤。您可以在欄位中輸入搜尋字詞,以搜尋專案中包含該字詞的所有標籤。
-
若要建立新的標籤並新增標籤,請在搜尋欄位中輸入您要建立的標籤名稱,然後按 Enter 鍵。
-
-
(選用) 透過選擇 + 新增受指派者來新增受指派者。您可以透過選擇 + 新增我,快速將自己新增為受指派者。
提示
您可以選擇將問題指派給 Amazon Q,讓 Amazon Q 嘗試解決問題。如需詳細資訊,請參閱教學課程:使用 CodeCatalyst 生成式 AI 功能加速開發工作。此功能僅適用於美國西部 (奧勒岡) 區域。
此功能需要為空間啟用生成式 AI 功能。如需詳細資訊,請參閱管理生成式 AI 功能。
-
(選用) 新增現有的自訂欄位或建立新的自訂欄位。問題可以有多個自訂欄位。
-
若要新增現有的自訂欄位,請從清單中選擇自訂欄位。您可以在欄位中輸入搜尋詞彙,以搜尋專案中包含該詞彙的所有自訂欄位。
-
若要建立新的自訂欄位並加以新增,請在搜尋欄位中輸入您要建立的自訂欄位名稱,然後按 Enter 鍵。然後選擇您要建立的自訂欄位類型,並設定值。
-
-
選擇建立問題。右下角會顯示通知:如果問題已成功建立,則會出現確認訊息,指出問題已成功建立。如果未成功建立問題,則會顯示錯誤訊息,其中包含失敗原因。然後,您可以選擇重試來編輯和重試建立問題,或選擇捨棄來捨棄問題。這兩個選項都會關閉通知。
注意
您無法在建立提取請求時將其連結至問題。不過,您可以在建立之後對其進行編輯,以新增提取請求的連結。
建立和處理指派給 Amazon Q 的問題時的最佳實務
當您建立問題時,有時有些會停留。原因可能複雜且可變。有時候,這是因為不清楚誰應該處理它。其他時候,該問題需要對程式碼庫特定部分的研究或專業知識,而工作的最佳候選者正忙於處理其他問題。通常需要先處理其他緊急工作。任何或所有這些原因都可能導致未處理的問題。CodeCatalyst 包含與名為 Amazon Q 的生成式 AI 助理整合,可根據其標題及其描述來分析問題。如果您將問題指派給 Amazon Q,它會嘗試建立草稿解決方案供您評估。這可協助您和您的團隊專注於和最佳化需要您注意的問題,而 Amazon Q 則致力於解決您沒有資源可立即解決的問題。
注意
注意
採用 Amazon Bedrock: AWS 實作自動濫用偵測。由於 Amazon Q 開發人員代理程式的軟體開發功能建置在 Amazon Bedrock 上,因此為我建立內容摘要、建議任務、使用 Amazon Q 來建立或新增功能,以及將問題指派給 Amazon Q 功能,因此使用者可以充分利用在 Amazon Bedrock 中實作的控制項,以強制執行安全、安全以及負責任地使用人工智慧 (AI)。
Amazon Q 在簡單問題和直接問題上表現最佳。為了獲得最佳結果,請使用純語言來清楚說明您想要完成的動作。以下是一些最佳實務,可協助您建立針對 Amazon Q 進行最佳化處理的問題。
重要
生成式 AI 功能僅適用於美國西部 (奧勒岡) 區域。
-
保持簡單。Amazon Q 最適合進行簡單的程式碼變更和修正,可在問題標題和描述中加以說明。請勿指派模糊標題或過於花拽或矛盾描述的問題。
-
請具體說明。您可以提供有關解決問題所需的確切變更的資訊越多,Amazon Q 就越可能建立解決方案來解決問題。如果可能,請包含特定詳細資訊,例如您想要變更的 APIs 名稱、想要更新的方法、需要變更的測試,以及任何其他您可以想得到的詳細資訊。
-
請確定您已在問題標題和描述中包含所有詳細資訊,再將其指派給 Amazon Q。 您無法在將問題指派給 Amazon Q 之後變更問題的標題或描述,因此在將問題指派給 Amazon Q 之前,請務必先擁有問題中所需的所有資訊。
-
僅指派需要變更單一來源儲存庫中程式碼的問題。Amazon Q 只能在 CodeCatalyst 的單一來源儲存庫中處理程式碼。不支援連結的儲存庫。確定問題只需要在單一來源儲存庫中進行變更,再將問題指派給 Amazon Q。
-
使用 Amazon Q 建議的預設值來核准每個步驟。根據預設,Amazon Q 將需要您核准其採取的每個步驟。這可讓您在註解中與 Amazon Q 互動,不僅針對問題,也針對其建立的任何提取請求進行互動。這可提供更互動式的 Amazon Q 體驗,協助您調整其方法,並改善其建立的程式碼來解決問題。
注意
Amazon Q 不會回應問題或提取請求中的個別評論,但會在要求重新考慮其方法或建立修訂時檢閱它們。
-
請務必仔細檢閱 Amazon Q 建議的方法。 一旦您核准其方法,Amazon Q 將開始根據該方法產生程式碼。請確定方法似乎正確,並包含您預期的所有詳細資訊,再告知 Amazon Q 繼續。
-
請確定只有在您沒有可能部署工作流程的現有工作流程時,才允許 Amazon Q 處理工作流程。您的專案可能已設定工作流程,以開始在提取請求事件上執行。如果是這樣,Amazon Q 建立的任何提取請求,包括建立或更新工作流程 YAML 可能會開始執行提取請求中包含的工作流程。最佳實務是,除非您確定專案中沒有工作流程會自動執行這些工作流程,否則請勿選擇允許 Amazon Q 處理工作流程檔案,然後再檢閱並核准其建立的提取請求。
如需詳細資訊,請參閱 教學課程:使用 CodeCatalyst 生成式 AI 功能加速開發工作和管理生成式 AI 功能。 https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html