极狐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 会搜索相关的合并请求。
有关图片要求,请参阅图片要求。
扩展上下文
- 要将 Chat 连接到外部数据源和工具,请使用模型上下文协议(MCP)。
- 要提供项目特定的上下文、编码标准和团队实践, 请在 Chat、Agent 和任务流中使用自定义规则或 AGENTS.md。
软件开发任务流
以下上下文可供极狐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 排除的内容:
- 在顶部栏中,选择搜索或跳转到并找到您的项目。
- 在左侧边栏中,选择设置 > 通用。
- 在极狐GitLab Duo 下,在极狐GitLab Duo 上下文排除项部分中,选择管理排除项。
- 指定哪些项目文件和目录被排除在极狐GitLab Duo 上下文之外,然后选择保存排除项。
- 可选。要删除现有排除项,请为相应的排除项选择删除()。
- 选择保存更改。
已知问题
以下是极狐GitLab MCP 服务器中上下文排除项的已知问题:
- get_merge_request 工具可能返回包含 被排除文件内容的提交差异。 极狐GitLab MCP 服务器在获取差异时不会检查排除项。
- add_commit 工具具有 move 操作,该操作 会将文件从一个路径复制到另一个路径。如果源文件被排除,则不会对源路径 应用排除检查。具有推送权限的 Agent 可以将被排除的文件移动到未排除的路径,然后读取其内容。
这些已知问题记录在议题 628141中。为确保敏感信息得到保护,请审查授予访问敏感项目的 MCP 客户端的工具和权限。