agentuity-cli-cloud-vector-search

Search for vectors using semantic similarity. Requires authentication. Use for Agentuity cloud platform operations

⭐3stars🔀5forks📁View on GitHub🕐Updated Jan 5, 2026⬇️1downloads

When & Why to Use This Skill

The agentuity-cli-cloud-vector-search skill enables high-performance semantic similarity searches within the Agentuity cloud platform. By utilizing vector embeddings rather than simple keyword matching, it allows AI agents to retrieve contextually relevant information from large datasets, making it a critical component for Retrieval-Augmented Generation (RAG) and intelligent data discovery.

Use Cases

  • RAG and Context Augmentation: Retrieve the most relevant snippets from a massive knowledge base to provide accurate, context-aware answers in AI chat applications.
  • Semantic Product Discovery: Search through e-commerce catalogs to find products that match a user's intent or description, even if the exact keywords aren't present.
  • Automated Documentation Filtering: Use metadata filters and similarity thresholds to pinpoint specific technical documentation or API references within a complex namespace.
  • Intelligent Content Recommendation: Identify related articles, research papers, or internal documents by comparing their semantic vector representations.
nameagentuity-cli-cloud-vector-search
descriptionSearch for vectors using semantic similarity. Requires authentication. Use for Agentuity cloud platform operations
version"0.0.104"
licenseApache-2.0
allowed-tools"Bash(agentuity:*)"
argument-hint"<namespace> <query>"
command"agentuity cloud vector search"
tags"read-only slow requires-auth"

Cloud Vector Search

Search for vectors using semantic similarity

Prerequisites

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

Usage

agentuity cloud vector search <namespace> <query> [options]

Arguments

Argument Type Required Description
<namespace> string Yes -
<query> string Yes -

Options

Option Type Required Default Description
--limit number Yes - maximum number of results to return (default: 10)
--similarity number Yes - minimum similarity threshold (0.0-1.0)
--metadata string Yes - filter by metadata (format: key=value or key1=value1,key2=value2)

Examples

Search for similar products:

bunx @agentuity/cli vector search products "comfortable office chair"

Search knowledge base:

bunx @agentuity/cli vector list knowledge-base "machine learning"

Limit results:

bunx @agentuity/cli vector search docs "API documentation" --limit 5

Set minimum similarity:

bunx @agentuity/cli vector search products "ergonomic" --similarity 0.8

Filter by metadata:

bunx @agentuity/cli vector ls embeddings "neural networks" --metadata category=ai

Output

Returns JSON object:

{
  "namespace": "string",
  "query": "string",
  "results": "array",
  "count": "number"
}
Field Type Description
namespace string Namespace name
query string Search query used
results array Search results
count number Number of results found