常见问题

最近更新时间:2026-05-07 15:19:11

我的收藏

支持哪些文件格式?

工具支持多种文本格式,包括 .txt、.md、.csv、.json、.xml、.html、.htm、.yaml、.yml、.log、.cfg、.ini、.conf、.py、.js、.ts、.java、.c、.cpp、.h、.go、.rs、.rb、.php、.sh、.bash 等常见文本格式。

如何管理向量键?

1. 如果使用文件作为输入,可使用 --filename-as-key参数使用文件名作为向量键;
2. 对于批量写入,可指定--key-prefix参数为向量键添加前缀;
3. 也可使用--key <xxx>参数自定义向量键;
4. 如果没有通过任何方式指定向量键,将自动生成 UUID 作为插入向量的键。

是否支持临时凭证?

支持,通过设置 COS_TOKEN 环境变量即可使用临时安全令牌,关于临时密钥如何生成可参见 临时密钥生成及使用指引

支持哪些 Embedding 提供者?

目前工具支持 openai-compatible 提供者,使用标准的 OpenAI /v1/embeddings API 协议。任何实现了此协议的服务都可以使用,包括 OpenAI、Azure OpenAI 以及 vLLM 或 Ollama 等本地模型服务。

COS URI 格式是什么样的?

COS URI 遵循 cos://bucketname/object-key 格式。对于单个对象,使用完整的键(如 cos://examplebucket-1250000000/docs/file.txt)。对于批量处理,使用带通配符的前缀(如 cos://examplebucket-1250000000/docs/*)。

如何查看详细日志?

执行命令时,可添加 --debug 参数获取详细日志,需要注意的是,--debug 属于全局参数,需放在子命令(如 put、query)之前,而不是命令末尾。对于复杂查询,建议先测试小规模数据。

Windows 下报参数错误?

Windows 下命令行传参对于 “$”以及双引号都有特殊处理,例如检索命令中的 filter 字段,如果发现报 “Error: Invalid --filter JSON: Expecting property name enclosed in double quotes: line 1 column 2 (char 1)” 之类的错误,可以尝试按照下面的格式写:
# PowerShell 控制台:外部单引号,内部双引号转义
cos-vectors-embed ... query ... --filter '{\\"category\\":{\\"$eq\\":\\"travel\\"}}'
# CMD 控制台:外部双引号,内部双引号转义
cos-vectors-embed ... query ... --filter "{\\"category\\":{\\"$eq\\":\\"travel\\"}}"