agentuity-cli-cloud-vector-upsert
Add or update vectors in the vector storage. Requires authentication. Use for Agentuity cloud platform operations
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Cloud Vector Upsert
Add or update vectors in the vector storage
Prerequisites
- Authenticated with
agentuity auth login
Usage
agentuity cloud vector upsert <namespace> [key] [options]
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
<namespace> |
string | Yes | - |
<key> |
string | No | - |
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--document |
string | Yes | - | document text to embed |
--embeddings |
string | Yes | - | pre-computed embeddings as JSON array |
--metadata |
string | Yes | - | metadata as JSON object |
--file |
string | Yes | - | 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"
}
| Field | Type | Description |
|---|---|---|
success |
boolean | Whether the operation succeeded |
namespace |
string | Namespace name |
count |
number | Number of vectors upserted |
results |
array | Upsert results with key-to-id mappings |
durationMs |
number | Operation duration in milliseconds |
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!