Trea智能体使用指南

永远的实习生
5,323 阅读12分钟

Trea智能体使用指南

一、Trea简介

Trea是字节跳动推出的AI原生集成开发环境(IDE)，专为中文开发者设计，集成了Claude 3.7和GPT-4o等先进AI模型，支持通过自然语言交互实现代码生成、项目构建与调试。Trea的核心定位是"真正能干活"的智能编程助手，通过智能生产力重构开发流程，致力于成为"真正的AI工程师"（The Real AI Engineer）。

核心特点

  • 智能体系统：支持自定义智能体，包括角色配置、工具调用、任务逻辑等，打造专属AI团队
  • MCP协议：通过标准化接口集成多种外部工具，智能体可灵活调用资源
  • 多模态上下文：理解代码仓库、文档集、网页等多源信息，支持自定义工作规则
  • 实时代码补全：基于强大上下文分析，支持20+编程语言，效率提升300%+
  • 隐私安全：本地优先存储策略，代码默认存于本地，临时计算嵌入后删除明文数据

二、安装指南

1. 系统要求

  • 操作系统：macOS 10.15+ 或 Windows 10/11（Linux版本暂未推出）
  • 内存：8GB以上（推荐16GB以流畅运行AI模型）
  • 存储空间：至少2GB可用空间
  • 网络连接：必需（建议5Mbps或更快）

2. 下载安装包

Trea提供国内版和国际版两个版本：

  • 国内版：内置Doubao-1.5-pro和DeepSeek-R1/V3模型，无需科学上网

  • 国际版：支持Claude 3.7和GPT-4o模型，需要使用VPN访问

下载方式：

  • Windows用户：下载.exe安装程序
  • macOS用户：下载.dmg文件（可通过命令直接下载：curl -O https://download.trae.ai/macOS/Trea-2.8.5.dmg）

3. 安装过程

Windows系统：

  1. 双击下载的.exe安装程序
  2. 点击"我同意协议"，然后点击"下一步"
  3. 选择安装路径（建议不要安装在C盘）
  4. 点击"安装"，等待安装完成
  5. 安装完成后点击"完成"启动Trae AI

macOS系统：

  1. 双击下载的.dmg文件
  2. 将Trae图标拖拽至Applications文件夹
  3. 在应用程序中找到Trae并双击启动

4. 初始配置

首次启动设置：

  1. 点击"开始"按钮进入配置流程
  2. 选择主题：可选暗色、亮色或深蓝主题
  3. 选择语言：支持简体中文和English（推荐中文开发者选择简体中文）
  4. 点击"继续"进入下一步

导入现有配置（可选） ：

  • 点击"从VS Code导入"或"从Cursor导入"按钮
  • 系统会自动导入插件、IDE设置、快捷键设置等信息
  • 如需全新开始，可选择"跳过"

安装命令行工具（可选） ：

  1. 点击"安装trae命令"按钮

  2. 完成授权流程

  3. 安装后可在终端使用以下命令：

    • trae：快速唤起Trae
    • trae my-react-app：在Trae中打开指定项目

登录账号：

  1. 点击"登录"按钮
  2. 国内版支持手机号、掘金账号登录
  3. 国际版支持GitHub、Google账号登录
  4. 登录成功后即可使用AI功能

三、核心功能

Trea主要提供两种工作模式：Chat模式和Builder模式，分别适用于不同的开发场景。

1. Chat模式：智能问答与代码辅助

进入方式：

  • 默认启动即为Chat模式
  • 或使用快捷键Command/Ctrl + U打开侧边对话框，然后点击左上角的"Chat"

功能特点：

  • 代码解释：选中代码后右键选择"Ask Trae"，AI会解释代码逻辑
  • 错误修复：将终端报错信息拖拽到对话框，AI提供修复方案
  • 代码优化：输入优化需求，如"优化这段Python代码的运行效率"
  • 技术问答：直接提问技术问题，如"如何在React中使用Redux"

模型选择：

  • 国内版：Doubao-1.5-pro（默认）、DeepSeek-R1、DeepSeek-V3
  • 国际版：Claude 3.7、GPT-4o

2. Builder模式：从零构建项目

进入方式：

  • 使用快捷键Command/Ctrl + U打开侧边对话框
  • 点击左上角的"Builder"
  • 点击"启用Builder"按钮
  • 选择AI模型（DeepSeek-R1或DeepSeek-V3）

功能特点：

  • 自然语言生成项目：用中文描述需求即可生成完整项目
  • 自动环境配置：自动安装依赖、初始化项目
  • 多文件协调：同时生成/修改多个关联文件
  • 实时预览：一键预览Web页面效果

