本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
管理自訂代理程式
本節涵蓋如何在開發工作流程中有效組織、管理和使用自訂代理程式。
自訂代理程式檔案位置
自訂代理程式組態檔案會儲存為特定目錄中的 JSON 檔案：
- 全域自訂代理程式
-
~/.aws/amazonq/cli-agents/{agent-name}.json適用於您系統上的所有專案和目錄。
- 專案層級自訂代理程式
-
.amazonq/cli-agents/{agent-name}.json僅在特定專案目錄及其子目錄中可用。
重要：檔案名稱{agent-name}中的 僅供您參考。實際代理程式名稱取決於 JSON 組態檔案本身內的 name 欄位，這是必要的。
自訂代理程式優先順序和衝突解決
當 Amazon Q Developer CLI 尋找自訂代理程式時，它會遵循特定的優先順序：
-
本機自訂客服人員優先 - 檢查目前工作目錄中的自訂客服人員
-
全球自訂代理程式第二個 - 回到主目錄中的自訂代理程式
-
內建預設值 - 如果找不到自訂自訂代理程式，則使用預設代理程式
如果本機和全域目錄都包含同名的自訂代理程式，則以本機自訂代理程式為優先。發生這種情況時，Amazon Q Developer CLI 會顯示警告訊息：
WARNING: Agent conflict for my-agent. Using workspace version.
此優先順序系統可讓您：
-
使用專案特定版本覆寫全域自訂代理程式
-
在進行全域修改之前，先在本機測試自訂代理程式
-
維護不同專案的不同自訂代理程式組態
組織自訂客服人員的最佳實務
何時使用全域自訂代理程式
將全域自訂代理程式用於：
-
一般用途工作流程 - 跨多個專案使用的自訂代理程式
-
個人生產力 - 根據您的個別工作風格量身打造的自訂客服人員
-
常見開發任務 - 程式碼檢閱、偵錯、產生文件
-
工具特定的工作流程 - AWS 管理、Git 操作、Docker 工作流程
何時使用本機自訂代理程式
將本機自訂代理程式用於：
-
專案特定組態 - 需要存取特定專案檔案的自訂代理程式
-
團隊協作 - 透過版本控制共用的自訂代理程式
-
開發環境 - 具有特定專案獨特需求的自訂代理程式
-
測試和實驗 - 暫時修改自訂代理程式，而不會影響全域設定
自訂代理程式命名慣例
請考慮這些命名慣例，以獲得更好的自訂代理程式組織：
-
以目的為基礎的名稱 -
aws-specialist.json、code-reviewer.json、documentation-writer.json -
技術特定名稱 -
python-dev.json、react-frontend.json、terraform-ops.json -
專案特定名稱 -
project-alpha.json、mobile-app.json、api-backend.json -
環境特定名稱 -
development.json、staging.json、production.json
與團隊共用自訂代理程式
本機自訂代理程式可以透過版本控制系統與團隊成員共用。這種方法可讓團隊：
-
標準化開發環境 - 確保所有團隊成員都能存取相同的工具和組態
-
共用專案特定內容 - 包含專案文件、編碼標準和自訂指令碼
-
保持一致性 - 在整個團隊中使用相同的工具許可和設定
-
協作改善 - 使用提取請求來檢閱和改善自訂代理程式組態
版本控制最佳實務
透過版本控制共用自訂代理程式時：
-
包含自訂代理程式目錄 -
.aws/amazonq/agents/新增至您的儲存庫 -
文件自訂代理程式用途 - 在自訂代理程式組態檔案中使用明確描述
-
檢閱自訂代理程式變更 - 處理自訂代理程式組態變更，例如程式碼變更
-
測試自訂客服人員組態 - 確認共用的自訂客服人員適用於所有團隊成員
-
避免敏感資訊 - 請勿在共用自訂代理程式中包含 API 金鑰、密碼或個人資訊
