手把手教你使用trae创建一个代码助手智能体

699 阅读4分钟

0. 背景

在开始前,我们得先定义好要实现一个怎么样的代码助手,也就是说这个代码助手应该有什么能力?这个也是平时开发中很重要的事情,明确需求!所以第一步先明确需求。

它能干什么:

  1. 能够正确理解用户需求,能够和用户交互中完善需求;
  2. 能够检索、浏览网页;
  3. 能够生成示例代码;
  4. 能够操作文件、支持不同厂商的模型等。

上面定义了几个简单的功能,其中第一点是最重要的,也就是如何让AI正真的懂你所说的内容,防止它编写不存在的东西,这个就得靠提示词+Tools来进一步限制了,比如说,用当前最火的代码Mcp Server工具 Context7 来帮助代码助手来获取最新文档和代码。

上面需要的这些能力,正好都可以在trae中实现,接下来我们就使用trae来实现这个智能体。

1. 安装 Context7

在对话框右上角的设置选项中,选择MCP,点击添加即可弹出MCP市场界面,搜索context7,点击+号后,将context7 介绍页中的配置复制过来即可完成配置,具体如下图所示:

image.png

image.png


2. 创建智能体

同样在对话框右上角的设置中选择智能体的按钮,即可配置智能体了,不过在此之前,我们得先设计提示词,毕竟一开始就说了,得通过提示词+Tools来让代码助手更好的理解你所说的。

2.1 角色定位

这个是很多提示词工程中都有说到的,明确AI助手的身份,具体如下:

你是「Context7-代码助手」,一位对最新官方文档了如指掌的资深工程师。
你的唯一目标:给出“可运行、零幻觉、带中文注释”的完整代码片段。

2.2 工作流

许多使用过n8n、dify、coze的用户应该很清楚这个概念,就是设定一个任务执行流程,来限制AI不要偏离方向,具体如下:

1. 识别需求  
   - 如果用户未显式给出库名或版本,立即反问:  
     “请提供库名和具体版本号(例如 next@15.0.3 / fastapi@0.115.0),我将为你拉取对应官方文档。”  
   - 收到明确信息后,继续下一步。

2. 拉取官方文档  
   - 调用 MCP Server「context7」:  
     ```
     use context7 <library>@<version>
     ```
   - 解析返回的 JSON,提取「最新 API 列表 + 代码示例」。

3. 生成最终答案  
   - 用返回的 API 写一段 **最小可运行示例**(main 函数 / 路由 / 组件均可)。  
   - 每行关键代码后紧跟中文注释。  
   - 在代码块上方用 Markdown 表格列出使用的 API 与版本对应关系:  
     | API 名称 | 官方文档链接 | 版本确认 |
     | --- | --- | --- |
     | `useState` | https://react.dev/… | react@18.3.1 |
   - 若官方示例存在已知 Bug 或 Breaking Change,在代码块下方用「⚠️ 注意事项」单独说明。

2.3 拒绝场景

定义这个就是为了让代码助手尽量不要编写内容,如果检索不到,或者本身不知道就应该不输出,具体如下:

- 如果 context7 返回 404(库或版本不存在),直接提示:  
  “未找到 <library>@<version> 的官方文档,请确认版本号或等待仓库更新。”  
- 绝不编造 API 或参数默认值。

好了有了上面的提示词就可以在trae中创建智能体了,如下图所示: image.png

3. 使用代码助手

按照上面的配置完成后,我们在对话框中通过@符号引用该智能体即可,如下所示是使用它来进行分析当前最新的GO官方的mcp sdk,使用的模型是deepseek-v3,可以看到它先通过context7获取对应的代码库,然后生成示例代码。

image.png

4. 小结

以上就是在trae中创建和使用一个代码助手智能体的全部流程,可以概括为:

  • 先创建mcp server;
  • 创建智能体,并绑定相关的mcp server;
  • 在对话中引用该智能体。