极狐 GitLab

GitLab Orbit 查询

Tier: 专业版,旗舰版

Offering: JihuLab.com,私有化部署

查询会向图谱提出一个明确的问题,并返回精确的行,其中只包含您有权访问的数据。您的 Agent 会为您编写查询。对于脚本、计划报告和自定义工具,您可以自行编写查询。 查询使用 GitLab Orbit 查询语言。

运行查询#

将查询文本传递给 GitLab Orbit CLI:

shell
glab orbit query "MATCH (p:Project {full_path: '<my-group/my-project>'}) RETURN p.name, p.full_path LIMIT 1"

将 <my-group/my-project> 替换为您项目的完整路径。

CLI 会输出紧凑的 TOON 文本。如需 JSON,请添加 --response-format raw。模型上下文协议(MCP)端点上的 Agent 会通过 query_graph 工具发送相同的文本。

使用 GitLab Orbit API#

在脚本、计划报告或自定义工具中,将相同的查询文本发送到极狐GitLab REST API。使用个人访问令牌进行身份验证,或使用服务账号进行无需个人账号的自动化操作。结果仅包含令牌所有者有权访问的数据。

  • 有关端点、参数和示例,请参阅 GitLab Orbit API。
  • 有关 GraphQL API 中的 GitLab Orbit 数据,例如已开启 GitLab Orbit 的群组和 schema, 请参阅 Query.orbit。 Query.orbit 是一项实验。

速率限制#

默认情况下,每个用户每分钟可以向 GitLab Orbit 发送 60 个查询。 CLI、API、MCP 客户端和极狐GitLab Duo Agent Platform 共享此限制。 在极狐GitLab 私有化部署上,管理员可以更改该限制。

当您超出限制时,极狐GitLab 会返回 429 Too Many Requests 以及 Retry-After 响应头,CLI 会以退出码 5 退出。请等待 Retry-After 响应头中指定的时间,然后重试。

查询形态#

使用场景查询形态
获取某一类型的节点MATCH (n:Label {property: value}) RETURN n
沿节点类型之间的关系进行遍历MATCH (a:Label {id: 1})-[:RELATIONSHIP]->(b:Label) RETURN a, b
按分组键对结果进行计数、求和或求平均值RETURN key, count(n) AS total ORDER BY total DESC
查找两个有界节点之间的路径MATCH path = ANY SHORTEST (a:Label {id: 1})-[:RELATIONSHIP*1..3]->(b:Label {id: 2}) RETURN path
查找与某个有界节点相连的内容MATCH (a:Label {id: 1})--(n) RETURN n

要进行搜索,请使用 WHERE 过滤某一节点类型,例如使用 CONTAINS 或 all_tokens。有关语法,请参阅过滤器。

每个查询至少需要一个通过 ID 或字面量属性过滤器限定的节点。这些查询形态使用数字 ID。要查找合并请求或项目的 ID,请参阅有界节点。

要读取源文本或差异,请返回 GitLab Orbit 在查询时从代码仓库获取的属性,例如 File.content、Definition.content 或 MergeRequest.diff。有关完整列表,请参阅在查询时解析的属性。