Collection Commands¶

./rag-cli collections list [OPTIONS]

./rag-cli collections list

./rag-cli collections list --format json --filter "research"

./rag-cli collections list --limit 10 --offset 20

./rag-cli collections list --sort created_at --order desc

./rag-cli collections create NAME [OPTIONS]

./rag-cli collections create "My Knowledge Base"

./rag-cli collections create "Confidential Docs" \
  --description "Internal confidential documents" \
  --private \
  --vector-db milvus \
  --chunk-size 1024

COLLECTION_ID=$(./rag-cli collections create "Research Papers" --output-id)
echo "Created collection: $COLLECTION_ID"

./rag-cli collections create "Technical Documentation" \
  --description "Software documentation and guides" \
  --embedding-model "sentence-transformers/all-mpnet-base-v2" \
  --chunk-size 768 \
  --chunk-overlap 100

./rag-cli collections get COLLECTION_ID [OPTIONS]

./rag-cli collections get col_123abc

./rag-cli collections get col_123abc --include-stats --include-settings

./rag-cli collections get col_123abc --format json --include-stats

./rag-cli collections update COLLECTION_ID [OPTIONS]

./rag-cli collections update col_123abc \
  --name "Corporate Knowledge Base" \
  --description "Updated comprehensive knowledge repository"

./rag-cli collections update col_123abc --private true

./rag-cli collections update col_123abc \
  --chunk-size 1024 \
  --chunk-overlap 100

./rag-cli collections update col_123abc \
  --similarity-threshold 0.8

./rag-cli collections delete COLLECTION_ID [OPTIONS]

./rag-cli collections delete col_123abc

./rag-cli collections delete col_123abc --force

./rag-cli collections delete col_123abc \
  --backup \
  --backup-path "./backups/collection-$(date +%Y%m%d)"

#!/bin/bash
collections=("Research Papers" "Technical Docs" "Meeting Notes")

for name in "${collections[@]}"; do
    id=$(./rag-cli collections create "$name" --output-id)
    echo "Created: $name ($id)"
done

#!/bin/bash
# Update privacy for all collections
./rag-cli collections list --format json | \
jq -r '.collections[].id' | \
while read collection_id; do
    ./rag-cli collections update "$collection_id" --private true
    echo "Updated: $collection_id"
done

./rag-cli collections get col_123abc --format json --include-settings > collection-config.json

#!/bin/bash
config=$(cat collection-config.json)
name=$(echo "$config" | jq -r '.name')
description=$(echo "$config" | jq -r '.description')
chunk_size=$(echo "$config" | jq -r '.chunk_size')

./rag-cli collections create "$name" \
  --description "$description" \
  --chunk-size "$chunk_size"

#!/bin/bash
./rag-cli collections list --format json | \
jq -r '.collections[] | select(.status != "active") | [.id, .name, .status] | @tsv' | \
while IFS=$'\t' read -r id name status; do
    echo "⚠️ Collection issue: $name ($id) - Status: $status"
done

#!/bin/bash
echo "📊 Collection Statistics Dashboard"
echo "================================="

total=$(./rag-cli collections list --format json | jq '.total')
echo "Total Collections: $total"

active=$(./rag-cli collections list --format json | jq '[.collections[] | select(.status == "active")] | length')
echo "Active Collections: $active"

total_docs=$(./rag-cli collections list --format json | jq '[.collections[].document_count] | add')
echo "Total Documents: $total_docs"

echo ""
echo "Top 5 Collections by Document Count:"
./rag-cli collections list --format json | \
jq -r '.collections | sort_by(.document_count) | reverse | .[0:5] | .[] | [.name, .document_count] | @tsv' | \
while IFS=$'\t' read -r name count; do
    echo "  - $name: $count documents"
done

$ ./rag-cli collections get invalid-id
❌ Collection not found

Collection ID 'invalid-id' does not exist or you don't have access to it.

Available collections:
./rag-cli collections list

$ ./rag-cli collections get col_private123
❌ Access denied

Collection 'col_private123' is private and you don't have access.
Contact the collection owner for access.

$ ./rag-cli collections create "Knowledge Base"
❌ Collection creation failed

A collection with the name 'Knowledge Base' already exists.
Collection names must be unique within your account.

Suggestion: Try "Knowledge Base v2" or "Knowledge Base - Updated"

$ ./rag-cli collections create "New Collection"
❌ Collection creation failed

Unable to connect to vector database (milvus).
- Check backend configuration
- Verify vector database is running
- Contact administrator if issue persists

Backend status: ./rag-cli config test-connection

./rag-cli --debug collections get col_123abc

./rag-cli config test-connection --verbose

# Check collection consistency
./rag-cli collections get col_123abc --include-stats --include-settings

# 1. Create collection
COLLECTION_ID=$(./rag-cli collections create "Research Papers" \
  --description "Academic research collection" \
  --chunk-size 1024 \
  --output-id)

# 2. Upload documents
./rag-cli documents upload "$COLLECTION_ID" *.pdf

# 3. Verify collection
./rag-cli collections get "$COLLECTION_ID" --include-stats

# Find collections with specific documents
./rag-cli collections list --filter "research" | \
grep -E "col_[a-zA-Z0-9]+" | \
while read collection_id _; do
    echo "Searching in: $collection_id"
    ./rag-cli search query "$collection_id" "machine learning" --max-results 3
done

# Grant access to private collection
./rag-cli collections update col_123abc --add-user "jane.doe@company.com"

# List users with access
./rag-cli collections get col_123abc --include-permissions

# Set default vector database
./rag-cli config set collections.default_vector_db "milvus"

# Set default chunk size
./rag-cli config set collections.default_chunk_size 768

# Set default privacy
./rag-cli config set collections.default_private false

# Production settings
./rag-cli config set collections.default_vector_db "pinecone" --profile prod
./rag-cli config set collections.default_chunk_size 1024 --profile prod

# Development settings
./rag-cli config set collections.default_vector_db "chromadb" --profile dev
./rag-cli config set collections.default_chunk_size 512 --profile dev