# Connect with Query Agent

Weaviate Cloud only

The fastest way to query data in [Weaviate Cloud (WCD)](../cloud/overview.md) without writing code is the [Query Agent](../cloud-agents/query-agent.md), a natural-language interface that translates a prompt into a multi-step search against your collections and returns a grounded answer.

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](/go/console?utm_content=howto), 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.

[Embedded content embed](https://app.guideflow.com/embed/zkjyx88tek)

## 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`](../agents/overview.md) client libraries. This makes it easy to move 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](../agents-configuration/advanced-collections.md).
- Standard Query Agent [usage limits](../cloud-agents/query-agent.md#usage-limits) apply.

For a deeper walkthrough including additional screen recordings, see the [Query Agent tool docs](../cloud-agents/query-agent.md).

## Questions and feedback

Have a question or feedback? Here's how to reach us.

::::card-grid
:::card{title="Community Forum" href="https://forum.weaviate.io/c/support" icon="messages-square"}
Ask questions and connect with other developers on our **Community forum**.
:::

:::card{title="Support" href="/guides/support-overview" icon="life-buoy"}
Weaviate Cloud user or customer? Find the right channel on the **Support page**.
:::
::::

## Related pages

- [Agents](./agents-index.md)
- [AI-assisted Weaviate code generation](./ai-assisted-vibe-coding-index.md)
- [APIs](./apis-index.md)
- [Authorization and authentication](./authorization-and-authentication-index.md)
- [Benchmarks](./benchmarks-index.md)
- [Best practices](./best-practices-index.md)
- [Client libraries](./clients-index.md)
- [Client Libraries / SDKs](./client-libraries-index.md)
- [Cloud](./cloud-index.md)
- [Cloud account management](./cloud-account-management-index.md)

# Agent Instructions

This portal answers questions programmatically. To receive a synthesized,
source-cited answer instead of crawling page by page, append the `?ask=`
query parameter to any page URL on this site:

    /guides/quickstart?ask=how+do+I+authenticate

Optional parameters:

- `&goal=<what-you-are-trying-to-do>` steers the answer toward your
  objective (e.g. `&goal=write+a+python+client`).
- `&version=<label>` scopes the answer to a mounted version when the
  portal publishes more than one.

The response is `text/markdown`: the answer followed by a `# Sources` list
of the portal pages it was grounded in. Status codes are the contract:

- `200` — the answer; `402` — the portal owner’s plan or answer credits are
  exhausted (surface this to your operator; do NOT retry); `429` — you are
  rate-limited; back off for the `Retry-After` seconds; `503` — the answer
  lane is temporarily unavailable; fall back to crawling the `.md` pages.

For the full corpus map read `llms.txt` at the site root; for the tool
surface (search + page fetch as MCP tools) see `/mcp`.