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

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

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

1. 選中代碼。

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

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

   

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

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

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

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

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

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

   

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

使用 # 鍵添加上下文

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

Code

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

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

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

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

2. 在列表中選擇 Code（或在 # 符號(hào)后手動(dòng)輸入 Code），然后按下回車鍵。

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

   

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

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

   

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

File

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

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

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

2. 在列表中選擇 File（或在 # 符號(hào)后手動(dòng)輸入 File），然后按下回車鍵。

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

   

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

   AI 助手將在項(xiàng)目?jī)?nèi)搜索相關(guān)文件并展示在列表中。

   

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

Folder

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

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

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

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

2. 在列表中選擇 Folder（或在 # 符號(hào)后手動(dòng)輸入 Folder），然后按下回車鍵。

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

   

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

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

   

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

Workspace

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

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

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

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

2. 在列表中選擇 Workspace（或在 # 符號(hào)后手動(dòng)輸入 Workspace）。

   

Doc

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

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

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

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

   界面上顯示 上下文 窗口。

2. 在 文檔集 部分，點(diǎn)擊 + 添加文檔集 按鈕。

   

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

   通過(guò) URL 添加

   從本地文件添加

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

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

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

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

   

Web

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

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

  

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

  

管理代碼索引

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

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

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

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

忽略文件

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

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

   界面上顯示 上下文 窗口。

2. 在 忽略文件 部分，點(diǎn)擊 配置忽略文件 按鈕。

   

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

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