glob-文件模式匹配--向量数据库VikingDB-火山引擎

文档中心

向量数据库VikingDB

请输入

检索（Retrival）

glob-文件模式匹配

概述

/api/v1/search/glob 接口用于根据 Glob 模式在指定 URI 范围内匹配文件。
它适用于按路径规则筛选文件，例如查找某个目录下所有 Markdown、Python 或配置文件。

前置条件

完成 API 鉴权说明页面的 API Key 获取后，可调用本接口执行文件模式匹配。

请求接口

URI

/api/v1/search/glob
统一资源标识符。

请求方法

POST
客户端对服务器请求的操作类型。

请求头

参数	值	说明
Content-Type	`application/json`	请求消息类型
Authorization	`Bearer {api_key}`	鉴权
X-OpenViking-Agent	`{agent_id}`	Agent ID

请求参数

参数	类型	必选	默认值	备注
pattern	string	是	--	Glob 匹配模式，例如 `*/.md`
uri	string	否	`viking://`	起始 URI
node_limit	int	否	--	最大返回匹配数

响应消息

字段	参数说明
status	请求状态，成功为 `"ok"`，失败为 `"error"`
result	成功时返回的数据对象
result.matches	命中的文件 URI 列表
result.count	命中总数
error	失败时返回的错误对象
error.code	错误码字符串
error.message	可读的错误描述

常见错误码

error.code	说明
UNAUTHENTICATED	缺少 API Key 或 API Key 无效
PERMISSION_DENIED	API Key 权限不足
INVALID_ARGUMENT	`pattern` 非法
NOT_FOUND	指定 `uri` 不存在

完整示例

curl -X POST `https://xxx/api/v1/search/glob` \
  -H "Authorization: Bearer {api_key}" \
  -H "X-OpenViking-Agent: {agent_id}" \
  -H "Content-Type: application/json" \
  -d '{
    "pattern": "**/*.md",
    "uri": "viking://resources/"
  }'

执行成功返回：

{
  "status": "ok",
  "result": {
    "matches": [
      "viking://resources/docs/api.md",
      "viking://resources/docs/guide.md"
    ],
    "count": 2
  }
}

最近更新时间：2026.05.26 11:19:28

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

概述 #

前置条件 #

请求接口 #

URI #

请求方法 #

请求头 #

请求参数 #

响应消息 #

常见错误码 #

完整示例 #

概述