Introduction

Weaviate Cloud only

The Query Agent runs agentic search over your Weaviate Cloud database. Ask a question in natural language and the agent automatically decides which collections to search, which filters and sorts to apply, and which search types to use — all in a single call.

Free tier

Up to 250 ask queries or 1000 search queries per month, no credit card required. Get started →

Python (Agents)JavaScript/TypeScript (Agents)

from weaviate.agents.query import QueryAgent

qa = QueryAgent(
    client=client, # your Weaviate cloud client
    collections=["FinancialContracts"]
)

res = qa.ask("Find all contracts signed in 2025")

res.display()

import { QueryAgent } from 'weaviate-agents';

const qa = new QueryAgent(
    client, // your Weaviate cloud client
    {
        collections: ['FinancialContracts'],
    }
);

const res = await qa.ask("Find all contracts signed in 2025");

res.display();

Looking for agent memory?

Engram is a managed memory service that gives your agents persistent, searchable memory across conversations and users.

How the Query Agent works

Example output

╭───────────────────────────────────────────── 💬 Ask Mode Response ──────────────────────────────────────────────╮
│                                                                                                                 │
│ The most expensive blue t-shirt is **Neotech Noir Tee** by **Vivid Verse**, priced at **$46.00**.               │