GitLab Orbit 查询
Tier: 专业版,旗舰版
Offering: JihuLab.com,私有化部署
查询会向图谱提出一个明确的问题,并返回精确的行,其中只包含您有权访问的数据。您的 Agent 会为您编写查询。对于脚本、计划报告和自定义工具,您可以自行编写查询。 查询使用 GitLab Orbit 查询语言。
运行查询
将查询文本传递给 GitLab Orbit CLI:
shellglab 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。有关完整列表,请参阅在查询时解析的属性。