智能體（Agent）是你面向不同開發(fā)場景的編程助手。Trae IDE 提供內(nèi)置智能體。同時，你還可以創(chuàng)建自定義智能體，通過靈活配置提示詞和工具集，使其更高效地幫你完成復(fù)雜任務(wù)。

智能體的能力

• 自主運行 - 獨立探索你的代碼庫，識別相關(guān)文件并進(jìn)行必要修改。
• 完整的工具訪問權(quán)限 - 使用所有可用工具進(jìn)行搜索、編輯、創(chuàng)建文件及運行終端命令。
• 上下文理解 - 建立對你項目的結(jié)構(gòu)和依賴關(guān)系的全面理解。
• 多步驟規(guī)劃 - 將復(fù)雜任務(wù)拆分為可執(zhí)行的步驟，并按順序逐一處理。

智能體的工作流

1. 需求分析：深入理解任務(wù)目標(biāo)及代碼庫上下文，明確需求要點。
2. 代碼調(diào)研：檢索代碼庫、文檔及網(wǎng)絡(luò)資源，定位相關(guān)文件并分析現(xiàn)有實現(xiàn)邏輯。
3. 方案設(shè)計：根據(jù)分析結(jié)果拆解任務(wù)步驟，并動態(tài)優(yōu)化調(diào)整修改策略。
4. 實施變更：照計劃在整個代碼庫中進(jìn)行必要的代碼變更，過程中可能涉及：
   • 新增依賴庫推薦
   • 需執(zhí)行的終端指令
   • Trae IDE 客戶端外的手動操作指引
5. 交付驗收：完成驗證后移交控制權(quán)，同步匯總所有修改內(nèi)容。

內(nèi)置智能體

Trae IDE 提供以下內(nèi)置智能體：

• Builder：Builder 可以幫助你從 0 到 1 開發(fā)一個完整的項目。根據(jù)你的需求，Builder 會調(diào)用不同的工具，包括分析代碼文件的工具、編輯代碼文件的工具、運行命令的工具等等，從而更加精確且有效地處理你的需求。

• Builder with MCP：在 Builder 的基礎(chǔ)上，你配置的所有 MCP Server 都會默認(rèn)添加至 Builder with MCP，且不可編輯。

  提示
  使用 Builder with MCP 時，若遇到拒絕回答的情況，則可以在其他智能體中使用 MCP Server。

  

創(chuàng)建自定義智能體

1. 在 AI 對話窗口中，點擊 設(shè)置 圖標(biāo) > 智能體，或在 AI 對話輸入框中點擊 @智能體 > + 創(chuàng)建智能體。

   界面上顯示 智能體 窗口。

2. 點擊 + 創(chuàng)建智能體 按鈕。

   你將前往以下智能體配置面板。

   

3. 配置智能體。

   配置項	說明
   名稱	輸入智能體的名稱。
   提示詞	輸入智能體的提示詞（Prompt），用于規(guī)范和指導(dǎo)智能體完成任務(wù)的方式。你可以規(guī)定智能體的人設(shè)、回答口吻、工作流程、使用工具的時機(jī)和需要遵守的規(guī)范等。
   工具	配置智能體處理需求時可以調(diào)用的工具，包括：  ● MCP Server：添加 MCP Server 后，智能體在處理你的需求時可調(diào)用 MCP Server 提供的工具。你可以為一個智能體添加一個或多個 MCP Server。關(guān)于 MCP Server 的更多信息，參考《模型上下文協(xié)議（MCP）》。  ● 內(nèi)置工具    ? 文件系統(tǒng)：對文件進(jìn)行增刪改查。    ? 終端：在終端運行命令，并獲取命令的運行狀態(tài)和結(jié)果。    ? 聯(lián)網(wǎng)搜索：搜索和用戶任務(wù)相關(guān)的網(wǎng)頁內(nèi)容。    ? 預(yù)覽：在生成可預(yù)覽的前端結(jié)果后提供預(yù)覽入口。

4. 點擊 創(chuàng)建 按鈕。

使用智能體

在 AI 對話輸入框中，輸入 @ 或者點擊 @智能體，然后在智能體列表中選擇你想用的智能體。

管理智能體

在 智能體 窗口中，你可以修改或刪除自定義智能體。

開啟/關(guān)閉 “自動運行” 功能

