本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
實驗功能
Amazon Q Developer CLI 包含實驗功能，可提供進階功能來提高生產力。這些功能處於主動開發階段，必須明確啟用才能使用。
重要
實驗功能可能隨時變更或移除。您決定在生產工作流程中使用時，須自行負責。
管理實驗功能
使用 /experiment 命令來檢視和切換實驗功能：
/experiment
此時會顯示互動式功能表，您可以在此：
-
檢視每一項實驗的目前狀態 (開/關)
-
選取實驗以進行切換
-
檢視每一項實驗的用途說明
知識管理
知識管理功能可在聊天工作階段之間提供持續的內容儲存和擷取。啟用方式：
q settings chat.enableKnowledge true
基本使用
啟用後，在聊天工作階段內使用 /knowledge 命令：
- /knowledge add <name> <path>
-
將檔案或目錄新增至知識庫
- /knowledge show
-
顯示知識庫中的所有項目
- /knowledge remove <identifier>
-
依名稱、路徑或內容 ID 移除項目
- /knowledge update <path>
-
使用新內容更新現有的知識庫項目
- /knowledge clear
-
移除知識庫中的所有項目 (需要確認)
- /knowledge status
-
檢視背景索引操作的狀態
索引類型
新增內容時，有兩種索引方法可供選擇：
- Fast (--index-type Fast)
-
使用 BM25 進行辭典搜尋。極快速索引和立即關鍵字搜尋。非常適合日誌、組態和大型程式碼基底。
- Best (--index-type Best)
-
使用 AI 嵌入的語意搜尋。理解內容和意義的智慧搜尋。非常適合文件和研究。
使用範例：
/knowledge add "project-docs" /path/to/docs --index-type Best /knowledge add "log-files" /path/to/logs --index-type Fast
代理程式專屬知識庫
每個代理程式都會維護自己的隔離知識庫，確保知識內容的範圍限於您正在使用的特定代理程式。當您切換代理程式時，您的知識命令也會自動使用該代理程式的專屬知識庫。
正切模式
正切模式會建立對話檢查點，讓您探索附屬主題，而不會中斷主要對話流程。啟用方式：
q settings chat.enableTangentMode true
使用正切模式
啟用後，使用 /tangent 或 Ctrl+T 切換正切模式：
-
進入正切模式：建立對話檢查點
/tangent Created a conversation checkpoint (↯). Use ctrl + t or /tangent to restore the conversation later.
-
在正切模式中：您會在提示中看到黃色
↯符號↯ > What is the difference between async and sync functions?
-
退出正切模式：返回主要對話
↯ > /tangent Restored conversation from checkpoint (↯). - Returned to main conversation.
最佳實務
正切模式的用途：
-
提出釐清有關目前主題的問題
-
在決定之前探索替代方法
-
取得 Q Developer CLI 命令或功能的說明
-
測試概念的理解程度
避免對完全不相關的主題或冗長複雜的討論使用正切模式。
檢查點
檢查點可讓工作階段範圍的快照使用 Git CLI 命令追蹤檔案變更。此功能會建立陰影裸機儲存庫，以管理聊天工作階段的檔案狀態。
使用 啟用檢查點：
q settings chat.enableCheckpoint true
功能
-
快照檔案變更為陰影裸機儲存庫
-
列出、展開、差異和還原至任何檢查點
-
還原檢查點時，對話歷史記錄會展開
-
在 git 儲存庫中自動啟用 （暫時性，工作階段結束時清理）
-
手動初始化適用於非 Git 目錄
基本使用
啟用後，在聊天工作階段內使用 /checkpoint 命令：
- /checkpoint init
-
手動啟用檢查點 （如果不在 git 儲存庫中則為必要）
- /檢查點清單 【--limit N】
-
使用檔案統計資料顯示轉向層級檢查點
- /checkpoint expand <tag>
-
在特定回合下顯示工具層級檢查點
- /checkpoint diff <tag1> 【tag2|HEAD】
-
比較檢查點或比較目前狀態
- /檢查點還原 【<tag>】 【--hard】
-
還原至檢查點 （若未指定標籤，則會顯示互動式挑選器）
- /檢查點清除
-
刪除工作階段影子儲存庫
還原選項
預設還原行為：
-
還原追蹤的變更和刪除
-
保留檢查點之後建立的檔案
硬還原 (--hard 旗標）：
-
讓工作區完全符合檢查點狀態
-
刪除檢查點之後建立的追蹤檔案
重要
檢查點會建立臨時 git 儲存庫，這些儲存庫會在工作階段結束時清除。--hard 還原時請小心，因為它會永久刪除檔案。
內容用量百分比
內容使用百分比會在聊天提示中以百分比顯示您目前的內容時段使用量，協助您監控使用多少可用的內容時段。
使用下列項目啟用內容用量百分比：
q settings chat.enableContextUsageIndicator true
功能
-
顯示提示中使用的內容視窗百分比 （例如 "【rust-agent】 6% >")
-
用於快速視覺化參考的顏色編碼指標
-
協助監控長時間對話期間的內容時段耗用
視覺效果指示器
百分比顯示使用顏色編碼來表示用量層級：
- 綠色：低於 50% 的用量
-
具有大量內容空間的正常操作
- 黃色：50-89% 用量
-
中等用量，考慮內容管理
- 紅色：90-100% 用量
-
高用量、內容視窗幾乎已滿
委派代表
委派可讓 啟動和管理非同步任務程序，讓您可以在主要對話的同時與特定客服人員執行 Amazon Q 聊天工作階段。
使用下列項目啟用委派：
q settings chat.enableDelegate true
功能
-
使用自然語言啟動背景任務
-
與特定客服人員執行平行 Amazon Q 聊天工作階段
-
獨立監控任務進度
-
安全任務執行的客服人員核准流程
用途
使用自然語言要求模型啟動背景任務：
Can you create a background task to analyze the performance of our API endpoints?
任務準備就緒後，請檢查結果：
Check the status of my API analysis task Show me the results from the background analysis
客服人員核准流程
具有客服人員的任務：執行前需要明確核准並顯示客服人員詳細資訊
沒有代理程式的任務：執行 ，並警告所有信任許可
委派後，任務會獨立運作，您可以：
-
隨時檢查進度
-
完成時讀取結果
-
不再需要時刪除任務
重要
委派任務以更高的許可執行。在核准任務執行之前，請仔細檢閱客服人員詳細資訊。
TODO 清單
TODO 清單可讓 Amazon Q 自動建立和修改任務清單，同時為您提供檢視和管理現有 TODO 清單的命令。
使用下列項目啟用 TODO 清單：
q settings chat.enableTodoList true
功能
-
Amazon Q 會在適當時或收到要求時自動建立 TODO 清單
-
使用
/todos命令檢視、管理和刪除 TODOs -
繼續存放在 中的現有 TODO 清單
.amazonq/cli-todo-lists -
跨聊天工作階段的持久性儲存
基本使用
啟用後，Amazon Q 會在對話期間自動建立 TODO 清單。使用 /todos 命令來管理它們：
- /todos 清除完成
-
在工作目錄中刪除已完成TODOs
- /todos 恢復
-
選取並繼續現有的 TODO 清單
- /todos 檢視
-
選取並檢視現有的 TODO 清單
- /todos 刪除
-
選取並刪除現有的 TODO 清單
工作流程整合
Amazon Q 會在以下情況建立 TODO 清單：
-
您要求任務明細
-
討論複雜的多步驟程序
-
專案規劃對話發生
-
您明確請求 TODO 清單
TODO 清單會自動儲存到 ，.amazonq/cli-todo-lists並在聊天工作階段之間保留，讓您可以繼續處理長期專案。
增強型思維模式
思考模式透過step-by-step思考程序啟用複雜的推理，提供 Amazon Q 決策程序的透明度。
使用 啟用思維模式：
q settings chat.enableThinking true
功能
-
顯示複雜問題的 AI 推理程序
-
多Step-by-step推理的逐步思考程序
-
協助了解如何得出結論
-
適用於偵錯和學習
-
複雜任務的透明決策
使用情況
思維模式對以下方面特別有用：
-
複雜的問題解決：了解解決方案背後的推理
-
除錯協助：查看故障診斷的分析程序
-
學習案例：了解概念如何互相連接和建立
-
多步驟工作流程：透過複雜程序遵循邏輯
設定整合
所有實驗性功能都與 Amazon Q CLI 設定系統整合，並在工作階段間持續存在。您可以透過下列方式管理實驗：
互動式實驗選單：
/experiment
直接設定命令：
q settings chat.enableCheckpoint true q settings chat.enableContextUsageIndicator true q settings chat.enableKnowledge true q settings chat.enableTangentMode true q settings chat.enableThinking true q settings chat.enableDelegate true q settings chat.enableTodoList true
模糊搜尋整合
所有實驗性命令皆可透過模糊搜尋 () 取得Ctrl+S：
-
/experiment- 管理實驗性功能 -
/knowledge- 知識庫命令 （啟用時） -
/checkpoint- 檢查點命令 （啟用時） -
/todos- TODO 清單命令 （啟用時） -
/tangent- 切線模式切換 （啟用時）
此整合可讓您在工作流程期間輕鬆探索和存取實驗性功能。
其他資源
如需實驗功能的完整詳細資訊，包括進階組態選項和故障診斷，請參閱補充的 Amazon Q Developer CLI 文件：
