與 AI 助手對話時，你可以指定上下文供 AI 助手閱讀和理解，使 AI 助手的答復(fù)更精準(zhǔn)。

將編輯器內(nèi)的內(nèi)容作為上下文

當(dāng)你的編輯器中存在正在編輯的代碼文件時，AI 助手默認(rèn)能夠看到當(dāng)前文件。你可以直接向 AI 助手提問與當(dāng)前文件相關(guān)的問題。若期望對文件中的某一段代碼進(jìn)行提問，使用以下步驟：

1. 選中代碼。

2. 點擊懸浮菜單中的 添加到對話 按鈕，將選中的內(nèi)容作為上下文添加至側(cè)邊對話框。

   指定的上下文會顯示在側(cè)邊對話底部的輸入框。以下圖為例，輸入框內(nèi)顯示所選內(nèi)容所屬的文件名稱，以及所選的代碼行編號。

   

3. (可選) 繼續(xù)添加編輯器中的其他內(nèi)容片段，或同時添加其他來源的上下文。

將終端中的內(nèi)容作為上下文

若你希望對終端中的輸出內(nèi)容進(jìn)行提問（如幫助你修復(fù)報錯），使用以下步驟：

1. 在終端中，點擊輸出內(nèi)容片段。

2. 在內(nèi)容片段區(qū)域的右上角，點擊 添加到對話 按鈕，將選中的內(nèi)容作為上下文添加至側(cè)邊對話框。

   指定的上下文會顯示在側(cè)邊對話底部的輸入框。以下圖為例，輸入框內(nèi)顯示上下文的來源以及行號。

   

3. (可選) 繼續(xù)添加終端中的其他內(nèi)容片段，或同時添加其他來源的上下文。

使用 # 鍵添加上下文

在側(cè)邊對話的輸入框中，你可以通過 # 符號添加多種類的上下文，包括代碼、文件、文件夾和工作區(qū)。通常情況下，列表中將展示與編輯器中當(dāng)前打開文件相關(guān)的內(nèi)容作為推薦的上下文，但你仍然可以自行搜索所需的上下文并將其添加到輸入框中?；谀愕膯栴}，你可以組合添加各種來源的相關(guān)上下文（例如同時添加代碼和文件）。

Code

通過 #Code，你可以將函數(shù)或類的相關(guān)代碼作為與 AI 助手對話的上下文。列表中默認(rèn)展示當(dāng)前編輯器內(nèi)打開的文件中的函數(shù)或類。選擇前，你可以預(yù)覽列表中推薦的函數(shù)或類的相關(guān)代碼。若推薦的內(nèi)容非你所需，你可以通過關(guān)鍵詞搜索所需的函數(shù)或類。

提示
若 Trae 中不存在對應(yīng)語言的語言服務(wù)協(xié)議（Language Server Protocol），請?zhí)崆鞍惭b，否則可能導(dǎo)致無法識別代碼符號。

1. 在輸入框中輸入 #，或直接點擊輸入框左下角的 # 上下文 按鈕。

   輸入框上方顯示上下文類型選擇列表。

2. 在列表中選擇 Code（或在 # 符號后手動輸入 Code），然后按下回車鍵。

   列表將展示編輯器中當(dāng)前打開的文件中存在的函數(shù)和類。將鼠標(biāo)懸浮在列表中的某個條目后，左側(cè)會展示該函數(shù)或類的代碼內(nèi)容，供你預(yù)覽。

   

3. 若推薦的函數(shù)和類非你所需，在 #Code: 后輸入你想要的函數(shù)或類的名稱或關(guān)鍵詞。

   AI 助手將在項目內(nèi)搜索相關(guān)函數(shù)和類，并展示在列表中，你可以進(jìn)行預(yù)覽。

   

4. 從列表中選擇需指定為上下文的函數(shù)或類。

File

通過 #File，你可以將指定文件中的所有內(nèi)容作為與 AI 助手對話的上下文。列表中默認(rèn)展示近期在編輯器中打開過的文件。你可以預(yù)覽這些文件所在的目錄，以免因存在同名文件而導(dǎo)致錯選。若展示的文件非你所需，你可以通過關(guān)鍵詞搜索所需文件。

1. 在輸入框中輸入 #，或直接點擊輸入框左下角的 # 上下文 按鈕。

   輸入框上方顯示上下文類型選擇列表。

2. 在列表中選擇 File（或在 # 符號后手動輸入 File），然后按下回車鍵。

   列表展示近期在編輯器中打開過的文件。將鼠標(biāo)懸浮在列表中的某個條目后，左側(cè)會展示該文件所在的目錄。

   

3. 若推薦的文件非你所需，在 #File: 后輸入你想要的文件的名稱或關(guān)鍵詞。

   AI 助手將在項目內(nèi)搜索相關(guān)文件并展示在列表中。

   

4. 從列表中選擇需指定為上下文的文件。

Folder

