Agentuity云向量增改工具Skill 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: “<namespace> [key]” metadata: command: “agentuity cloud vector upsert” tags: “mutating updates-resource slow requires-auth”

云向量增改

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

前提条件

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

用法

agentuity cloud vector upsert <namespace> [key] [options]

参数

参数	类型	必填	描述
<namespace>	字符串	是	-
<key>	字符串	否	-

选项

选项	类型	必填	默认值	描述
--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	数字	操作持续时间（毫秒）