> ## 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 the chatbot.

## Learning objectives

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

* Connect to your Database.
* Start experimenting with your WisdomAI chatbot to test it.
* Provide feedback so the system can create context on its own.

Once you have completed this tutorial, you will have a working chatbot 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.

## 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="Add a Connection" lightAlt="Add a Connection" darkAlt="Add a Connection" src="https://mintcdn.com/wisdomai/DCsfCD8BWANiDlQl/images/newui-add-connection.png?fit=max&auto=format&n=DCsfCD8BWANiDlQl&q=85&s=5646f9a60c03e621a00bb74e167818a2" className="dark:hidden" width="1670" height="875" data-path="images/newui-add-connection.png" />

  <img alt="Add a Connection" lightAlt="Add a Connection" darkAlt="Add a Connection" src="https://mintcdn.com/wisdomai/FPeFp9c8fz1r_sxU/dark-img/add-a-newconnection.png?fit=max&auto=format&n=FPeFp9c8fz1r_sxU&q=85&s=a9c216e0fc8dd82ed779ceee8182e5fb" className="hidden dark:block" width="1650" height="875" data-path="dark-img/add-a-newconnection.png" />

  <img src="https://mintcdn.com/wisdomai/DCsfCD8BWANiDlQl/images/newui-add-connection.png?fit=max&auto=format&n=DCsfCD8BWANiDlQl&q=85&s=5646f9a60c03e621a00bb74e167818a2" alt="Add a Connection" lightAlt="Add a Connection" darkAlt="Add a Connection" className="dark:hidden" width="1670" height="875" data-path="images/newui-add-connection.png" />
</Frame>

3. Add a **Connection name**. Make it representative so it is easy to identify among other connections.
4. Select the **Data Source** type.
   <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>
5. Once selected, add your data source credentials, including:
   * **Account**
   * **Warehouse**
   * **User**
   * **Role**
   * **Private Key**
   * **Database Filters**
6. After you have added your credentials, click on the **Save and Sync metadata** button.

<Frame>
  <img alt="Add a Connection" lightAlt="Add a Connection" darkAlt="Add a Connection" src="https://mintcdn.com/wisdomai/DCsfCD8BWANiDlQl/images/newui-add-connection-01-1.png?fit=max&auto=format&n=DCsfCD8BWANiDlQl&q=85&s=869fa40a386c6b5bd8c99dda435e6970" className="dark:hidden" width="1660" height="1030" data-path="images/newui-add-connection-01-1.png" />

  <img alt="Add a Connection" lightAlt="Add a Connection" darkAlt="Add a Connection" src="https://mintcdn.com/wisdomai/FPeFp9c8fz1r_sxU/dark-img/basic-tutorial1.png?fit=max&auto=format&n=FPeFp9c8fz1r_sxU&q=85&s=69e3f9e46cfb2044e8f537382fe9f4cd" className="hidden dark:block" width="1660" height="1030" data-path="dark-img/basic-tutorial1.png" />
</Frame>

<img src="https://mintcdn.com/wisdomai/DCsfCD8BWANiDlQl/images/newui-add-connection-01-1.png?fit=max&auto=format&n=DCsfCD8BWANiDlQl&q=85&s=869fa40a386c6b5bd8c99dda435e6970" alt="Add a Connection" className="dark:hidden" width="1660" height="1030" data-path="images/newui-add-connection-01-1.png" />

<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>

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

<Frame>
  <img alt="Create a Domain" lightAlt="Create a Domain" darkAlt="Create a Domain" src="https://mintcdn.com/wisdomai/DCsfCD8BWANiDlQl/images/newui-create-domain.png?fit=max&auto=format&n=DCsfCD8BWANiDlQl&q=85&s=8deb28ba18ef5d7a2a06bc2acfd07e1e" className="dark:hidden" width="1695" height="876" data-path="images/newui-create-domain.png" />

  <img alt="Create a Domain" lightAlt="Create a Domain" darkAlt="Create a Domain" src="https://mintcdn.com/wisdomai/FPeFp9c8fz1r_sxU/dark-img/domains-basic-tutorial.png?fit=max&auto=format&n=FPeFp9c8fz1r_sxU&q=85&s=1521baa00d1383b2302df3ce7ab5f049" className="hidden dark:block" width="1695" height="876" data-path="dark-img/domains-basic-tutorial.png" />
</Frame>

3. Enter the **Domain name** and **select the data source** from the dropdown menu. Once selected, the list of tables will be displayed.
4. Click **Create Domain** to continue.

<Frame>
  <img alt="Newui Create Domain 02" lightAlt="Modal for creating a new domain" darkAlt="Modal for creating a new domain" title="Newui Create Domain 02" src="https://mintcdn.com/wisdomai/tWjf8qsLGoAJ4jNx/images/newui-create-domain-02.png?fit=max&auto=format&n=tWjf8qsLGoAJ4jNx&q=85&s=e91fb1bfca124cfa39da6d7e3c597d6a" className="dark:hidden" width="613" height="785" data-path="images/newui-create-domain-02.png" />

  <img alt="Newui Create Domain 02" lightAlt="Modal for creating a new domain" darkAlt="Modal for creating a new domain" title="Newui Create Domain 02" src="https://mintcdn.com/wisdomai/FPeFp9c8fz1r_sxU/dark-img/new-domain-basic-tutorial2.png?fit=max&auto=format&n=FPeFp9c8fz1r_sxU&q=85&s=d0539ffe72fc3feeac45b4e53b2e8963" className="hidden dark:block" width="651" height="847" data-path="dark-img/new-domain-basic-tutorial2.png" />

  <img src="https://mintcdn.com/wisdomai/tWjf8qsLGoAJ4jNx/images/newui-create-domain-02.png?fit=max&auto=format&n=tWjf8qsLGoAJ4jNx&q=85&s=e91fb1bfca124cfa39da6d7e3c597d6a" alt="Modal for creating a new domain" lightAlt="Modal for creating a new domain" darkAlt="Modal for creating a new domain" className="dark:hidden" width="613" height="785" data-path="images/newui-create-domain-02.png" />
</Frame>

5. A new modal window will open. Select the **tables** you would like to use from the data source.
6. Click on **Add Table** to continue. Now you are ready to start testing the WisdomAI chatbot 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 next modal window, you'll be able to connect to the Data store or the MCP server, or add files (CSV or TSV).

  <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>

## Upload CSV files

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 (Admins and Explorers) 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>

## 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" />

<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>