通過 #Folder，你可以將指定文件夾中的所有內(nèi)容作為與 AI 助手對話的上下文。列表中默認(rèn)展示與編輯器中當(dāng)前所打開文件相關(guān)的文件夾。你可以預(yù)覽這些文件夾所在的目錄，以免因存在同名文件夾而導(dǎo)致錯選。若展示的文件夾非你所需，你可以通過關(guān)鍵詞搜索所需文件夾。

提示
#Folder 依賴項目代碼索引（Project Code Index）是否構(gòu)建完全。若索引暫未構(gòu)建完全，可能會影響文件夾內(nèi)容召回的效果，從而導(dǎo)致 AI 助手的回答不夠完整。提問時，若索引從未構(gòu)建或正在構(gòu)建中，References 位置將出現(xiàn) “索引構(gòu)建中” 或 “索引暫未構(gòu)建” 的提示，你可以根據(jù)引導(dǎo)在設(shè)置頁管理索引。詳情參考《AI 設(shè)置》。

1. 在輸入框中輸入 #，或直接點擊輸入框左下角的 # 上下文 按鈕。

   輸入框上方顯示上下文類型選擇列表。

2. 在列表中選擇 Folder（或在 # 符號后手動輸入 Folder），然后按下回車鍵。

   列表展示與編輯器中當(dāng)前所打開文件相關(guān)的文件夾。將鼠標(biāo)懸浮在列表中的某個條目后，左側(cè)會展示該文件夾所在的目錄。

   

3. 若推薦的文件夾非你所需，在 #Folder: 后輸入你想要的文件夾的名稱或關(guān)鍵詞。

   AI 助手將在項目內(nèi)搜索相關(guān)文件夾并展示在列表中。

   

4. 從列表中選擇需指定為上下文的文件夾。

Workspace

你可以使用 #Workspace 來向 AI 助手提出有關(guān)整個工作空間的問題，AI 助手將自動在工作空間中查找與你的問題最相關(guān)的內(nèi)容作為上下文進(jìn)行回答。遇到不熟悉的項目時，該功能可以幫助你全局了解該項目所實現(xiàn)的功能和代碼，從而使你快速上手該項目的開發(fā)。

提示
- 僅支持在 Chat 模式中使用。Builder 模式會自動將整個工作空間作為上下文。
- #Workspace 依賴項目代碼索引（Project Code Index）是否構(gòu)建完全。若索引暫未構(gòu)建完全，可能會影響文件夾內(nèi)容召回的效果，從而導(dǎo)致 AI 助手的回答不夠完整。提問時，若索引從未構(gòu)建或正在構(gòu)建中，References 位置將出現(xiàn) “索引構(gòu)建中” 或 “索引暫未構(gòu)建” 的提示，你可以根據(jù)引導(dǎo)在設(shè)置頁管理索引。詳情參考《AI 設(shè)置》。

1. 在輸入框中輸入 #，或直接點擊輸入框左下角的 # 上下文 按鈕。

   輸入框上方顯示上下文類型選擇列表。

2. 在列表中選擇 Workspace（或在 # 符號后手動輸入 Workspace）。

   

Doc

你可以上傳個人文檔集，將文檔內(nèi)容作為 AI 對話的上下文，讓 AI 更精準(zhǔn)地處理你的需求。

提示
創(chuàng)建文檔集時，Trae 將針對文檔集內(nèi)容構(gòu)建索引，在索引過程中文檔數(shù)據(jù)將被傳輸至 Trae 服務(wù)器進(jìn)行矢量化，但 Trae 不會讀取或存儲任何文檔數(shù)據(jù)，矢量化完成后文檔數(shù)據(jù)和矢量數(shù)據(jù)都將從 Trae 的服務(wù)器中刪除，數(shù)據(jù)將返回至用戶的設(shè)備并存儲在用戶本地。在 Trae 中刪除文檔集后，本地數(shù)據(jù)也將被同步刪除。

創(chuàng)建文檔集并將其引用為上下文的步驟如下：

1. 在 AI 對話窗口的右上角，點擊 設(shè)置 圖標(biāo) > 上下文，或在 AI 對話輸入框中點擊 # 上下文 > Doc > 添加文檔集。

   界面上顯示 上下文 窗口。

2. 在 文檔集 部分，點擊 + 添加文檔集 按鈕。

   

