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

# Basic Tutorial: Connect and Test

This tutorial is intended for Admin users who are responsible for configuring data sources and setting up WisdomAI.

## Learning objectives

By the end of this tutorial, you will be able to:

* Connect to your Database.
* Start querying your data to test WisdomAI.
* Provide feedback so the system can refine its context based on your input.

Once you have completed this tutorial, you will have WisdomAI connected to your data and ready to improve through real-time interaction and feedback.

## Before you begin

To follow this tutorial, you should:

* Have Admin access to your WisdomAI account.
* Know the credentials to access your data source.

## 1. Connect to data sources

To get started, you first need to connect your existing data source to WisdomAI so the system can access and prepare your data for use and create reports:

1. Go to the left sidebar and select **Connections**.
2. Click on the **Add Connection** button to start.
   <Note>
     This action lets you link your existing data sources to WisdomAI. Doing so enables the system to scan metadata. For data warehouse connections, it also enables WisdomAI to fetch data when users ask natural-language questions.
   </Note>

<Frame>
  <img alt="Connections and Add Connection screens with the nav item, Add connection button, and data source picker highlighted" lightAlt="Connections and Add Connection screens with the nav item, Add connection button, and data source picker highlighted" darkAlt="Connections and Add Connection screens with the nav item, Add connection button, and data source picker highlighted" src="https://mintcdn.com/wisdomai/7M9RuenwQrrmrzba/images/basic-tutorial-add-connection-light.png?fit=max&auto=format&n=7M9RuenwQrrmrzba&q=85&s=92e7e52cd313e3f1cd614a511032966c" className="dark:hidden" width="1442" height="1020" data-path="images/basic-tutorial-add-connection-light.png" />

  <img alt="Connections and Add Connection screens with the nav item, Add connection button, and data source picker highlighted" lightAlt="Connections and Add Connection screens with the nav item, Add connection button, and data source picker highlighted" darkAlt="Connections and Add Connection screens with the nav item, Add connection button, and data source picker highlighted" src="https://mintcdn.com/wisdomai/7M9RuenwQrrmrzba/dark-img/basic-tutorial-add-connection-dark.png?fit=max&auto=format&n=7M9RuenwQrrmrzba&q=85&s=6b5f22e6f463fe0f01f18de81581bc82" className="hidden dark:block" width="1922" height="1140" data-path="dark-img/basic-tutorial-add-connection-dark.png" />
</Frame>

3. Select your data source type from the list (for example, Snowflake, BigQuery, PostgreSQL, or MCP Server).
   <Info>
     Access [Supported Data Sources](/getting-started/connect-data-sources/supported-data-sources) to see the complete list of supported data sources by WisdomAI.
   </Info>
4. Add a **Connection name** and fill in the connection details for your selected data source, such as account information, authentication method, and any relevant filters.
   <Note>
     The fields and authentication options shown depend on the data source you selected in step 3. See [Supported Data Sources](/getting-started/connect-data-sources/supported-data-sources) for source-specific setup guides.
   </Note>
5. Click on the **Save and Sync metadata** button.

<Frame>
  <img alt="Redshift Connection Details form with the credentials panel and Save and Sync metadata button highlighted" lightAlt="Redshift Connection Details form with the credentials panel and Save and Sync metadata button highlighted" darkAlt="Redshift Connection Details form with the credentials panel and Save and Sync metadata button highlighted" src="https://mintcdn.com/wisdomai/7M9RuenwQrrmrzba/images/newui-add-connection-details.png?fit=max&auto=format&n=7M9RuenwQrrmrzba&q=85&s=6cca6edab2d7cc5a00c252f90843ea4d" className="dark:hidden" width="1060" height="900" data-path="images/newui-add-connection-details.png" />

  <img alt="Redshift Connection Details form with the credentials panel and Save and Sync metadata button highlighted" lightAlt="Redshift Connection Details form with the credentials panel and Save and Sync metadata button highlighted" darkAlt="Redshift Connection Details form with the credentials panel and Save and Sync metadata button highlighted" src="https://mintcdn.com/wisdomai/7M9RuenwQrrmrzba/dark-img/basic-tutorial-save-and-sync-dark.png?fit=max&auto=format&n=7M9RuenwQrrmrzba&q=85&s=b7b35cd88f2b39115c3c5a3f048fc9d7" className="hidden dark:block" width="1053" height="903" data-path="dark-img/basic-tutorial-save-and-sync-dark.png" />
