Trae 上下文：提升 AI 助手响应精准度的三种方法

与 AI 助手对话时，你可以指定上下文供 AI 助手阅读和理解，使 AI 助手的答复更精准。

将编辑器内的内容作为上下文

当你的编辑器中存在正在编辑的代码文件时，AI 助手默认能够看到当前文件。你可以直接向 AI 助手提问与当前文件相关的问题。若期望对文件中的某一段代码进行提问，使用以下步骤：

选中代码。
点击悬浮菜单中的 添加到对话 按钮，将选中的内容作为上下文添加至侧边对话框。

指定的上下文会显示在侧边对话底部的输入框。以下图为例，输入框内显示所选内容所属的文件名称，以及所选的代码行编号。
(可选) 继续添加编辑器中的其他内容片段，或同时添加其他来源的上下文。

将终端中的内容作为上下文

若你希望对终端中的输出内容进行提问（如帮助你修复报错），使用以下步骤：

在终端中，点击输出内容片段。
在内容片段区域的右上角，点击 添加到对话 按钮，将选中的内容作为上下文添加至侧边对话框。

指定的上下文会显示在侧边对话底部的输入框。以下图为例，输入框内显示上下文的来源以及行号。
(可选) 继续添加终端中的其他内容片段，或同时添加其他来源的上下文。

使用 # 键添加上下文

在侧边对话的输入框中，你可以通过 # 符号添加多种类的上下文，包括代码、文件、文件夹和工作区。通常情况下，列表中将展示与编辑器中当前打开文件相关的内容作为推荐的上下文，但你仍然可以自行搜索所需的上下文并将其添加到输入框中。基于你的问题，你可以组合添加各种来源的相关上下文（例如同时添加代码和文件）。

Code

通过 #Code，你可以将函数或类的相关代码作为与 AI 助手对话的上下文。列表中默认展示当前编辑器内打开的文件中的函数或类。选择前，你可以预览列表中推荐的函数或类的相关代码。若推荐的内容非你所需，你可以通过关键词搜索所需的函数或类。

提示
若 Trae 中不存在对应语言的语言服务协议（Language Server Protocol），请提前安装，否则可能导致无法识别代码符号。

在输入框中输入 #，或直接点击输入框左下角的 # 上下文 按钮。

输入框上方显示上下文类型选择列表。
在列表中选择 Code（或在 # 符号后手动输入 Code），然后按下回车键。

列表将展示编辑器中当前打开的文件中存在的函数和类。将鼠标悬浮在列表中的某个条目后，左侧会展示该函数或类的代码内容，供你预览。
若推荐的函数和类非你所需，在 #Code: 后输入你想要的函数或类的名称或关键词。

AI 助手将在项目内搜索相关函数和类，并展示在列表中，你可以进行预览。
从列表中选择需指定为上下文的函数或类。

File

通过 #File，你可以将指定文件中的所有内容作为与 AI 助手对话的上下文。列表中默认展示近期在编辑器中打开过的文件。你可以预览这些文件所在的目录，以免因存在同名文件而导致错选。若展示的文件非你所需，你可以通过关键词搜索所需文件。

在输入框中输入 #，或直接点击输入框左下角的 # 上下文 按钮。

输入框上方显示上下文类型选择列表。
在列表中选择 File（或在 # 符号后手动输入 File），然后按下回车键。

列表展示近期在编辑器中打开过的文件。将鼠标悬浮在列表中的某个条目后，左侧会展示该文件所在的目录。
若推荐的文件非你所需，在 #File: 后输入你想要的文件的名称或关键词。

AI 助手将在项目内搜索相关文件并展示在列表中。
从列表中选择需指定为上下文的文件。

Folder

通过 #Folder，你可以将指定文件夹中的所有内容作为与 AI 助手对话的上下文。列表中默认展示与编辑器中当前所打开文件相关的文件夹。你可以预览这些文件夹所在的目录，以免因存在同名文件夹而导致错选。若展示的文件夹非你所需，你可以通过关键词搜索所需文件夹。

