在 中建立問題 CodeCatalyst - Amazon CodeCatalyst

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

在 中建立問題 CodeCatalyst

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

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

建立問題
  1. 在 https://https://codecatalyst.aws/ 開啟 CodeCatalyst 主控台。

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

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

  4. 選擇建立問題

    注意

    您也可以在使用網格檢視時內嵌新增問題。

  5. 輸入問題的標題。

  6. (選用) 輸入描述 。您可以使用 Markdown 新增格式。

  7. (選用) 為問題選擇狀態 優先順序 估算

    注意

    如果專案的估算設定設定為隱藏估算,則不會有估算欄位。

  8. (選用) 將任務新增至問題。任務可用來將問題的工作分解為較小的目標。若要新增任務,請選擇 + 新增任務 。然後,在文字欄位中輸入任務名稱,然後按 Enter。新增任務後,您可以選擇核取方塊,或選擇並拖曳核取方塊左側的任務,將其標記為完成。

  9. (選用) 新增現有標籤或建立新標籤,然後選擇 + 新增標籤 來新增標籤。

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

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

  10. (選用) 透過選擇 + 新增受指派者 來新增受指派者。您可以透過選擇 + 新增我 ,快速將自己新增為受指派者。

    提示

    您可以選擇將問題指派給 Amazon Q,讓 Amazon Q 嘗試解決問題。如需詳細資訊,請參閱教學課程:使用 CodeCatalyst 生成式 AI 功能加速開發工作。此功能僅適用於美國西部 (奧勒岡) 區域。

    此功能需要為空間啟用生成 AI 功能。如需詳細資訊,請參閱管理生成 AI 功能

  11. (選用) 新增現有的自訂欄位或建立新的自訂欄位。問題可以有多個自訂欄位。

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

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

  12. 選擇建立問題 。右下角會顯示通知:如果問題已成功建立,則會顯示確認訊息,指出問題已成功建立。如果未成功建立問題,則會顯示錯誤訊息,其中包含失敗原因。然後,您可以選擇重試以編輯和重試建立問題,或選擇捨棄以捨棄問題。這兩個選項都會關閉通知。

    注意

    建立提取請求時,您無法將其連結至問題。不過,您可以在建立後對其進行編輯,以新增提取請求的連結。

建立和處理指派給 Amazon Q 的問題時的最佳實務

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

注意
注意

由 Amazon Bedrock 提供技術支援: AWS 實作自動濫用偵測。由於 撰寫描述 建立內容摘要 建議任務 使用 Amazon Q 來建立或新增專案功能,以及使用 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