更新时间:2026-06-04 GMT+08:00
分享

添加上下文

华为云码道(CodeArts)代码智能体支持通过引入上下文信息来提升问答准确性。上下文能帮助智能体更准确地理解您的问题背景与意图,从而提供更贴合实际、更具价值的解答。

当前支持多种上下文类型,包括File(文件)、Folder(文件夹)、Symbol、Git、Terminal(终端)、Problems(报错信息)和Knowledge Bases(知识库)等。所有上下文可自由组合,并与用户输入无缝联动,构建更丰富、更准确的问答场景。

约束与限制

表1 约束与限制

限制类别

具体限制

数量限制

  • 智能体/自定义智能体:一次最多支持添加5个上下文。
  • 智能问答:一次最多支持添加20个上下文。

大小限制

上下文大小不得超过当前所用模型上下文长度的4倍

例如,使用DeepSeek-V3.2模型(上下文长度160K Token)时,如果以File作为上下文,则File文件的大小应控制在640K Token以内(160K × 4)。各模型支持的上下文长度,请参见表2

添加上下文

  1. 参考快速启动操作,登录华为云码道。
  2. 在聊天界面的输入框下方选择内置智能体 > 智能问答,切换到智能问答模式。右侧显示当前选用的模型,您可在下拉框中切换不同大语言模型。

    如果没有正常显示华为云码道的聊天窗口,请在顶部菜单栏的右上方,单击展开AI侧栏图标 ,即可打开华为云码道。

  3. 在输入框中输入“#”,弹出选择窗口后即可添加所需的上下文。

    图1 在输入框添加上下文

  4. 上下文使用示例。

    例如,当您打开一个项目并需要修复登录功能的bug时,华为云码道可根据上下文智能辅助,帮助您更快定位并解决问题,提升开发效率。

    • 添加File:src/auth/login.js,查看登录逻辑。
    • 添加Folder:src/components,查看现有结构。
    • 添加Git:查看最近相关提交,了解变更历史。
    • 添加Problems:查看错误日志,了解具体错误信息。
    • 添加Terminal:测试输出,查看测试失败详情。
    • 添加Rules:安全规范,确保修复符合安全要求。

支持的上下文类型

华为云码道支持多种上下文类型,并可灵活组合使用,用户输入也可以与上下文结合,共同构成完整的需求表达。当前支持的上下文类型包括:File(文件)、Folder(文件夹)、Symbol、Git、Terminal(终端)、Problems(报错信息)和Knowledge Bases(知识库)等,以下将对每种类型进行详细介绍。

上下文压缩

华为云码道提供了一个上下文窗口(如图3),可实时显示本轮对话的上下文使用率(即已使用的Token占比),帮助您直观掌握当前上下文用量,避免因超出限制影响对话的连贯性。

当您围绕同一主题持续深入开发,对话内容不断累积,上下文窗口即将溢出时,您可以通过上下文压缩能力压缩当前对话。华为云码道会自动为您概括上下文,在降低使用成本的同时,提升响应效率。

当您想要讨论一个全新的话题或者开始一个新的任务时,建议您开启一个新的对话。这样可以有效地避免无关历史记录的干扰,使华为云码道能够更准确地理解和响应您的需求。

图3 上下文窗口
表2 上下文压缩规则说明

模式

模型

上下文限制

上下文压缩方式

智能问答

DeepSeek-V3.2

160.0K,单位Token

  • 手动压缩:上下文用量超过10%时,单击“压缩对话”,可以进行手动压缩。
  • 自动压缩:本轮对话加历史对话超过90%时,上下文自动进行压缩。

GLM-5

GLM-5.1

198.0K,单位Token

智能体

自定义智能体

DeepSeek-V3.2

160.0K,单位Token

自动压缩。本轮对话加历史对话超过90%时,上下文自动进行压缩。

GLM-4.7-ArkTS-SPARK

GLM-5

GLM-5.1

198.0K,单位Token

相关文档