创建并管理智能体
你可以在 TRAE 中创建自定义智能体,并为其配置提示词、MCP Server 与内置工具,使其能够协助你完成特定任务。同时,你也可以对已创建的自定义智能体进行管理,包括修改、分享和删除。
创建自定义智能体
你可以通过智能生成和手动创建两种方式来搭建自定义智能体。
-
在 AI 对话输入框中输入 @,然后点击浮起面板底部的 创建智能体 按钮。
-
你将进入以下 创建智能体 面板。
-

-
选择一种方式来创建智能体,包括智能生成和手动创建。
智能生成(推荐)
若你选择智能生成智能体,使用以下步骤:
-
在创建智能体 面板的右上角,点击 智能生成 按钮。
-
在 智能生成智能体 弹窗中,描述智能体的功能、使用场景、使用时机等。建议提供全面的描述,让生成的智能体能更加符合你的要求。
-
(可选) 勾选 默认开启智能生成 复选框。
-
每次进入 创建智能体 面板时,将自动展示 智能生成智能体 弹窗。
-
点击 生成 按钮。
-
系统开始按你的描述生成一个智能体。
-
按需修改自动生成的智能体的参数。
| 参数 | 说明 | |
|---|---|---|
| 头像 | (可选) 上传图片作为智能体的头像。 | |
| 名称 | 输入智能体的名称。 | |
| 提示词 | 输入智能体的提示词(Prompt),用于规范和指导智能体完成任务的方式。你可以规定智能体的人设、回答口吻、工作流程、使用工具的时机和需要遵守的规范等。 | |
| 可被其他智能体调用 | 英文标识名:该智能体被调用时的唯一英文标识,例如 project-analyzer。 何时调用:描述其他智能体调用该智能体的合适场景和时机。 |
|
| 工具 | MCP Server:添加 MCP Server 后,智能体在处理你的需求时可调用 MCP Server 提供的工具。你可以为一个智能体添加一个或多个 MCP Server。关于 MCP Server 的更多信息,参考《模型上下文协议(MCP)》。 内置工具 阅读:对文件进行检索和查看。 文件系统:对文件进行增删改查。 终端:在终端运行命令,并获取命令的运行状态和结果。 联网搜索:搜索和用户任务相关的网页内容。 预览:在生成可预览的前端结果后提供预览入口。 |
- 在面板底部,点击 创建 按钮。
手动创建
若你选择手动创建智能体,则需要依次配置以下参数,然后点击底部的 创建 按钮来完成创建。
| 参数 | 说明 | |
|---|---|---|
| 头像 | (可选) 上传图片作为智能体的头像。 | |
| 名称 | 输入智能体的名称。 | |
| 提示词 | 输入智能体的提示词(Prompt),用于规范和指导智能体完成任务的方式。你可以规定智能体的人设、回答口吻、工作流程、使用工具的时机和需要遵守的规范等。 | |
| 可被其他智能体调用 | 英文标识名:该智能体被调用时的唯一英文标识,例如 project-analyzer。 何时调用:描述其他智能体调用该智能体的合适场景和时机。 |
|
| 工具 | MCP Server:添加 MCP Server 后,智能体在处理你的需求时可调用 MCP Server 提供的工具。你可以为一个智能体添加一个或多个 MCP Server。关于 MCP Server 的更多信息,参考《模型上下文协议(MCP)》。 内置工具 阅读:对文件进行检索和查看。 文件系统:对文件进行增删改查。 终端:在终端运行命令,并获取命令的运行状态和结果。 联网搜索:搜索和用户任务相关的网页内容。 预览:在生成可预览的前端结果后提供预览入口。 |
使用智能体
在 AI 对话输入框中,输入 @ 或者点击 @智能体,然后在智能体列表中选择你想用的智能体。
修改/分享/删除智能体
你可以按需管理自定义智能体,包括:
-
修改自定义智能体的配置。
-
直接通过 TRAE IDE 将自定义智能体分享至掘金社区,或通过复制自定义智能体的链接来将其分享至更多渠道。
-
提示分享前,建议对智能体提示词和 MCP Server 配置中的信息进行脱敏。
-
删除自定义智能体。
在自定义智能体列表中,点击 设置 图标,然后在菜单中选择相应的选项并完成所需操作。
对于分享智能体,除通过智能体设置菜单操作外,你也可以先进入智能体的编辑面板,然后点击智能体名称右侧的 分享 按钮进行分享。
导入智能体
你可以将他人分享的智能体导入至 TRAE IDE,从而复用智能体的配置。
-
点击他人分享的链接。
-
根据浏览器的引导打开 TRAE IDE。
-
TRAE IDE 中弹出智能体的信息展示窗口。
-
点击 立即获取 按钮。
-
TRAE IDE 导入该智能体并将你导航至该智能体的配置页面。
相关功能
TRAE 提供一系列可以配合智能体使用的功能,精准且高效地助力你从 0 到 1 开发项目。
使用自定义模型
TRAE 预置了一系列业内表现比较出色的模型,你可以直接切换不同的模型进行使用。此外,TRAE 还支持通过 API 密钥(API Key)接入自定义模型,从而满足个性化的需求。详情参考模型。
添加上下文
智能体可以理解当前项目中的上下文,包括代码、文件和文件夹,从而更精确地协助你完成开发需求。详情参考基础用法。
生成并处理代码变更
根据你的需求,智能体会自动创建新文件或编辑已有文件,并自动保存生成的代码。你可以选择接受或拒绝代码变更,包括:
-
处理多文件内的所有代码变更:点击输入框上方待审查文件列表中的 全部接受 或 全部拒绝 按钮,批量接受或拒绝当前项目中的所有代码变更。
-
处理单文件内的所有代码变更:在编辑器内打开文件,点击上方提示条中的 接受 按钮(快捷键:macOS 为 Command + Enter;Windows 为 Ctrl + Enter)或 拒绝 按钮(快捷键:macOS 为 Command + Backspace;Windows 为 Ctrl + Backspace),批量接受或拒绝当前文件内的所有代码变更。
-
处理单处代码变更:在编辑器内,将鼠标悬浮至某个代码变更处,然后点击右上角的 ^Y 按钮(快捷键:macOS 为 Control+Y;Windows 为 Alt + Y)或 ^N 按钮(快捷键:macOS 为 Control + N;Windows 为 Alt + N),接受或拒绝该变更。
生成并运行命令
根据你的需求,智能体会适时推荐必要的 Shell 命令供你运行(以下图为例)。你可以选择运行或跳过某个命令,智能体会根据你的操作完成后续的工作。
点击 运行 后,终端将运行该命令。命令运行后,智能体会自动读取并分析运行结果。如果运行异常,智能体会自动分析原因,并给出建议解决方案。
预览成果
智能体完成开发需求后,会提供 预览 按钮。点击后,TRAE 会打开 Preview 窗口,用于展示开发成果。
预览过程中,若你继续与智能体对话,修改需求,开发成果会在 Preview 窗中实时更新。
回退版本
你可以将项目回退到指定会话轮次发起前的版本。
提示
- 回退操作不可撤销。
- 仅支持回退至最近 10 轮会话内的版本。
使用以下步骤回退项目的版本:
-
找到目标对话气泡。
-
点击左侧的 回退 按钮。
-

-
对话框中展示本次回退会影响的文件。
-

-
点击文件名。
-
编辑器内会打开该文件,显示即将发生的变更。
-
确认本次回退的影响范围。
-
若本次回退符合预期,点击 确定。
-
智能体开始回退项目。
管理历史对话
点击对话窗口右上角的 历史会话 按钮,查看并管理你与智能体的所有对话。
-
若你需要查看某轮历史对话,点击该对话,你会跳转至该对话的位置。
-
若需要删除某轮对话,可以将鼠标悬浮至该对话,然后点击右侧的 删除 图标。对话被删除后无法恢复。
可一键导入 TRAE 的自定义智能体
针对项目开发中的不同场景,TRAE 官方提供了一系列可直接导入并使用的自定义智能体示例。这些智能体可以被单独调用;或在开发流程的相应阶段由 SOLO Coder 自动调用,以完成特定任务。详情参考支持一键导入的自定义智能体。