使用流程：

  1. 新建项目：

    • 点击"文件 → 新建项目 → AI驱动开发"
    • 或新建文件夹后，在Builder模式输入需求

  2. 输入需求：用自然语言描述项目，例如：

    • "开发一个包含登录功能的待办事项App"
    • "使用Vue开发一个网页抽奖程序，界面简洁"

  3. 项目生成：

    • AI会自动生成功能清单
    • 确认后生成项目结构、安装依赖

  4. 处理代码变更：

    • 多文件变更：点击"全部接受"或"全部拒绝"批量处理
    • 单文件变更：在编辑器中点击"接受"(Cmd/Ctrl+Enter)或"拒绝"(Cmd/Ctrl+Backspace)
    • 单处变更：点击代码右上角的^Y(接受)或^N(拒绝)

  5. 运行与预览：

    • 点击"运行"按钮启动项目
    • 点击"预览"在Webview中查看效果
    • 点击"在浏览器中打开"可全屏预览

四、智能体创建与使用

1. 智能体概述

智能体（Agent）是面向不同开发场景的编程助手，具有以下核心能力：

  • 自主运行：独立探索代码库，识别相关文件并进行必要修改
  • 完整工具访问：使用所有可用工具进行搜索、编辑、创建文件及运行终端命令
  • 上下文理解：建立对项目结构和依赖关系的全面理解
  • 多步骤规划：将复杂任务拆分为可执行步骤，并按顺序逐一处理

Trea提供内置智能体，同时支持创建自定义智能体，通过灵活配置提示词和工具集，使其更高效地完成复杂任务。

2. 内置智能体

  • Builder：帮助从0到1开发完整项目，调用不同工具处理需求
  • Builder with MCP：在Builder基础上，默认添加所有配置的MCP Server

3. 创建自定义智能体

步骤：

  1. 在AI对话窗口中，点击设置图标 > 智能体，或在AI对话输入框中点击@智能体 > + 创建智能体

  2. 点击+创建智能体按钮，进入智能体配置面板

  3. 配置智能体：

    • 头像（可选）：上传图片作为智能体头像
    • 名称：输入智能体名称
    • 提示词：输入智能体的提示词（Prompt），用于规范任务方式
    • 工具：配置智能体可调用的工具，包括MCP Server和内置工具

  4. 点击创建按钮

提示词编写指南：提示词通常包含三部分：

  1. 综述任务目标：明确智能体的核心功能
  2. 执行方式要求：规定可使用的工具和方法
  3. 输出要求：指定结果的格式和风格

示例提示词：

plaintext

你是一个专门使用Puppeteer的智能体。
1. 当我说打开、跳转、点击等词时，你就认为是我要调用Puppeteer来操作页面。
2. 使用puppeteer时，launchOptions中设置defaultViewport:null，设置executablePath: '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome'。
3. 不要过度思考，只干我让你干的事。

4. 使用智能体

在AI对话输入框中，输入@或者点击@智能体，然后在智能体列表中选择你想使用的智能体。

5. 管理智能体

  • 修改：自定义智能体的配置
  • 分享：通过Trae IDE将智能体分享至X或复制链接分享
  • 删除：删除自定义智能体

五、MCP工具配置

1. MCP简介

MCP（Model Context Protocol）是模型上下文协议的缩写，为大语言模型接入各类工具及数据源打造了高效、统一的接口，显著拓宽了AI应用的能力范围。Trae内置MCP市场，提供社区热门的MCP Servers，支持快速添加第三方MCP Servers。

2. 常用MCP工具配置

2.1 sequential-thinking

功能：通过结构化思维流程提供动态问题解决工具，将复杂问题分解为步骤，允许修订计划和设计。

配置步骤：

  1. 在MCP市场找到sequential-thinking
  2. 点击+按钮添加
  3. 复制以下配置信息：

json

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    }
  }
}

4. 粘贴到配置框中，点击确认

2.2 Puppeteer

功能：提供浏览器自动化功能，可访问本地文件和IP地址，让LLMs与网页交互，进行截图等操作。

配置步骤：

  1. 在MCP市场找到Puppeteer
  2. 点击+按钮添加
  3. 直接点击确认即可完成配置

提供方法：

  • puppeteer_navigate: 在浏览器中打开指定URL
  • puppeteer_screenshot: 捕获整个页面或特定元素截图
  • puppeteer_click: 点击页面上的指定元素
  • puppeteer_hover: 在页面元素上悬停
  • puppeteer_fill: 在输入字段中填写值
  • puppeteer_select: 选择下拉菜单选项
  • puppeteer_evaluate: 在浏览器控制台执行JavaScript代码
2.3 Notion API

功能：部署Notion API构建研究数据库，允许读取和写入数据、自动化工作流程。

配置步骤：

  1. 在MCP市场找到Notion API
  2. 点击+按钮添加
  3. 复制以下配置信息：

