agentuity-cli-cloud-vector-search
Search for vectors using semantic similarity. Requires authentication. Use for Agentuity cloud platform operations
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.
| name | agentuity-cli-cloud-vector-search |
|---|---|
| description | Search for vectors using semantic similarity. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.104" |
| license | Apache-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 |