---

name: agentuity-cli-cloud-vector-upsert description: Add or update vectors in the vector storage. Requires authentication. Use for Agentuity cloud platform operations version: "0.0.103" license: Apache-2.0 allowed-tools: "Bash(agentuity:*)" argument-hint: " [key]" metadata: command: "agentuity cloud vector upsert" tags: "mutating updates-resource slow requires-auth"

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

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

Arguments

Options

Examples

Upsert a single vector with document text:

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

Upsert with metadata:

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

Upsert with pre-computed embeddings:

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

Bulk upsert from JSON file:

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

Bulk upsert from stdin:

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

Output

Returns JSON object:

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