OpenParable
Skip to content
← Back to skills

Agentuity CLI Cloud Vector Upsert

Apps & Automation
agentuity-cli-cloud-vector-upsert

Agentuity CLI Cloud Vector Upsert is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/agentuity-cli-cloud-vector-upsert-agentuity-examples/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/agentuity-cli-cloud-vector-upsert, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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