Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

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

# 在 CodeCatalyst 中建立問題
<a name="issues-create-issue"></a>

開發團隊會建立問題，以協助追蹤和管理其工作。您可以根據您的需求在專案中建立問題。例如，您可以建立一個問題來追蹤更新程式碼中的變數。您可以指派問題給專案中的其他使用者、使用標籤來協助您追蹤工作等等。

請依照這些指示在 CodeCatalyst 中建立問題。

**建立問題**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 導覽至您要建立問題的專案。

1. 在專案首頁上，選擇**建立問題**。或者，在導覽窗格中，選擇**問題**。

1. 選擇**建立問題**。
**注意**  
您也可以在使用網格檢視時內嵌新增問題。

1. 輸入問題的標題。

1. （選用） 輸入**描述**。您可以使用 Markdown 新增格式設定。

1. （選用） 選擇問題**的狀態**、**優先順序**和**估算**。
**注意**  
如果專案的預估設定設為**隱藏預估**值，則不會有**預估**欄位。

1. （選用） 將任務新增至問題。任務可用來將問題的工作細分為較小的目標。若要新增任務，請選擇 **\$1 新增任務**。然後，在文字欄位中輸入任務名稱，然後按 Enter 鍵。新增任務後，您可以選擇核取方塊將其標記為完成，或從核取方塊左側選擇並拖曳任務來重新排序。

1. （選用） 新增現有標籤或建立新標籤，然後選擇 **\$1 新增標籤來新增**標籤。

   1. 若要新增現有的標籤，請從清單中選擇標籤。您可以在欄位中輸入搜尋詞彙，在專案中搜尋包含該詞彙的所有標籤。

   1. 若要建立新的標籤並新增標籤，請在搜尋欄位中輸入您要建立的標籤名稱，然後按 Enter 鍵。

1. （選用） 透過選擇 **\$1 新增指派者來新增指派者**。您可以選擇 **\$1 新增我**，以快速將自己新增為被指派者。
**提示**  
您可以選擇將問題指派給 **Amazon Q**，讓 Amazon Q 嘗試解決問題。如需詳細資訊，請參閱[教學課程：使用 CodeCatalyst 生成式 AI 功能來加速開發工作](getting-started-project-assistance.md)。此功能僅適用於美國西部 （奧勒岡） 區域。  
此功能需要為空間啟用生成式 AI 功能。如需詳細資訊，請參閱[管理生成式 AI 功能](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)。

1. （選用） 新增現有的**自訂欄位**或建立新的自訂欄位。問題可以有多個自訂欄位。

   1. 若要新增現有的自訂欄位，請從清單中選擇自訂欄位。您可以在欄位中輸入搜尋詞彙，以搜尋專案中包含該詞彙的所有自訂欄位。

   1. 若要建立新的自訂欄位並新增它，請在搜尋欄位中輸入您要建立的自訂欄位名稱，然後按 Enter 鍵。然後選擇您要建立的自訂欄位類型，並設定值。

1. 選擇**建立問題**。通知會顯示在右下角：如果問題已成功建立，則會出現確認訊息，指出問題已成功建立。如果未成功建立問題，則會顯示錯誤訊息，其中包含失敗原因。然後，您可以選擇**重試**以編輯和重試建立問題，或選擇**捨棄**以捨棄問題。這兩個選項都會關閉通知。
**注意**  
您無法在建立提取請求時將其連結至問題。不過，您可以在建立之後[對其進行編輯](issues-edit-issue.md)，以新增提取請求的連結。

## 建立和處理指派給 Amazon Q 的問題時的最佳實務
<a name="issues-create-issue-assign-genai-best-practices"></a>

當您建立問題時，有時有些會停留。原因可能複雜且可變。有時是因為尚不清楚誰應該處理它。其他時候，問題需要對程式碼庫特定部分的研究或專業知識，而工作的最佳候選者正忙於處理其他問題。通常，必須首先處理其他緊急工作。任何或所有這些原因都可能導致無法處理的問題。CodeCatalyst 包含與名為 Amazon Q 的生成式 AI 助理整合，可根據其標題及其描述來分析問題。如果您將問題指派給 Amazon Q，它會嘗試建立草稿解決方案供您評估。這可協助您和您的團隊專注於和最佳化需要您注意的問題，而 Amazon Q 可為您沒有資源可立即解決的問題提供解決方案。

**注意**  
**採用 Amazon Bedrock 技術**： AWS 實作[自動濫用偵測](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html)。由於**為我撰寫說明**、**建立內容摘要**、**建議的任務**、**使用 Amazon Q 建立或新增功能至專案**，以及**將問題指派給 Amazon Q** 功能，搭配適用於軟體開發的 Amazon Q Developer 代理程式功能建置在 Amazon Bedrock 上，因此使用者可以充分利用 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 功能來加速開發工作](getting-started-project-assistance.md)[和管理生成式 AI 功能](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)。