Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Qdrant

Scalekit connector
Open markdown

The Qdrant connector lets your AI agent act in each user's Qdrant account. Each user connects their own Qdrant API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 24 tools.

Tools
24
What they doRead · write · destructive
14 · 4 · 614 read4 write6 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Qdrant connection

    In AgentKit > Connections, create a Qdrant connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'qdrant'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Qdrant:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'qdrant_aliases_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Qdrant credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • qdrant_aliases_listList every collection alias in the Qdrant cluster.Read-only

    List Aliases

    List every collection alias in the Qdrant cluster. Returns each alias name with the collection it points to. Use this to resolve an alias to its collection. Use qdrant_collection_aliases_list for the aliases of one collection.

    Inputs

    This tool takes no inputs.

  • qdrant_collection_aliases_listList the aliases that point to one Qdrant collection.Read-only

    List Collection Aliases

    List the aliases that point to one Qdrant collection. Returns each alias name with the collection name. Use this for one collection's aliases. Use qdrant_aliases_list for every alias in the cluster.

    Inputs

    collection_namestringrequired
    Name of the Qdrant collection to act on. Get it from qdrant_collections_list. Example: products
  • qdrant_collection_existsCheck whether a collection with a given name exists in the Qdrant cluster.Read-only

    Check Collection Exists

    Check whether a collection with a given name exists in the Qdrant cluster. Returns exists: true or false. Use this before creating a collection or to confirm a name. Use qdrant_collection_get for the collection's full configuration.

    Inputs

    collection_namestringrequired
    Name of the Qdrant collection to act on. Get it from qdrant_collections_list. Example: products
  • qdrant_collection_getGet the details of one Qdrant collection.Read-only

    Get Collection

    Get the details of one Qdrant collection. Returns its status, point and indexed-vector counts, vector configuration (sizes, distance, named and sparse vectors), payload schema with indexed fields, and optimizer, HNSW and quantization settings. Use this to learn a collection's vector size, vector names and indexed payload fields before writing or searching. Use qdrant_collection_exists for a yes/no check.

    Inputs

    collection_namestringrequired
    Name of the Qdrant collection to act on. Get it from qdrant_collections_list. Example: products
  • qdrant_collections_listList every collection in the Qdrant cluster.Read-only

    List Collections

    List every collection in the Qdrant cluster. Returns the name of each collection, without configuration or point counts. Use this to discover collection names. Use qdrant_collection_get for one collection's configuration, status and point count.

    Inputs

    This tool takes no inputs.

  • qdrant_point_getGet one point from a Qdrant collection by its ID.Read-only

    Get Point

    Get one point from a Qdrant collection by its ID. Returns the point's id, payload and vectors. Use this for a single known ID. Use qdrant_points_retrieve for several IDs at once, and qdrant_points_scroll to browse points by filter.

    Inputs

    collection_namestringrequired
    Name of the Qdrant collection to act on. Get it from qdrant_collections_list. Example: products
    point_idstringrequired
    ID of the point to fetch: an unsigned integer or a UUID, as stored. Example: 550e8400-e29b-41d4-a716-446655440000
  • qdrant_points_countCount the points in a Qdrant collection, optionally only those matching a filter.Read-only

    Count Points

    Count the points in a Qdrant collection, optionally only those matching a filter. Returns count. Use this for totals. Use qdrant_points_facet for counts per payload value, and qdrant_points_scroll to list the points.

    Inputs

    collection_namestringrequired
    Name of the Qdrant collection to act on. Get it from qdrant_collections_list. Example: products
    exactboolean
    true counts exactly; false returns a faster estimate that can be off while the collection is indexing. Qdrant counts exactly by default.default true
    filterobject
    Qdrant filter that limits which points are counted. It is an object with up to three condition lists: must (all must match), should (at least one must match) and must_not (none may match). Each condition usually names a payload key and a match, range or geo rule. Example: {"must": [{"key": "city", "match": {"value": "London"}}, {"key": "price", "range": {"lte": 100}}]}
  • qdrant_points_facetCount how many points have each value of a payload field in a Qdrant collection, optionally within a filter.Read-only

    Facet Points

    Count how many points have each value of a payload field in a Qdrant collection, optionally within a filter. Returns hits, each with a value and its count, most frequent first. Use this to see the distinct values of a field and how common they are. Use qdrant_points_count for a single total. The field needs a keyword, integer, bool or uuid payload index (qdrant_payload_index_create).

    Inputs

    collection_namestringrequired
    Name of the Qdrant collection to act on. Get it from qdrant_collections_list. Example: products
    keystringrequired
    Payload key to count values for; it must have a keyword, integer, bool or uuid payload index. Nested keys use dot notation. Example: category
    exactboolean
    true counts each value exactly (slower); false (Qdrant's default) returns faster approximate counts.
    filterobject
    Qdrant filter that limits which points are counted. It is an object with up to three condition lists: must (all must match), should (at least one must match) and must_not (none may match). Each condition usually names a payload key and a match, range or geo rule. Example: {"must": [{"key": "city", "match": {"value": "London"}}, {"key": "price", "range": {"lte": 100}}]}
    limitinteger
    Maximum number of distinct values to return. Qdrant returns 10 when omitted. Example: 10