3. 選擇合適的方式添加文檔集。

   通過 URL 添加

   從本地文件添加

   在菜單中選擇 通過 URL 添加 選項，然后在彈窗中輸入文檔集名稱和文檔站的 URL。   點擊 確認(rèn) 按鈕后，Trae IDE 開始索引站點下的網(wǎng)頁。以該入口 URL 為起點，Trae IDE 會自動抓取同一站點中與入口 URL 同級路徑或子路徑下，最多三次跳轉(zhuǎn)內(nèi)的頁面內(nèi)容。若入口 URL 為 https://www.example.com/docs/api，則： ● 可抓取內(nèi)容的路徑示例如下： ○ https://www.example.com/docs/changelog（同級路徑） ○ https://www.example.com/docs/api/abc（子路徑） ○ https://www.example.com/docs/protocol/def（同級路徑的子路徑） ● 不可抓取內(nèi)容路徑示例如下： ○ https://www.anotherexample.com（不同 Host） ○ https://www.example.com/（高于入口路徑） ○ https://www.example.com/blogs（不屬于同一路徑） <br> >注意 >在使用本工具時，應(yīng)遵循目標(biāo)網(wǎng)址的規(guī)則，合法合規(guī)使用本工具。本工具僅支持查看公開可訪問的技術(shù)文檔類網(wǎng)站，用于學(xué)習(xí)、研究的目的，感謝你的理解與配合。 >Trae IDE 在掃描頁面時將會嚴(yán)格遵循網(wǎng)頁的 /robots.txt 規(guī)范，若被網(wǎng)站拒絕則無法正常索引，索引頁面列表中將展示 “網(wǎng)站限制無法訪問”。

   在菜單中選擇 從本地文件添加 選項，然后在彈窗中輸入文檔集名稱并添加本地文件。   ●  文件格式：.md 和 .txt   ●  文件大小：單個文件最大 10 MB   ●  文檔集大小：最大 50 MB   ●  文件數(shù)量：不超過 1000 個   點擊 確認(rèn) 按鈕后，Trae IDE 開始索引文件。

   文檔添加完成后，將被展示在文檔集列表中。你可以按需修改文檔集名稱、重新索引頁面或文件、刪除文檔集。

4. 在 AI 對話輸入框中，引用你添加的文檔集作為上下文。

   

Web

你可以將線上網(wǎng)站的內(nèi)容作為 AI 對話的上下文。

• 直接在 #Web 后輸入你的問題并發(fā)送。這種方式會觸發(fā)聯(lián)網(wǎng)搜索，Trae AI 會在全網(wǎng)搜索與提問相關(guān)的內(nèi)容并生成答復(fù)。

  

• 在輸入框中先輸入網(wǎng)址，再輸入問題，Trae AI 會直接從該網(wǎng)站查詢相關(guān)內(nèi)容并生成回答。這種方式不僅能獲取網(wǎng)站的最新信息作為問答依據(jù)，還能同時從多個網(wǎng)站檢索與問題最相關(guān)的內(nèi)容。

  

管理代碼索引

Trae AI 可以為項目構(gòu)建索引。構(gòu)建索引后，用戶通過 #Workspace 或 #Folder 方式與 AI 助手對話時，AI 助手能夠理解用戶當(dāng)前打開的項目并使用整個項目作為上下文進(jìn)行回答，從而提供更加精準(zhǔn)的回答。

若未構(gòu)建索引或索引構(gòu)建不完全，在使用 #Workspace 或 #Folder 方式與 AI 助手對話時，可能會導(dǎo)致無法召回完整的上下文，進(jìn)一步導(dǎo)致回答不完整。此時，AI回答處將出現(xiàn) “索引建構(gòu)中” 或 “索引暫未建構(gòu)” 的提示。

在 AI 對話框右上角，點擊 設(shè)置 圖標(biāo) > 上下文，然后在 代碼索引管理 部分管理索引構(gòu)建的狀態(tài)和產(chǎn)物。相關(guān)操作如下：

操作	說明
開始索引	●  針對文件數(shù)量小于等于 5000 的項目，Trae 將在打開項目時自動構(gòu)建代碼索引。   ●  若項目內(nèi)的文件數(shù)大于 5000 且你期望項目級的回答更準(zhǔn)確，此時可以點擊 開始構(gòu)建 按鈕，為當(dāng)前項目構(gòu)建代碼索引。
停止索引	若代碼索引構(gòu)建過程中出現(xiàn)了異常情況，你期望停止構(gòu)建，則可以點擊 取消構(gòu)建 按鈕，本地索引構(gòu)建將被暫停。
重新構(gòu)建	若你期望重啟構(gòu)建，則可以點擊 重新構(gòu)建 按鈕，繼續(xù)上一次的構(gòu)建。
刪除索引	若你期望清空代碼索引，則可以點擊 清空 按鈕。

忽略文件

Trae IDE 默認(rèn)忽略 .gitignore 文件中所羅列的文件。除此之外， 你可以自主設(shè)置 Trae IDE 在索引倉庫時需要額外忽略的文件列表，以作為 .gitignore 文件中已定義規(guī)則的補(bǔ)充。

1. 在 AI 對話窗口的右上角，點擊 設(shè)置 圖標(biāo) > 上下文。

   界面上顯示 上下文 窗口。

2. 在 忽略文件 部分，點擊 配置忽略文件 按鈕。

   

   系統(tǒng)自動創(chuàng)建 .ignore 文件并在編輯器中打開。

3. 在 .ignore 文件中添加需要忽略的文件并保存。