Connect with Query Agent
Weaviate Cloud only
The fastest way to query data in Weaviate Cloud (WCD) without writing code is the Query Agent — a natural-language interface that translates a prompt into a multi-step search against your collections and returns a grounded answer.
If you'd rather write GraphQL by hand, the Query tool is still available further down on this page.
Query Agent
The Query Agent lets you ask natural-language questions over one or more collections in your Weaviate Cloud cluster. Behind the scenes it plans a hybrid search strategy, executes it, and returns an answer along with the matching source objects.
Query a collection
In your WCD Dashboard, select Agents in the left-hand sidebar, choose the cluster and collection(s) you want to query, and type a natural-language prompt. The agent picks the right collections, runs the underlying searches, and returns an answer along with the objects that backed it.
Beyond picking collections, you can also provide API keys for external model providers (OpenAI, Anthropic, etc.), choose which named vector to query when a collection has more than one, and set a system prompt to steer tone, language, or output format.
Generate client code
After running a query in the console, you can copy a Python or TypeScript snippet that reproduces the same call through the weaviate-agents client libraries — useful for moving from exploration into application code.
Limitations
- The Cloud-console Query Agent does not support multi-tenant collections. To use the Query Agent with multi-tenancy, call it from a client library.
- Standard Query Agent usage limits apply.
For a deeper walkthrough including additional screen recordings, see the Query Agent tool docs.
Query tool
The Query application (query tool) is a browser-based GraphQL IDE. The Query tool is available in the Weaviate Cloud (WCD) console.
Use the query tool to work interactively with clusters hosted in Weaviate Cloud and self-hosted instances too.
Open the query tool
To use the query tool, open your WCD Dashboard.
In the left-hand menu, click the Query tool icon.
Select a Weaviate instance
The query tool connects directly to your WCD clusters. The query tool can also connect to external Weaviate instances if you have anonymous access enabled or authentication credentials.
To select a cluster, Click the Query button and choose a cluster from the clusters list.
Pass authentication details
To pass authentication details for an external instance, use request headers.
Replace "replaceWithYourPassword" with the password for an authorized user.
{
"Authorization": "Bearer replaceWithYourPassword"
}
Pass inference keys
To pass API keys for inference modules, use request headers.
The header can pass multiple keys.
{
"X-Cohere-Api-key": "replaceWithYourCohereKey",
"X-HuggingFace-Api-key": "replaceWithYourHuggingFaceKey",
"X-OpenAI-Api-key": "replaceWithYourOpenAIKey",
}
Example query
This example uses keyword search to query a movie database. The GraphiQL editor helps you to build the query on the left hand side of the screen. When you run the query, it displays the results on the right hand side.
For more information about the GraphQL API, see the GraphQL API.
Questions and feedback
If you have any questions or feedback, let us know in the user forum.