提示
#Folder 依赖项目代码索引（Project Code Index）是否构建完全。若索引暂未构建完全，可能会影响文件夹内容召回的效果，从而导致 AI 助手的回答不够完整。提问时，若索引从未构建或正在构建中，References 位置将出现 “索引构建中” 或 “索引暂未构建” 的提示，你可以根据引导在设置页管理索引。详情参考《AI 设置》。

在输入框中输入 #，或直接点击输入框左下角的 # 上下文 按钮。

输入框上方显示上下文类型选择列表。
在列表中选择 Folder（或在 # 符号后手动输入 Folder），然后按下回车键。

列表展示与编辑器中当前所打开文件相关的文件夹。将鼠标悬浮在列表中的某个条目后，左侧会展示该文件夹所在的目录。
若推荐的文件夹非你所需，在 #Folder: 后输入你想要的文件夹的名称或关键词。

AI 助手将在项目内搜索相关文件夹并展示在列表中。
从列表中选择需指定为上下文的文件夹。

Workspace

你可以使用 #Workspace 来向 AI 助手提出有关整个工作空间的问题，AI 助手将自动在工作空间中查找与你的问题最相关的内容作为上下文进行回答。遇到不熟悉的项目时，该功能可以帮助你全局了解该项目所实现的功能和代码，从而使你快速上手该项目的开发。

提示
- 仅支持在 Chat 模式中使用。Builder 模式会自动将整个工作空间作为上下文。
- #Workspace 依赖项目代码索引（Project Code Index）是否构建完全。若索引暂未构建完全，可能会影响文件夹内容召回的效果，从而导致 AI 助手的回答不够完整。提问时，若索引从未构建或正在构建中，References 位置将出现 “索引构建中” 或 “索引暂未构建” 的提示，你可以根据引导在设置页管理索引。详情参考《AI 设置》。

在输入框中输入 #，或直接点击输入框左下角的 # 上下文 按钮。

输入框上方显示上下文类型选择列表。
在列表中选择 Workspace（或在 # 符号后手动输入 Workspace）。

Doc

你可以上传个人文档集，将文档内容作为 AI 对话的上下文，让 AI 更精准地处理你的需求。

提示
创建文档集时，Trae 将针对文档集内容构建索引，在索引过程中文档数据将被传输至 Trae 服务器进行矢量化，但 Trae 不会读取或存储任何文档数据，矢量化完成后文档数据和矢量数据都将从 Trae 的服务器中删除，数据将返回至用户的设备并存储在用户本地。在 Trae 中删除文档集后，本地数据也将被同步删除。

创建文档集并将其引用为上下文的步骤如下：

在 AI 对话窗口的右上角，点击设置图标 > 上下文，或在 AI 对话输入框中点击 # 上下文 > Doc > 添加文档集。

界面上显示 上下文 窗口。
在 文档集 部分，点击 + 添加文档集 按钮。

选择合适的方式添加文档集。

通过 URL 添加从本地文件添加

在菜单中选择通过 URL 添加选项，然后在弹窗中输入文档集名称和文档站的 URL。

点击确认按钮后，Trae IDE 开始索引站点下的网页。以该入口 URL 为起点，Trae IDE 会自动抓取同一站点中与入口 URL 同级路径或子路径下，最多三次跳转内的页面内容。若入口 URL 为 https://www.example.com/docs/api，则：
● 可抓取内容的路径示例如下：
○ https://www.example.com/docs/changelog（同级路径）
○ https://www.example.com/docs/api/abc（子路径）
○ https://www.example.com/docs/protocol/def（同级路径的子路径）
● 不可抓取内容路径示例如下：
○ https://www.anotherexample.com（不同 Host）
○ https://www.example.com/（高于入口路径）
○ https://www.example.com/blogs（不属于同一路径） <br>
>注意
>在使用本工具时，应遵循目标网址的规则，合法合规使用本工具。本工具仅支持查看公开可访问的技术文档类网站，用于学习、研究的目的，感谢你的理解与配合。
>Trae IDE 在扫描页面时将会严格遵循网页的 /robots.txt 规范，若被网站拒绝则无法正常索引，索引页面列表中将展示 “网站限制无法访问”。在菜单中选择 从本地文件添加 选项，然后在弹窗中输入文档集名称并添加本地文件。
● 文件格式：.md 和 .txt
● 文件大小：单个文件最大 10 MB
● 文档集大小：最大 50 MB
● 文件数量：不超过 1000 个

