agentuity-cli-cloud-vector-upsertSkill agentuity-cli-cloud-vector-upsert

---

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 products doc1 --document "舒适的办公椅"

带元数据更新：

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

使用预计算嵌入向量更新：

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

从JSON文件批量更新：

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

从标准输入批量更新：

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

输出

返回JSON对象：

{
  "success": "boolean",
  "namespace": "string",
  "count": "number",
  "results": "array",
  "durationMs": "number"
}

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