Skip to content
agentuity-cli-cloud-vector-upsert logo

agentuity-cli-cloud-vector-upsert

Add or update vectors in the vector storage. Requires authentication. Use for Agentuity cloud platform operations

SKILL.md

Full skill instructions

Cloud Vector Upsert

Add or update vectors in the vector storage

Prerequisites

  • Authenticated with agentuity auth login
  • Project context required (run from project directory or use --project-id)

Usage

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

Arguments

ArgumentTypeRequiredDescription
<namespace>stringYes-
<key>stringNo-

Options

OptionTypeRequiredDefaultDescription
--documentstringYes-document text to embed
--embeddingsstringYes-pre-computed embeddings as JSON array
--metadatastringYes-metadata as JSON object
--filestringYes-path to JSON file containing vectors, or "-" for stdin

Examples

Upsert a single vector with document text:

bunx @agentuity/​cli vector upsert products doc1 --document "Comfortable office chair"

Upsert with metadata:

bunx @agentuity/​cli vector upsert products doc1 --document "Chair" --metadata '{"category":"furniture"}'

Upsert with pre-computed embeddings:

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

Bulk upsert from JSON file:

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

Bulk upsert from stdin:

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

Output

Returns JSON object:

{
  "success": "boolean",
  "namespace": "string",
  "count": "number",
  "results": "array",
  "durationMs": "number"
}
FieldTypeDescription
successbooleanWhether the operation succeeded
namespacestringNamespace name
countnumberNumber of vectors upserted
resultsarrayUpsert results with key-to-id mappings
durationMsnumberOperation duration in milliseconds