AI 助手
TRAE 智能问答助手
你好,我是 TRAE 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
TRAE IDE 里最热门的 Skill 是哪些?
如何创建自定义智能体?
如何配置 Rules?
文档反馈

Agent 窗口快速开始

复制页面

Agent 窗口是 TRAE 提供的 AI 原生工作台,旨在为用户提供统一、高效、可定制的 AI 协作体验,覆盖从专业开发到日常办公的各类场景。

Agent 窗口与 IDE 窗口之间的协同

Agent 窗口与 IDE 窗口之间会自动同步以下内容:

  • 本地任务的对话流与最终产物;
  • 云端与工作树任务的进度;
  • MCP、技能、规则、记忆、工具与扩展、IDE 设置等配置。

打开 Agent 窗口

在 IDE 窗口右上角,点击 Agent 按钮,即可打开 Agent 窗口。

Image

选择运行环境

Agent 窗口支持云端、本地、工作树和 SSH 四类运行环境。你可以根据项目所在位置和任务需要,选择合适的环境。

运行环境 说明 适用场景
云端 在云端隔离环境中执行任务,使用云端的运行时与依赖配置。 需要在统一的云端环境中运行、分析或调试代码。
本地 在当前电脑的项目目录中执行任务,使用本地文件和开发环境。 处理本地项目,或需要使用本机已有的工具与依赖。
工作树 基于本地 Git 项目,为任务创建独立的工作树目录和分支,在隔离的工作目录中修改代码。 在同一个项目中并行开发功能、修复问题,减少不同任务之间的代码干扰。
SSH 通过 SSH 连接远程主机,在远程项目环境中执行任务。 项目和开发环境位于远程主机,需要使用该主机上的文件、工具与依赖。

发送消息前,点击对话输入框下方的运行环境菜单,选择 本地、云端 或 工作树。如需使用 SSH 环境,点击 连接 SSH,按界面提示连接远程主机。

本地项目的目录信任:

使用本地环境时,目录是否可信会影响 AI 能加载的项目配置和执行的操作。对于未信任的本地项目,TRAE 不会加载其中的项目规则、技能、命令和 Hooks,也无法运行终端。详细说明参考自动运行 & 安全性。

创建后信任项目

如果创建项目时没有选择信任,之后可以通过受限提示图标进行设置:

  1. 将鼠标移到对话输入框下方的项目名称上,查看弹出的项目卡片。卡片右上角的橙色感叹号是受限提示图标。
  2. 点击该图标,按提示确认是否信任项目。

image.png

发送消息

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

Image

发送消息前,你可以按需完成以下设置:

编号 相关操作

1

点击 +,为当前任务添加上下文。添加后,AI 在处理当前任务对话的后续消息时会持续参考这些上下文。

可添加的上下文如下:

  • 本地附件,包括 .pptx、.xlsx 等
  • 当前项目中的文件
  • 当前账号下的已有产物,可在 “我的文件” 中查看
  • 命令、插件、技能
  • 已授权飞书账号所创建的飞书云文档
  • 已授权飞书账号下的通讯录,包括单聊和群聊

2

设置权限审批模式。选项如下:

  • 手动审批:AI 执行重要操作前,需要你逐一确认。
  • 自动审批:由 AI 自动审核并批准重要操作。
  • 完全访问:AI 可直接在你的电脑上执行所有操作,无需再次询问。
  • 自定义:你的自定义权限配置。
3 添加可用插件。你可以根据任务需要添加一个或多个插件。
4 选择本次对话使用的模型。

工具面板

你可以点击界面右上角的 展开工具面板 图标,打开工具面板。工具面板支持同时打开多个页签,你可以在这些页签中查看任务进度、产物预览、上下文和运行环境等信息。工具面板提供的页签如下:

页签名称 适用任务类型 描述
文件 本地、云端、工作树 展示 AI 在当前任务的工作区中生成的所有文件。
终端 本地、工作树 运行终端命令,协助完成开发、调试等操作。
浏览器 本地、云端、工作树 在浏览器中预览 AI 生成的产物,验证视觉效果和交互逻辑。你也可以在浏览器中打开其他网页进行浏览。

任务摘要

本地、云端、工作树

展示与当前任务相关的详情,包括:

  • 待办:当任务较复杂时,AI 会在此处列出任务计划(Todos)。你可以实时追踪每个子任务的进度。
  • 上下文:实时显示 AI 执行任务时引用的所有上下文,包括技能、文件、联网搜索内容等。若该任务所使用的上下文超出预期,你可以点击 压缩 按钮来压缩上下文。
代码变更 本地、工作树 以 Diff 形式展示当前产物中待提交或已提交的代码变更。

Image

管理任务

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

  1. 通过以下任一方式打开任务的操作菜单:
    • 在左侧任务栏中,将鼠标悬浮至目标任务,然后点击任务条目右侧的 更多操作 图标。
    • 在对话面板顶部,点击任务名称右侧的 更多操作 图标。
  2. 从菜单中选择所需操作,包括:
    • 置顶或取消置顶任务;
    • 查看任务相关的文件(列表视图或树状视图),以及在任务中新建文件或文件夹;
    • 重命名任务;
    • 分享任务中的对话;
    • 删除任务。

Image

删除项目或任务前须知

删除项目或任务时,与其关联的部署站点也可能被删除。确认删除前,请检查这些站点是否还需要保留。

部署功能可用时,TRAE 会按以下顺序执行删除操作:

  • 删除默认项目中的任务:先删除与该任务关联的部署站点,成功后再删除任务。
  • 删除项目或仓库分组:允许删除远端数据时,先删除关联的部署站点,再删除相关的定时任务,最后删除项目或分组。如果只是将 SSH 项目从本地移除,则不会删除远端的站点。

如果删除站点失败,TRAE 会停止后续操作,保留原有的项目或任务。请根据错误提示处理问题后重试。如果站点已经删除,但后续步骤失败,已删除的站点不会自动恢复。

全局搜索

你可以通过关键词进行跨模式全局搜索,快速查找目标任务或任务中的 Query。

  1. 在界面左上角,点击搜索图标。
  2. 在弹出的搜索框中输入关键词,查找目标任务或 Query。

Image

关于云端智能体

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

更新时间: