> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Connect a warehouse, ask the agent a question, and build your first notebook.

This page takes you from a new account to a working notebook. If you do not have an account yet, start with [Get access](/docs/get-access.md).

## 1. Connect your data

The agent works with the data your connections reach.

**1. Open Connections**

Click **Connections** in the sidebar, then **Add connection**.

**2. Choose who it is for**

Under **Who this connection is for**, pick **Just me**, or a team if you are its admin.

**3. Fill in the form**

Pick the integration, such as Snowflake or PostgreSQL, choose how to sign in, and fill in its details. Set the **Deployment tier** so the agent knows whether it is touching production.

**4. Save**

Click **Save connection**. Datalooma checks the connection before it saves, so a connection that cannot connect is never stored.

See [Plugins & Connections](/docs/foundations/plugins-and-connections.md) for every supported integration.

> [!TIP]
>
> No warehouse handy? You can still upload a CSV, Parquet, or any other flat file, such as TSV, JSON, or Excel, to the workspace and ask the agent to analyze it.

## 2. Start a chat

Click **Chat** in the sidebar. Your **Main** workspace is listed first under **Workspaces**. Click **Chat** on its row to start a chat in it.

In the composer:

* **Model** and **Effort** pick the model and how hard it reasons. Set your defaults in **Preferences**.
* **Permission mode** decides what the agent may do without asking. **Default** runs reads freely and asks before changes. See [permission modes](/docs/foundations/agent-and-tools.md#permission-modes).

Ask a question about your data:

```text theme={null}
Which five customers had the largest drop in order volume last quarter?
```

The agent looks at your schemas and the [knowledge base](/docs/foundations/knowledge-base.md), runs queries, and streams its answer. Each step appears as a card you can expand. Query results show as tables.

## 3. Approve what it proposes

When the agent wants to do something that changes state, such as writing a file or running a notebook cell, it stops and shows an approval card. Choose **Allow once**, **Reject once**, or **Always allow** from the dropdown.

Nothing that changes your data or files runs without passing this gate, unless you choose a mode that allows it.

## 4. Build a notebook

Ask the agent to turn the analysis into a notebook:

```text theme={null}
Turn this into a notebook with a weekly trend chart and a region filter.
```

The agent creates an `.alknb.py` notebook in the workspace, writes SQL and Python cells, runs them, and shows the outputs in the chat. Click **Go to cell** on any step to open the notebook at that cell. You can edit cells alongside the agent while it works.

You can also create one yourself: open the workspace's files and click **New notebook**. See [Notebooks](/docs/notebooks/overview.md).

## 5. Bring your team in

* **Share the workspace.** Open the workspace's **⋮** menu and choose **Share…**. Add people or teams and pick their access. See [Sharing](/docs/workspaces/overview.md#sharing).
* **Invite teammates.** If they are not in your organization yet, an admin can invite them from [Teams](/docs/organization/teams.md#invitations).
* **Record what you know.** Add business definitions and conventions in **Knowledge** so the agent uses them in every chat.

## Learn more

> [card] [Workspaces](/docs/workspaces/overview.md)
>
> Main and project workspaces, sharing, and sleep.

> [card] [Chats](/docs/workspaces/chats.md)
>
> The composer, models, approvals, and working together.

> [card] [Notebooks](/docs/notebooks/overview.md)
>
> Reactive SQL and Python notebooks built with the agent.

> [card] [Agent & Tools](/docs/foundations/agent-and-tools.md)
>
> Effects, permission modes, and approvals.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.