</Frame>

<Warning>
  **Note on Syncing**: After successfully adding a connection, the initial sync may take a few minutes to complete. Then, data will be available for analysis.
</Warning>

## 2. Select the data

After you add your data source, select the data you want to use in your project. For this, you will need to create a Domain.

1. Go to **Domains** in the left sidebar.
   <Note>
     A Domain represents a logical business area or function, such as Sales, Marketing, or Finance. Creating well-defined domains makes data more accessible and relevant to business users.
   </Note>
2. Click on the **Add Domain** button. A new window will open.
3. Enter the **Domain name** and **select the data source** from the dropdown menu.
4. Click **Create Domain** to continue.

<Frame>
  <img alt="Domains list with the Add domain button highlighted, and the Create New Domain modal with domain name, data source selection, and Create Domain button highlighted" lightAlt="Domains list with the Add domain button highlighted, and the Create New Domain modal with domain name, data source selection, and Create Domain button highlighted" darkAlt="Domains list with the Add domain button highlighted, and the Create New Domain modal with domain name, data source selection, and Create Domain button highlighted" src="https://mintcdn.com/wisdomai/7M9RuenwQrrmrzba/images/create-new-domain-light.png?fit=max&auto=format&n=7M9RuenwQrrmrzba&q=85&s=1ac2b93a51cb80536f90088841943859" className="dark:hidden" width="1922" height="1133" data-path="images/create-new-domain-light.png" />

  <img alt="Domains list with the Add domain button highlighted, and the Create New Domain modal with domain name, data source selection, and Create Domain button highlighted" lightAlt="Domains list with the Add domain button highlighted, and the Create New Domain modal with domain name, data source selection, and Create Domain button highlighted" darkAlt="Domains list with the Add domain button highlighted, and the Create New Domain modal with domain name, data source selection, and Create Domain button highlighted" src="https://mintcdn.com/wisdomai/7M9RuenwQrrmrzba/dark-img/create-new-domain-dark.png?fit=max&auto=format&n=7M9RuenwQrrmrzba&q=85&s=7ceffbde6dccfea8d5726871b7bc338e" className="hidden dark:block" width="1915" height="1119" data-path="dark-img/create-new-domain-dark.png" />
</Frame>

5. The next window will vary depending on what you selected in step 3:
   * If you selected an existing **Data source**, choose the **tables** you would like to use, then click **Add Table**.
   * If you selected **Add Files**, upload your CSV, TSV, PDF, Word, PowerPoint, or other files, then click **Upload**.
   * If you selected **Connect new Data store or MCP server**, configure the connection as prompted, then follow the applicable step to finish adding it (this varies by source type).
6. Click **Add Table** or the corresponding option (e.g., **Upload**), depending on your selection.

Once your data is added, you are ready to start querying it to retrieve information and generate reports about your business.

<Frame>
  <img alt="Add Data to Domain modal window displayed" lightAlt="Add Data to Domain modal window displayed" darkAlt="Add Data to Domain modal window displayed" src="https://mintcdn.com/wisdomai/tWjf8qsLGoAJ4jNx/images/newui-create-domain-03.png?fit=max&auto=format&n=tWjf8qsLGoAJ4jNx&q=85&s=8de6cbfbbc40fca82926e9fccb65d4a5" className="dark:hidden" width="1000" height="770" data-path="images/newui-create-domain-03.png" />

  <img alt="Add Data to Domain modal window displayed" lightAlt="Add Data to Domain modal window displayed" darkAlt="Add Data to Domain modal window displayed" src="https://mintcdn.com/wisdomai/FPeFp9c8fz1r_sxU/dark-img/data-domain.png?fit=max&auto=format&n=FPeFp9c8fz1r_sxU&q=85&s=e3eb846af03759f657f54511a24847cd" className="hidden dark:block" width="1000" height="770" data-path="dark-img/data-domain.png" />
</Frame>

<Tip>
  If you want to connect a new source, select this option in step 3. In the same window, you can choose to connect a new Data store or MCP server, or add files (CSV, TSV, or Excel).

  <Frame>
    <img alt="Connect Data Surce step" lightAlt="Connect Data Surce step" darkAlt="Connect Data Surce step" src="https://mintcdn.com/wisdomai/DCsfCD8BWANiDlQl/images/newui-create-domain-04-callout.png?fit=max&auto=format&n=DCsfCD8BWANiDlQl&q=85&s=3b57abc7df15cb1a0dd79fe5eefa79d6" className="dark:hidden" width="1007" height="773" data-path="images/newui-create-domain-04-callout.png" />

    <img alt="Connect Data Surce step" lightAlt="Connect Data Surce step" darkAlt="Connect Data Surce step" src="https://mintcdn.com/wisdomai/FPeFp9c8fz1r_sxU/dark-img/connect-new-source.png?fit=max&auto=format&n=FPeFp9c8fz1r_sxU&q=85&s=541d8775906f113c51707f0b2d8654a6" className="hidden dark:block" width="1007" height="773" data-path="dark-img/connect-new-source.png" />
  </Frame>
</Tip>

## 3. Upload CSV files (Optional)

In addition to database connections, Admins can add data directly to a Domain using CSV, TSV, or Excel files. When an Admin adds a file this way, the data becomes a permanent part of the Domain and is available to all users with access to that Domain.

1. Navigate to **Domains** in the left sidebar and select your Domain.
2. Go to the **Data Sources** tab.
3. Click **Add Table** and select **Create from CSV**.

<img alt="Domain screen showing the Upload a CSV file option" lightAlt="Domain screen showing the Upload a CSV file option" darkAlt="Domain screen showing the Upload a CSV file option" src="https://mintcdn.com/wisdomai/KR_ULitS7YtCu4QU/images/new-ui-create_table_from_csv_domain01.png?fit=max&auto=format&n=KR_ULitS7YtCu4QU&q=85&s=48ac0bd29a8ef390101779377be35a39" className="dark:hidden" width="1920" height="999" data-path="images/new-ui-create_table_from_csv_domain01.png" />

<img alt="Domain screen showing the Upload a CSV file option" lightAlt="Domain screen showing the Upload a CSV file option" darkAlt="Domain screen showing the Upload a CSV file option" src="https://mintcdn.com/wisdomai/FPeFp9c8fz1r_sxU/dark-img/dark-new-ui-create_table_from_csv_domain01.png?fit=max&auto=format&n=FPeFp9c8fz1r_sxU&q=85&s=6adc9a50d76840eaf0fd9da6a6398e9b" className="hidden dark:block" width="1920" height="999" data-path="dark-img/dark-new-ui-create_table_from_csv_domain01.png" />

4. Upload your file and configure the column types.

<img alt="Configure tables modal" lightAlt="Configure tables modal" darkAlt="Configure tables modal" src="https://mintcdn.com/wisdomai/uHRJ9Gl6FvaEts3X/images/configure_columns_domain.png?fit=max&auto=format&n=uHRJ9Gl6FvaEts3X&q=85&s=ef2b88a3fb98ddef9c80ebc0b8b6af62" className="dark:hidden" width="1589" height="1680" data-path="images/configure_columns_domain.png" />

<img alt="Configure tables modal" lightAlt="Configure tables modal" darkAlt="Configure tables modal" src="https://mintcdn.com/wisdomai/FPeFp9c8fz1r_sxU/dark-img/config-table-modal.png?fit=max&auto=format&n=FPeFp9c8fz1r_sxU&q=85&s=2dafe401290b865b72022f758962fab6" className="hidden dark:block" width="936" height="1294" data-path="dark-img/config-table-modal.png" />

<Note>
  **Replace an Existing Table**

  You can also replace an existing CSV table instead of uploading a new one. This allows you to update the underlying data while preserving all existing column descriptions, settings, and domain configurations. To learn how to do it, see our [Work with CSV Files](/using-wisdom-ai-everyday/work-with-csv-files) guide.
</Note>

5. Click **Create table**.

<img alt="Create Table From Csv Domain02" lightAlt="Create Table From Csv Domain02" darkAlt="Create Table From Csv Domain02" src="https://mintcdn.com/wisdomai/uHRJ9Gl6FvaEts3X/images/create_table_from_csv_domain02.png?fit=max&auto=format&n=uHRJ9Gl6FvaEts3X&q=85&s=2858895ac9b0bd20fe11674e51c82c9a" className="dark:hidden" width="1591" height="412" data-path="images/create_table_from_csv_domain02.png" />

<img alt="Create Table From Csv Domain02" lightAlt="Create Table From Csv Domain02" darkAlt="Create Table From Csv Domain02" src="https://mintcdn.com/wisdomai/FPeFp9c8fz1r_sxU/dark-img/cvs-file.png?fit=max&auto=format&n=FPeFp9c8fz1r_sxU&q=85&s=345e94bf1378bebdf8e6a8ffd56356ee" className="hidden dark:block" width="1613" height="770" data-path="dark-img/cvs-file.png" />

<Tip>
  **Use CSVs as an Explorer**

  WisdomAI also allows non-admin users to create private domains or attach CSVs directly to a chat for quick analysis. For a full breakdown of these features and detailed configuration steps, see our [Work with CSV Files](/using-wisdom-ai-everyday/work-with-csv-files) guide.
</Tip>

## 4. Start testing

Once your data is set up and selected, you can start querying your data to see WisdomAI in action and test its data analysis capabilities. Here are some example questions you may ask:

* *"What was our revenue by region last quarter?"*
* *"Show me customer retention by month."*
* *"Which products had the highest growth rate compared to last year?"*

While experimenting with your AI data analyst, you can **train** it by providing **feedback**. There are three main ways to do so:

* Using the **thumbs up/down** icons. If your feedback was thumbs down, a new window opens so you can adjust the query accordingly. The more thumbs up/down you provide, the more you will train the tool to get high-quality, correct answers.
* By **changing the SQL Code**.
* By **Fine-tuning** the **Knowledge**.

<Info>
  Think about the following scenario: you tell the system that the Report it created is incorrect, so you provide the accurate data in the chat. If this additional context has not been added to the database tables, you can add it directly in the chat.
</Info>

In all these cases, the system will use the provided data to further refine the context of your database, enabling it to provide better answers in future searches, as shown in the example images below.

<img alt="Thumb Down Feedback" lightAlt="Thumb Down Feedback" darkAlt="Thumb Down Feedback" src="https://mintcdn.com/wisdomai/82xgEVWUP7cwhDHG/images/thumb-downv2.png?fit=max&auto=format&n=82xgEVWUP7cwhDHG&q=85&s=4d2dd61e275e2a1fc3297f5ba58c6a68" className="dark:hidden" width="909" height="1203" data-path="images/thumb-downv2.png" />

<img alt="Thumb Down Feedback" lightAlt="Thumb Down Feedback" darkAlt="Thumb Down Feedback" src="https://mintcdn.com/wisdomai/Sm9GcK0N5nQW94vf/dark-img/thumb-downv2.png?fit=max&auto=format&n=Sm9GcK0N5nQW94vf&q=85&s=ca72b325bf66c4e5c88eabb9e2cf2928" className="hidden dark:block" width="804" height="894" data-path="dark-img/thumb-downv2.png" />

<img alt="Revenue By Region" lightAlt="Revenue By Region" darkAlt="Revenue By Region" src="https://mintcdn.com/wisdomai/82xgEVWUP7cwhDHG/images/revenue-by-region.png?fit=max&auto=format&n=82xgEVWUP7cwhDHG&q=85&s=7daceb2f8c71b96568d40a99f9cf1e6b" className="dark:hidden" width="964" height="1357" data-path="images/revenue-by-region.png" />

<img alt="Revenue By Region" lightAlt="Revenue By Region" darkAlt="Revenue By Region" src="https://mintcdn.com/wisdomai/Sm9GcK0N5nQW94vf/dark-img/revenue-by-region.png?fit=max&auto=format&n=Sm9GcK0N5nQW94vf&q=85&s=94b71ba52630c9cd9d03d266f2d71296" className="hidden dark:block" width="725" height="1216" data-path="dark-img/revenue-by-region.png" />

<Note>
  Currently, feedback icons (thumbs-up and thumbs-down) appear only for responses containing charts or structured data. Feedback for text-only responses is not yet supported, but will be available in a future update.
</Note>

## Next steps

<CardGroup cols={3}>
  <Card title="Supported Data Sources" icon="database" href="/getting-started/connect-data-sources/supported-data-sources">
    Explore the full list of databases and platforms you can connect to the system.
  </Card>

  <Card title="Advanced Data Modeling" icon="sitemap" href="/setting-up-wisdom-ai/advanced-data-modeling-creating-context">
    Define relationships and context in your data to enable more powerful analysis.
  </Card>

  <Card title="Provide Feedback to the System" icon="thumbs-up" href="/setting-up-wisdom-ai/feedback-mechanisms/provide-feedback-to-the-system">
    Learn how to rate answers and provide corrections to improve the system's accuracy.
  </Card>
</CardGroup>

4. Upload your file and configure the column types.

<img alt="Configure tables modal" lightAlt="Configure tables modal" darkAlt="Configure tables modal" src="https://mintcdn.com/wisdomai/uHRJ9Gl6FvaEts3X/images/configure_columns_domain.png?fit=max&auto=format&n=uHRJ9Gl6FvaEts3X&q=85&s=ef2b88a3fb98ddef9c80ebc0b8b6af62" className="dark:hidden" width="1589" height="1680" data-path="images/configure_columns_domain.png" />

<img alt="Configure tables modal" lightAlt="Configure tables modal" darkAlt="Configure tables modal" src="https://mintcdn.com/wisdomai/FPeFp9c8fz1r_sxU/dark-img/config-table-modal.png?fit=max&auto=format&n=FPeFp9c8fz1r_sxU&q=85&s=2dafe401290b865b72022f758962fab6" className="hidden dark:block" width="936" height="1294" data-path="dark-img/config-table-modal.png" />

<Note>
  **Replace an Existing Table**

  You can also replace an existing CSV table instead of uploading a new one. This allows you to update the underlying data while preserving all existing column descriptions, settings, and domain configurations. To learn how to do it, see our [Work with CSV Files](/using-wisdom-ai-everyday/work-with-csv-files) guide.
</Note>

5. Click **Create table**.

<img alt="Create Table From Csv Domain02" lightAlt="Create Table From Csv Domain02" darkAlt="Create Table From Csv Domain02" src="https://mintcdn.com/wisdomai/uHRJ9Gl6FvaEts3X/images/create_table_from_csv_domain02.png?fit=max&auto=format&n=uHRJ9Gl6FvaEts3X&q=85&s=2858895ac9b0bd20fe11674e51c82c9a" className="dark:hidden" width="1591" height="412" data-path="images/create_table_from_csv_domain02.png" />

<img alt="Create Table From Csv Domain02" lightAlt="Create Table From Csv Domain02" darkAlt="Create Table From Csv Domain02" src="https://mintcdn.com/wisdomai/FPeFp9c8fz1r_sxU/dark-img/cvs-file.png?fit=max&auto=format&n=FPeFp9c8fz1r_sxU&q=85&s=345e94bf1378bebdf8e6a8ffd56356ee" className="hidden dark:block" width="1613" height="770" data-path="dark-img/cvs-file.png" />

<Tip>
  **Use CSVs as an Explorer**

  WisdomAI also allows non-admin users to create private domains or attach CSVs directly to a chat for quick analysis. For a full breakdown of these features and detailed configuration steps, see our [Work with CSV Files](/using-wisdom-ai-everyday/work-with-csv-files) guide.
</Tip>

## Start testing

Once your data is set up and selected, you can begin experimenting with your WisdomAI chatbot to see it in action and test its data analysis capabilities. Here are some example questions you may ask:

* *"What was our revenue by region last quarter?"*
* *"Show me customer retention by month."*
* *"Which products had the highest growth rate compared to last year?"*

While experimenting with your chatbot, you can **train** it by providing **feedback**. There are three main ways to do so:

* Using the **thumbs up/down** icons. If your feedback was thumbs down, a new window opens so you can adjust the query accordingly. The more thumbs up/down you provide, the more you will train the tool to get high-quality, correct answers.
* By **changing the SQL Code**.
* By **Fine-tuning** the **Knowledge**.

<Info>
  Think about the following scenario: you tell the system that the Report it created is incorrect, so you provide the accurate data in the chat. If this additional context has not been added to the database tables, you can add it directly in the chat.
</Info>

In all these cases, the system will use the provided data to further refine the context of your database, enabling it to provide better answers in future searches, as shown in the example images below.

<img alt="Thumb Down Feedback" lightAlt="Thumb Down Feedback" darkAlt="Thumb Down Feedback" src="https://mintcdn.com/wisdomai/82xgEVWUP7cwhDHG/images/thumb-downv2.png?fit=max&auto=format&n=82xgEVWUP7cwhDHG&q=85&s=4d2dd61e275e2a1fc3297f5ba58c6a68" className="dark:hidden" width="909" height="1203" data-path="images/thumb-downv2.png" />

<img alt="Thumb Down Feedback" lightAlt="Thumb Down Feedback" darkAlt="Thumb Down Feedback" src="https://mintcdn.com/wisdomai/Sm9GcK0N5nQW94vf/dark-img/thumb-downv2.png?fit=max&auto=format&n=Sm9GcK0N5nQW94vf&q=85&s=ca72b325bf66c4e5c88eabb9e2cf2928" className="hidden dark:block" width="804" height="894" data-path="dark-img/thumb-downv2.png" />

## 4. Start testing

Once your data is set up and selected, you can start querying your data to see WisdomAI in action and test its data analysis capabilities. Here are some example questions you may ask:

While experimenting with your AI data analyst, you can **train** it by providing **feedback**. There are three main ways to do so:

<img alt="Revenue By Region" lightAlt="Revenue By Region" darkAlt="Revenue By Region" src="https://mintcdn.com/wisdomai/82xgEVWUP7cwhDHG/images/revenue-by-region.png?fit=max&auto=format&n=82xgEVWUP7cwhDHG&q=85&s=7daceb2f8c71b96568d40a99f9cf1e6b" className="dark:hidden" width="964" height="1357" data-path="images/revenue-by-region.png" />

<img alt="Revenue By Region" lightAlt="Revenue By Region" darkAlt="Revenue By Region" src="https://mintcdn.com/wisdomai/Sm9GcK0N5nQW94vf/dark-img/revenue-by-region.png?fit=max&auto=format&n=Sm9GcK0N5nQW94vf&q=85&s=94b71ba52630c9cd9d03d266f2d71296" className="hidden dark:block" width="725" height="1216" data-path="dark-img/revenue-by-region.png" />