自動運行 功能作用于所有智能體。你可以在 智能體 窗口開啟該功能并將指定命令加入黑名單后（默認(rèn)已將 rm、kill 和 chmod 加入黑名單），智能體會自動運行模型認(rèn)為安全且不在黑名單中的命令和 MCP 服務(wù)器。智能體提出建議執(zhí)行的命令時，如果命令前綴在黑名單中，執(zhí)行命令前會請求用戶確認(rèn)。

注意
開啟 “自動運行” 后，可能存在外部提示詞注入（Prompt Injection）的安全風(fēng)險，請謹(jǐn)慎評估后使用。

更多功能

Trae IDE 提供一系列可以配合智能體使用的功能，精準(zhǔn)且高效地助力你從 0 到 1 開發(fā)項目。

使用自定義模型

Trae 預(yù)置了一系列業(yè)內(nèi)表現(xiàn)比較出色的模型，你可以直接切換不同的模型進(jìn)行使用。此外，Trae 還支持通過 API 密鑰（API Key）接入自定義模型，從而滿足個性化的需求。詳情參考《模型》。

添加上下文

智能體可以理解當(dāng)前項目中的上下文，包括代碼、文件和文件夾，從而更精確地協(xié)助你完成開發(fā)需求。詳情參考《上下文》。

生成并處理代碼變更

根據(jù)你的需求，智能體會自動創(chuàng)建新文件或編輯已有文件，并自動保存生成的代碼。你可以選擇接受或拒絕代碼變更，包括：

• 處理多文件內(nèi)的所有代碼變更：點擊輸入框上方待審查文件列表中的 全部接受 或 全部拒絕 按鈕，批量接受或拒絕當(dāng)前項目中的所有代碼變更。

  

• 處理單文件內(nèi)的所有代碼變更：在編輯器內(nèi)打開文件，點擊上方提示條中的 接受 按鈕（快捷鍵：macOS 為 Command + Enter；Windows 為 Ctrl + Enter）或 拒絕 按鈕（快捷鍵：macOS 為 Command + Backspace；Windows 為 Ctrl + Backspace），批量接受或拒絕當(dāng)前文件內(nèi)的所有代碼變更。

  

• 處理單處代碼變更：在編輯器內(nèi)，將鼠標(biāo)懸浮至某個代碼變更處，然后點擊右上角的 ^Y 按鈕（快捷鍵：macOS 為 Control+Y；Windows 為 Alt + Y）或 ^N 按鈕（快捷鍵：macOS 為 Control + N；Windows 為 Alt + N），接受或拒絕該變更。

  

生成并運行命令

根據(jù)你的需求，智能體會適時推薦必要的 Shell 命令供你運行（以下圖為例）。你可以選擇運行或跳過某個命令，智能體會根據(jù)你的操作完成后續(xù)的工作。

點擊 運行 后，終端將運行該命令。命令運行后，智能體會自動讀取并分析運行結(jié)果。如果運行異常，智能體會自動分析原因，并給出建議解決方案。

若命令運行成功，你可以點擊命令卡片右上角的 終端 按鈕，然后在終端中查看該命令的運行日志。

預(yù)覽成果

智能體完成開發(fā)需求后，會提供 預(yù)覽 按鈕。點擊后，Trae 會打開 Preview 窗口，用于展示開發(fā)成果。

預(yù)覽過程中，若你繼續(xù)與智能體對話，修改需求，開發(fā)成果會在 Preview 窗中實時更新。

回退版本

你可以將項目回退到指定會話輪次發(fā)起前的版本。

提示
- 回退操作不可撤銷。
- 僅支持回退至最近 10 輪會話內(nèi)的版本。

使用以下步驟回退項目的版本：

1. 找到目標(biāo)對話氣泡。

2. 點擊左側(cè)的 回退 按鈕。

   

   對話框中展示本次回退會影響的文件。

   

3. 點擊文件名。

   編輯器內(nèi)會打開該文件，顯示即將發(fā)生的變更。

4. 確認(rèn)本次回退的影響范圍。

5. 若本次回退符合預(yù)期，點擊 確定。

   智能體開始回退項目。

管理歷史對話

點擊對話窗口右上角的 歷史會話 按鈕，查看并管理你與智能體的所有對話。

• 若你需要查看某輪歷史對話，點擊該對話，你會跳轉(zhuǎn)至該對話的位置。
• 若需要刪除某輪對話，可以將鼠標(biāo)懸浮至該對話，然后點擊右側(cè)的 刪除 圖標(biāo)。對話被刪除后無法恢復(fù)。