极狐 GitLab

极狐GitLab Duo Agent Platform 上下文感知

不同的信息可用于帮助极狐GitLab Duo 做出决策并提供建议。

信息可在以下情况下可用:

  • 始终可用。
  • 基于您所在的位置(当您导航时上下文会发生变化)。
  • 在明确引用时。例如,您通过 URL、ID 或文件路径提及该信息。

极狐GitLab Duo Agentic Chat#

以下上下文可供极狐GitLab Duo Agentic Chat 使用。

始终可用#

  • 极狐GitLab 文档。
  • 通用编程知识、最佳实践和语言特性。
  • 您的整个项目及其所有由 Git 跟踪的文件。
  • 极狐GitLab 搜索 API,Chat 使用它来查找相关议题或合并请求。
  • 在极狐GitLab UI 中使用 Chat 时,当前页面标题和 URL。

Chat 会自动从 SDLC 数据、GitLab Orbit、MCP 客户端和自定义指令中查找必要的上下文。

基于位置#

  • 在您的 IDE 中,您已打开的文件。如果您不希望这些文件被用作上下文,可以关闭它们。
  • 在极狐GitLab UI 中,当前页面上下文(例如,查看合并请求或议题时)。

在明确引用时#

极狐GitLab Duo Agentic Chat 可以自主检索并使用:

  • 文件,包括图片(PNG、JPEG、WebP):当您在 IDE 中使用 Chat 时,可通过搜索您的项目或提供文件路径来使用这些文件
  • 项目中附加到议题和合并请求的图片,当您在 IDE 中使用 Chat 并按 Markdown 中的形式提供上传引用时
  • 史诗
  • 议题
  • 合并请求
  • CI/CD 流水线和作业日志
  • 提交
  • 工作项

与 Non-Agentic Chat 不同,Agentic Chat 无需您指定确切的 ID 或 URL 即可搜索这些资源。例如,您可以问“查找关于身份验证的合并请求”,Chat 会搜索相关的合并请求。

有关图片要求,请参阅图片要求。

扩展上下文#

软件开发任务流#

以下上下文可供极狐GitLab Duo Agent Platform 中的软件开发任务流使用。

始终可用#

  • 通用编程知识、最佳实践和语言特性。
  • 您的整个项目及其所有由 Git 跟踪的文件。
  • 极狐GitLab 搜索 API,用于查找相关议题或合并请求。

基于位置#

  • 您在 IDE 中打开的文件(如果您不希望这些文件被用作上下文,请关闭它们)。

在明确引用时#

  • 文件,包括图片(PNG、JPEG、WebP)
  • 项目中附加到议题和合并请求的图片
  • 史诗
  • 议题
  • 合并请求
  • 合并请求的流水线

从极狐GitLab Duo 中排除上下文#

Tier: 专业版,旗舰版

您可以控制哪些项目内容被排除在极狐GitLab Duo 的上下文之外。使用此功能可减少敏感信息(如密码和配置文件)的暴露。

上下文排除项专为代码建议和 Chat 上下文设计,在这些场景中极狐GitLab Duo 控制读取哪些文件。对于这些功能,被排除的文件不会用作上下文。

当 Agent 运行时,排除项仅尽力而为。例如:

  • 排除项不适用于 shell 命令。
  • grep 工具可能返回被排除文件的内容。
  • 在不区分大小写的文件系统上(如 Windows 和 macOS 的默认设置),大小写不同的路径可能无法匹配排除项。

有关极狐GitLab MCP 服务器特有的限制,请参阅已知问题。

管理极狐GitLab Duo 上下文排除项#

要指定极狐GitLab Duo 排除的内容:

  1. 在顶部栏中,选择搜索或跳转到并找到您的项目。
  2. 在左侧边栏中,选择设置 > 通用。
  3. 在极狐GitLab Duo 下,在极狐GitLab Duo 上下文排除项部分中,选择管理排除项。
  4. 指定哪些项目文件和目录被排除在极狐GitLab Duo 上下文之外,然后选择保存排除项。
  5. 可选。要删除现有排除项,请为相应的排除项选择删除()。
  6. 选择保存更改。

已知问题#

以下是极狐GitLab MCP 服务器中上下文排除项的已知问题:

  • get_merge_request 工具可能返回包含 被排除文件内容的提交差异。 极狐GitLab MCP 服务器在获取差异时不会检查排除项。
  • add_commit 工具具有 move 操作,该操作 会将文件从一个路径复制到另一个路径。如果源文件被排除,则不会对源路径 应用排除检查。具有推送权限的 Agent 可以将被排除的文件移动到未排除的路径,然后读取其内容。

这些已知问题记录在议题 628141中。为确保敏感信息得到保护,请审查授予访问敏感项目的 MCP 客户端的工具和权限。