上下文
CodeArts代码智能体支持通过引入上下文信息来提升问答准确性。上下文能帮助智能体更准确地理解您的问题背景与意图，从而提供更贴合实际、更具价值的解答。
当前支持多种上下文来源，包括File（文件）、Folder（文件夹）、Symbol、Git、Terminal（终端）、Problems（报错信息）和Knowledge Bases（知识库）等。所有上下文可自由组合，并与用户输入无缝联动，构建更丰富、更准确的问答场景。
使用上下文存在哪些约束与限制
- 智能体一次最多支持添加5个上下文。
- 智能问答一次最多支持添加20个上下文。
- UT智能体一次最多支持添加1个上下文。
- JetBrains系列IDE 25.2版本默认会启用2025重制版（Reworked 2025）终端引擎，2025重制版终端引擎会导致引用Terminal异常，无法正常获取到终端输出。请先将终端引擎切回经典（Classic）模式。
- 在IntelliJ IDEA工具栏的左下方，单击
图标，打开终端。 - 单击终端右上角的
图标，选择“终端引擎 > 经典”，将终端引擎设置为“经典”。
- 在IntelliJ IDEA工具栏的左下方，单击
如何添加上下文
- 参考安装并登录操作，登录CodeArts代码智能体。
- 打开CodeArts代码智能体聊天窗口。
- CodeArts代码智能体IDE：单击IDE顶部菜单栏中的切换辅助侧栏图标
，打开CodeArts代码智能体聊天窗口。 - Visual Studio Code：单击Visual Studio Code侧边栏图标
，打开CodeArts代码智能体聊天窗口。 - JetBrains：以IntelliJ IDEA为例，单击IntelliJ IDEA侧边栏图标
，打开CodeArts代码智能体聊天窗口。
不同工具中CodeArts代码智能体的界面风格有所差异，本章以其在IDE工具中的界面为例进行介绍，实际操作请以所用工具的显示为准。
- CodeArts代码智能体IDE：单击IDE顶部菜单栏中的切换辅助侧栏图标
- 如下图所示，以CodeArts代码智能体IDE为例，当您在聊天界面的输入框中，单击“添加上下文”或输入“#”，弹出选择窗口后即可添加所需的上下文。
图1 在聊天界面的输入框添加上下文
如果您使用的是JetBrains系列开发工具（如IntelliJ IDEA），还支持在代码编码区单击右键选择“CodeArts代码智能体：编辑区对话”。随后在输入框中输入“#”，触发上下文添加窗口。
图2 在代码编辑区添加上下文
- 上下文使用示例。
例如，当您打开一个项目并需要修复登录功能的bug时，CodeArts代码智能体可根据上下文智能辅助，帮助您更快定位并解决问题，提升开发效率。
- 添加File：src/auth/login.js，查看登录逻辑。
- 添加Folder：src/components，查看现有结构。
- 添加Git：查看最近相关提交，了解变更历史。
- 添加Problems：查看错误日志，了解具体错误信息。
- 添加Terminal：测试输出，查看测试失败详情。
- 添加Rules：安全规范，确保修复符合安全要求。
支持的上下文类型
代码智能体支持多种上下文类型，并可灵活组合使用，用户输入也可以与上下文结合，共同构成完整的需求表达。当前支持的上下文类型包括：File（文件）、Folder（文件夹）、Symbol、Git、Terminal（终端）、Problems（报错信息）和Knowledge Bases（知识库）等，以下将对每种类型进行详细介绍。
Symbol
通过Symbol，引用函数、类、变量等代码符号作为上下文。
例如，在CodeArts代码智能体聊天窗口的输入框中，单击“添加上下文”，选择“Symbol”并从列表中选择需要引用的函数、类和变量等。
CodeArts代码智能体切换为智能体或UT智能体模式时，不支持添加Symbol类型的上下文。
Git
通过Git，可以对提交到代码仓库中的代码变更内容进行高效分析，帮助开发者轻松查看每次代码变更，清晰掌握项目演进和质量趋势。
例如，在CodeArts代码智能体聊天窗口的输入框中，单击“添加上下文”，选择“Git”，选择对应的commit代码，然后输入对应的问题进行提问。
如果您使用的是JetBrains系列开发工具（如IntelliJ IDEA），模型选择UT智能体时，不支持添加Git类型的上下文。
Knowledge Bases
通过Knowledge Bases，对整体知识体系进行提问，从而提升代码生成和研发领域问答场景的能力。使用Knowledge Bases前需要提前创建好知识库，具体操作请参见知识库集合。
例如，在CodeArts代码智能体聊天窗口的输入框中，单击“添加上下文”，选择“Knowledge Bases”，然后从已创建的知识库集合中，选择您需要的知识库和知识集。
CodeArts代码智能体切换为智能体模式时，不支持添加Knowledge Bases类型的上下文。
Rules
CodeArts代码智能体切换为智能体模式时，才支持创建Rules。
通过自定义规则（Rules），可以帮助AI更好地理解代码库结构并遵循项目规范。这些规则可由智能体自动加载或调用，并能与代码库保持同步，确保一致性与准确性。
- 在聊天窗口的输入框中，单击
，选择“智能体”。
图3 切换到智能体模型
- 创建Rules。
- 在聊天窗口的输入框中，单击“添加上下文”，打开上下文选择窗口。
除了通过添加上下文来创建规则外，您还可以在CodeArts代码智能体的聊天界面中，单击右上角的设置图标
，快速进入规则配置页面，轻松创建您的专属规则。 - 在上下文列表中单击“Rules”，再单击“新建Rule”，进入新建规则页面。
- 输入新建规则的名称并选择生效场景（自动应用和手动触发），单击“确定”，完成规则的创建。
图4 新建Rule
- 自动应用：默认对所有会话（包括CodeArts代码智能体编辑区）生效，无需重复设置，如图5。
- 手动触发：在对话中输入“#”或单击“添加上下文”，然后选择已创建的规则，规则才能生效。
图6 添加上下文选择规则
图7 规则在当前对话中生效
- 在聊天窗口的输入框中，单击“添加上下文”，打开上下文选择窗口。
- 定义具体的Rules，让智能体在特定条件下自动做出一致、可预测的响应或行为。
- 使用Rules。
在聊天界面的输入框中，输入如下内容，单击
图标。等待游戏构建成功后，可发现脚本中函数和类已添加注释，如图10。用Java开发一个贪吃蛇小游戏
将编辑器的内容作为上下文
在CodeArts代码智能体中编辑代码文件时，CodeArts代码智能体默认能够查看到当前文件。您可以直接向CodeArts代码智能体提问与当前文件相关的问题。例如，对文件中的某一段代码进行提问。
在代码编辑器中，选中对应的代码。单击右键选择“CodeArts代码智能体：将代码添加到聊天窗”，将选中的内容作为上下文添加到研发问答的聊天框中。
上下文压缩
CodeArts代码智能体提供了一个上下文窗口（如图12），用于实时显示对话中已使用的Token占比，帮助您实时查看当前会话的上下文用量，避免超出限制影响对话的连贯性。
当您围绕同一主题持续深入开发，对话内容不断累积，上下文窗口即将溢出时，您可以通过上下文压缩能力压缩当前会话。CodeArts代码智能体会自动为您概括上下文，在降低使用成本的同时，提升响应效率。
当您想要讨论一个全新的话题或者开始一个新的任务时，建议您开启一个新的会话。这样可以有效地避免无关历史记录的干扰，使CodeArts代码智能体能够更准确地理解和响应您的需求。
|
模式 |
模型 |
上下文限制 |
上下文压缩方式 |
|---|---|---|---|
|
智能问答 |
DeepSeek-V3.2 |
160.0K，单位Token |
|
|
GLM-4.7 |
198.0K，单位Token |
||
|
智能体 |
DeepSeek-V3.2 |
128.0K，单位Token |
自动压缩 |
|
GLM-4.7 |
192.0K，单位Token |