json

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {}
    }
  }
}

4. 粘贴到配置框中，点击确认

3. MCP工具使用示例

使用Puppeteer打开网页：

  1. 创建自定义智能体并添加Puppeteer MCP
  2. 在对话中输入"打开首页"或"跳转到http://localhost:5173/overview/2"
  3. 智能体将调用Puppeteer相关方法执行操作

六、使用案例

1. 股票分析智能体

目标：构建一个能智能回答股票证券知识并快速生成网站的智能体。

步骤：

  1. 创建智能体，命名为"股票智能分析达人王"
  2. 添加所需MCP工具：sequential-thinking、Puppeteer、Notion API
  3. 编写提示词，定义智能体角色和工作流程
  4. 测试智能体功能，输入指令如"帮我分析当前股市行情并生成分析网页"

效果：智能体自动搜索股票数据，生成包含K线图、趋势分析和预测的网页。

2. AI热点新闻生成器

目标：创建一个每日AI热点新闻智能体，通过MCP工具获取新闻并生成网页。

步骤：

  1. 添加trends-hub和hotnews MCP工具
  2. 使用PromptPilot生成优化提示词
  3. 创建智能体并配置提示词和MCP工具
  4. 运行智能体，生成科技感网页展示AI热点新闻

提示词示例：

plaintext

你的任务是制作一个AI热点日报生成智能体。该智能体将通过MCP工具（trends-hub和hotnews）获取当日最新AI热点新闻，并生成一个具有科技感的网页来展示这些新闻。

3. 代码架构设计顾问

目标：构建一个能分析项目架构并提供优化方案的智能体。

步骤：

  1. 创建智能体，命名为"代码架构设计顾问"
  2. 添加sequential-thinking MCP工具
  3. 配置提示词，定义架构分析流程
  4. 上传项目代码，智能体自动分析并生成优化报告

效果：智能体识别架构不足和隐患，提供模块化、性能优化和安全加固建议。

七、高级技巧

1. 上下文引用

通过#符号添加各类上下文：

  • #Code：引用函数/类代码
  • #File：引用整个文件内容
  • #Folder：引用文件夹所有内容
  • #Workspace：引用整个工作空间

2. 多模态输入

上传图片（如设计稿、报错截图），AI会根据图片生成代码或解决问题。

示例：上传Axure原型图，输入"生成对应的React组件"

3. 代码自动补全

在光标位置按回车，AI会根据上下文自动补全代码。输入中文注释如"计算本月工资总额"，按Tab自动补全函数。

4. 版本回退

在Builder模式中，点击对话历史中的"回退"按钮可恢复到之前版本，支持回退最近10轮会话内的版本。

5. 自定义规则

支持配置个人与项目规则：

个人规则：基于个人习惯定制，在所有项目中生效，如：

  • 语言风格：偏好简洁/严谨/幽默表达方式
  • 操作系统：针对Windows或macOS的回答
  • 内容深度：是否需要详细解释、示例或仅需结论

项目规则：对当前项目AI需遵循的规则，如：

  • 代码风格：缩进、命名规范等
  • 语言与框架：优先使用的编程语言或框架
  • API限定：勿使用某些API

八、常见问题

1. 安装问题

**Q: Windows系统安装时提示权限不足？**A: 右键点击安装程序，选择"以管理员身份运行"

**Q: macOS系统无法打开Trae，提示"无法验证开发者"？**A: 按住Control键双击Trae，在弹出的对话框中点击"打开"

2. 使用问题

**Q: 智能体无法调用MCP工具？**A: 检查MCP配置是否正确，确保已安装Node.js环境，尝试重新添加MCP工具

**Q: 生成的代码运行报错？**A: 将错误信息复制到对话窗口，AI会分析原因并提供修复方案

**Q: 如何提高AI生成代码的质量？**A: 提供更详细的需求描述，使用多模态输入（如设计稿），指定编程语言和框架

3. 性能问题

**Q: Trae运行卡顿怎么办？**A: 关闭不必要的插件，增加系统内存，或降低AI模型的参数规模

**Q: 代码生成速度慢？**A: 检查网络连接，切换至性能更优的模型，或拆分复杂需求为多个小任务

九、总结

Trea作为AI原生开发环境，通过智能体和MCP工具生态，为开发者提供了高效的开发体验。无论是代码生成、项目构建还是复杂任务自动化，Trea都能通过自然语言交互简化流程，让开发者专注于核心创新。

通过自定义智能体和MCP工具配置，开发者可以打造专属AI团队，应对不同场景需求。随着Trae不断更新迭代，其AI能力和生态系统将持续完善，为AI编程带来更多可能性。

官方资源：

我的智能体：

image.png

avatar
文章
阅读
粉丝