Vector and Search Commands
This domain covers vector engine setup, collection management, and vector search.
Vector Store Commands
Command group: dodil k3 vector-store
Persistent flag:
--bucket,-b
| Subcommand | Args | Important flags |
|---|---|---|
create | none | --mode, -m (auto/external) |
get | none | --bucket |
delete | none | --bucket |
list-instances | none | none |
Example:
dodil k3 vector-store create --bucket kb-dev --mode auto
dodil k3 vector-store get --bucket kb-dev -o jsonVector Collection Commands
Command group: dodil k3 vector-collection
Persistent flag:
--bucket,-b
| Subcommand | Args | Important flags |
|---|---|---|
add | <name> | --description, --pipeline, --dimensions, --metric |
get | <id> | --bucket |
list | none | --bucket |
delete | <id> | --bucket |
Example:
dodil k3 vector-collection add contracts-v1 \
--bucket kb-dev \
--pipeline object_embedding_index \
--dimensions 1536 \
--metric cosineSearch Command
Command: dodil k3 search [query]
| Flag | Default | Purpose |
|---|---|---|
--bucket, -b | none | Bucket to search |
--collection, -c | none | Restrict to one collection |
--top-k, -k | 10 | Max results |
--min-score, -s | 0.0 | Score threshold |
Example:
dodil k3 search "contract renewal terms" \
--bucket kb-dev \
--collection contracts-v1 \
--top-k 8 \
--min-score 0.2Important Notes
- CLI does not expose first-class external vector write commands (
InsertVectors,UpsertVectors,DeleteVectors). - Use direct API for external/manual vector ingestion flows.
- Search behavior may go through compatibility mapping in some adapter layers; canonical API route remains
/:bucket/vector/search.
Common Use Cases
- Quickly bootstrap vector retrieval in a new bucket.
- Validate search quality and thresholds from terminal.
- Manage collection lifecycle during model/dimension changes.