---

name: agentuity-cli-cloud-vector-upsert description: 在向量存储中添加或更新向量。需要身份验证。用于Agentuity云平台操作 version: “0.0.103” license: Apache-2.0 allowed-tools: “Bash(agentuity:*)” argument-hint: “<命名空间> [键]” metadata: command: “agentuity cloud vector upsert” tags: “mutating updates-resource slow requires-auth”

云向量增改

在向量存储中添加或更新向量

前提条件

• 已通过 agentuity auth login 进行身份验证
• 需要项目上下文（从项目目录运行或使用 --project-id）

使用方法

agentuity cloud vector upsert <命名空间> [键] [选项]

参数

参数	类型	必填	描述
<命名空间>	字符串	是	-
<键>	字符串	否	-

选项

选项	类型	必填	默认值	描述
--document	字符串	是	-	要嵌入的文档文本
--embeddings	字符串	是	-	预计算的嵌入向量，格式为JSON数组
--metadata	字符串	是	-	元数据，格式为JSON对象
--file	字符串	是	-	包含向量的JSON文件路径，或使用"-"表示从标准输入读取

示例

使用文档文本增改单个向量：

bunx @agentuity/cli vector upsert 产品 doc1 --document "舒适的办公椅"

带元数据的增改：

bunx @agentuity/cli vector upsert 产品 doc1 --document "椅子" --metadata '{"category":"家具"}'

使用预计算嵌入向量的增改：

bunx @agentuity/cli vector upsert 嵌入向量 vec1 --embeddings "[0.1, 0.2, 0.3]"

从JSON文件批量增改：

bunx @agentuity/cli vector upsert 产品 --file vectors.json

从标准输入批量增改：

cat vectors.json | bunx @agentuity/cli vector upsert 产品 -

输出

返回JSON对象：

{
  "success": "布尔值",
  "namespace": "字符串",
  "count": "数字",
  "results": "数组",
  "durationMs": "数字"
}

字段	类型	描述
success	布尔值	操作是否成功
namespace	字符串	命名空间名称
count	数字	增改的向量数量
results	数组	增改结果，包含键到ID的映射关系
durationMs	数字	操作持续时间（毫秒）