# Tutorials

:::callout{intent="tip" title="Prerequisites"}
If you haven't yet, we recommend going through the [**Quickstart tutorial**](../quickstart/index.md) first to get the most out of this section.
:::

Tutorials aim to empower you to use Weaviate based on _your_ particular needs.
Here, you can learn how to:

::::card-grid
:::card{title="Quick tour of Weaviate" href="/guides/quickstart-index" icon="signpost"}
End-to-end guide that covers important topics like configuring collections, compression, etc.
:::

:::card{title="Use Multi-Vector Embeddings (ColBERT, etc.)" href="/guides/guides-tutorials-multi-vector-embeddings" icon="puzzle"}
Implement advanced multi-vector representations for improved search relevance using models like ColBERT.
:::

:::card{title="Zero-downtime collection migration with aliases" href="/guides/guides-tutorials-collection-aliases" icon="share"}
Learn how to migrate Weaviate collections without service interruption using collection aliases.
:::

:::card{title="Import data in bulk" href="/guides/guides-tutorials-import" icon="file-input"}
Learn how to import data efficiently using client-side and server-side batching in Weaviate.
:::

:::card{title="Manage relationships with cross-references" href="/guides/guides-tutorials-cross-references" icon="link"}
Define, create, and query links between objects to model complex data relationships effectively.
:::

:::card{title="Load data into Weaviate with Spark" href="/guides/guides-tutorials-spark-connector" icon="flame"}
Use the Spark Connector to import large datasets from Apache Spark into Weaviate with batch processing.
:::

:::card{title="Set up Role-Based Access Control (RBAC)" href="/guides/guides-tutorials-rbac" icon="shield-user"}
Configure roles, permissions, and user assignments for secure access control in Weaviate.
:::

:::card{title="Secure Weaviate with TLS" href="/guides/guides-tutorials-tls-ssl" icon="lock"}
Navigate three paths to securing your Weaviate deployment using TLS.
:::

:::card{title="Switch vectorizers" href="/guides/guides-tutorials-vectorizer-migration" icon="arrow-left-right"}
Learn how to update the embedding model in order to improve performance.
:::
::::

## 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`.