Agent 窗口是 TRAE 提供的 AI 原生工作台,旨在为用户提供统一、高效、可定制的 AI 协作体验,覆盖从专业开发到日常办公的各类场景。
Agent 窗口与 IDE 窗口之间会自动同步以下内容:
在 IDE 窗口右上角,点击 Agent 按钮,即可打开 Agent 窗口。

Agent 窗口支持云端、本地、工作树和 SSH 四类运行环境。你可以根据项目所在位置和任务需要,选择合适的环境。
| 运行环境 | 说明 | 适用场景 |
|---|---|---|
| 云端 | 在云端隔离环境中执行任务,使用云端的运行时与依赖配置。 | 需要在统一的云端环境中运行、分析或调试代码。 |
| 本地 | 在当前电脑的项目目录中执行任务,使用本地文件和开发环境。 | 处理本地项目,或需要使用本机已有的工具与依赖。 |
| 工作树 | 基于本地 Git 项目,为任务创建独立的工作树目录和分支,在隔离的工作目录中修改代码。 | 在同一个项目中并行开发功能、修复问题,减少不同任务之间的代码干扰。 |
| SSH | 通过 SSH 连接远程主机,在远程项目环境中执行任务。 | 项目和开发环境位于远程主机,需要使用该主机上的文件、工具与依赖。 |
发送消息前,点击对话输入框下方的运行环境菜单,选择 本地、云端 或 工作树。如需使用 SSH 环境,点击 连接 SSH,按界面提示连接远程主机。
本地项目的目录信任:
使用本地环境时,目录是否可信会影响 AI 能加载的项目配置和执行的操作。对于未信任的本地项目,TRAE 不会加载其中的项目规则、技能、命令和 Hooks,也无法运行终端。详细说明参考自动运行 & 安全性。
如果创建项目时没有选择信任,之后可以通过受限提示图标进行设置:

在右侧面板中部的对话输入框中,你可以向 AI 发送消息。AI 会生成一个任务,处理消息中的指令。你后续可以在该任务的对话中与 AI 连续沟通。

发送消息前,你可以按需完成以下设置:
| 编号 | 相关操作 |
|---|---|
|
1 |
点击 +,为当前任务添加上下文。添加后,AI 在处理当前任务对话的后续消息时会持续参考这些上下文。 可添加的上下文如下:
|
|
2 |
设置权限审批模式。选项如下:
|
| 3 | 添加可用插件。你可以根据任务需要添加一个或多个插件。 |
| 4 | 选择本次对话使用的模型。 |
你可以点击界面右上角的 展开工具面板 图标,打开工具面板。工具面板支持同时打开多个页签,你可以在这些页签中查看任务进度、产物预览、上下文和运行环境等信息。工具面板提供的页签如下:
| 页签名称 | 适用任务类型 | 描述 |
|---|---|---|
| 文件 | 本地、云端、工作树 | 展示 AI 在当前任务的工作区中生成的所有文件。 |
| 终端 | 本地、工作树 | 运行终端命令,协助完成开发、调试等操作。 |
| 浏览器 | 本地、云端、工作树 | 在浏览器中预览 AI 生成的产物,验证视觉效果和交互逻辑。你也可以在浏览器中打开其他网页进行浏览。 |
|
任务摘要 |
本地、云端、工作树 |
展示与当前任务相关的详情,包括:
|
| 代码变更 | 本地、工作树 | 以 Diff 形式展示当前产物中待提交或已提交的代码变更。 |

你可以对任务进行置顶、重命名、删除等操作。

删除项目或任务时,与其关联的部署站点也可能被删除。确认删除前,请检查这些站点是否还需要保留。
部署功能可用时,TRAE 会按以下顺序执行删除操作:
如果删除站点失败,TRAE 会停止后续操作,保留原有的项目或任务。请根据错误提示处理问题后重试。如果站点已经删除,但后续步骤失败,已删除的站点不会自动恢复。
你可以通过关键词进行跨模式全局搜索,快速查找目标任务或任务中的 Query。

Agent 窗口提供的云端智能体(Cloud Agent)能让你在云端环境中执行代码分析、运行和调试等任务。该环境提供了统一的运行时与依赖管理,确保所有代码都在一个稳定且隔离的远程环境中完成。这可以有效避免本地环境差异带来的兼容性或性能问题,让你能更专注于任务本身,而不必为环境配置或设备限制分心。