点击确认按钮后，Trae IDE 开始索引文件。

通过 URL 添加	从本地文件添加
在菜单中选择通过 URL 添加选项，然后在弹窗中输入文档集名称和文档站的 URL。点击确认按钮后，Trae IDE 开始索引站点下的网页。以该入口 URL 为起点，Trae IDE 会自动抓取同一站点中与入口 URL 同级路径或子路径下，最多三次跳转内的页面内容。若入口 URL 为 `https://www.example.com/docs/api`，则： ● 可抓取内容的路径示例如下： ○ `https://www.example.com/docs/changelog`（同级路径） ○ `https://www.example.com/docs/api/abc`（子路径） ○ `https://www.example.com/docs/protocol/def`（同级路径的子路径） ● 不可抓取内容路径示例如下： ○ `https://www.anotherexample.com`（不同 Host） ○ `https://www.example.com/`（高于入口路径） ○ `https://www.example.com/blogs`（不属于同一路径） <br> >注意 >在使用本工具时，应遵循目标网址的规则，合法合规使用本工具。本工具仅支持查看公开可访问的技术文档类网站，用于学习、研究的目的，感谢你的理解与配合。 >Trae IDE 在扫描页面时将会严格遵循网页的 /robots.txt 规范，若被网站拒绝则无法正常索引，索引页面列表中将展示 “网站限制无法访问”。	在菜单中选择从本地文件添加选项，然后在弹窗中输入文档集名称并添加本地文件。 ● 文件格式：`.md` 和 `.txt` ● 文件大小：单个文件最大 10 MB ● 文档集大小：最大 50 MB ● 文件数量：不超过 1000 个点击确认按钮后，Trae IDE 开始索引文件。

文档添加完成后，将被展示在文档集列表中。你可以按需修改文档集名称、重新索引页面或文件、删除文档集。

在 AI 对话输入框中，引用你添加的文档集作为上下文。

Web

你可以将线上网站的内容作为 AI 对话的上下文。

直接在 #Web 后输入你的问题并发送。这种方式会触发联网搜索，Trae AI 会在全网搜索与提问相关的内容并生成答复。
在输入框中先输入网址，再输入问题，Trae AI 会直接从该网站查询相关内容并生成回答。这种方式不仅能获取网站的最新信息作为问答依据，还能同时从多个网站检索与问题最相关的内容。

管理代码索引

Trae AI 可以为项目构建索引。构建索引后，用户通过 #Workspace 或 #Folder 方式与 AI 助手对话时，AI 助手能够理解用户当前打开的项目并使用整个项目作为上下文进行回答，从而提供更加精准的回答。

若未构建索引或索引构建不完全，在使用 #Workspace 或 #Folder 方式与 AI 助手对话时，可能会导致无法召回完整的上下文，进一步导致回答不完整。此时，AI回答处将出现 “索引建构中” 或 “索引暂未建构” 的提示。

在 AI 对话框右上角，点击设置图标 > 上下文，然后在 代码索引管理 部分管理索引构建的状态和产物。相关操作如下：

操作	说明
开始索引	● 针对文件数量小于等于 5000 的项目，Trae 将在打开项目时自动构建代码索引。 ● 若项目内的文件数大于 5000 且你期望项目级的回答更准确，此时可以点击开始构建按钮，为当前项目构建代码索引。
停止索引	若代码索引构建过程中出现了异常情况，你期望停止构建，则可以点击取消构建按钮，本地索引构建将被暂停。
重新构建	若你期望重启构建，则可以点击重新构建按钮，继续上一次的构建。
删除索引	若你期望清空代码索引，则可以点击清空按钮。