import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import FilteredTextBlock from '@site/src/components/Documentation/FilteredTextBlock'; import PyCode from '!!raw-loader!/docs/query-agent/_includes/code/quickstart.py'; import TSCode from '!!raw-loader!/docs/query-agent/_includes/code/quickstart.mts';

This quickstart walks through connecting to a Weaviate Cloud cluster, pointing the Query Agent at one or more existing collections, and running your first natural-language queries in both Search Mode and Ask Mode.

Ensure you have access to:

• A Weaviate Cloud Instance, such as a free cluster.
• Either the Python Client or the TypeScript Client.

You only need to provide:

• Your Weaviate client object, which points to a target Weaviate Cloud instance
• The collections you want to make possible to be searched.

Perform a search using Search Mode (retrieval only, no answer generation). The LLM decides dynamic search options (such as filters, sorts, etc.) and returns the search results.

Search Mode returns the raw Weaviate objects, as if you had performed the search in Weaviate directly.

Perform a query using Ask Mode (with answer generation). The LLM creates a search with dynamic filters and other search settings, and then answers the question using the search results to inform the answer.

You can access specific search results via ask_response.sources, the final response via ask_response.final_answer, or view all outputs via ask_response.display().

import DocsFeedback from '/_includes/docs-feedback.mdx';