.json payload file, plus a .txt
text file and an optional blob.
Setup
A self-hosted Qdrant needs no key: sethost and port (default
localhost:6333) instead of url. Qdrant Cloud needs the cluster URL and an
API key:
- In the Qdrant Cloud console, open the cluster and go to its API Keys tab.
- Click Create, name the key and pick an expiration (90 days by default).
- Pick read-only access, for the whole cluster or for the collections to mount.
- Copy the key, which shows only once, and the cluster URL.
group_by field only
when Qdrant reports one is required. A read-only key cannot, so index those
fields first or use a key that manages the collection.
Connect
- YAML
- Python
- TypeScript
workspace.yaml
Layout
- Without
collection, every collection is a top-level folder. Files are named by point id, or<name>__<id>withname_field. - Fields take dotted payload paths, such as
group_by: [metadata.source], andbasename_fieldskeeps only the last path segment of a value. - The
searchCLI ranks points by meaning. It needs anembedhook (Python and TypeScript) orcloud_inference: true, where the cluster embeds the query withembedding_model; with neither it refuses the query. The stored vectors must come from the same model.
Sample runs
max_rows (1,000)
points, and search returns search_limit (10) results by default.
SDK guides
Python
Every config field, the VFS.md and write support.
TypeScript
Every config field, the VFS.md and write support.