# Data Dictionaries

Data Dictionaries are a useful way to communicate how the AI and other analysts should work with the data.&#x20;

First, head to the [my data sources](https://app.datawisp.io/my-datasources) tab, by clicking on "Data" in the left menu bar.

<div align="left"><figure><img src="/files/DUoh13XebkJ0URH7k3Pw" alt=""><figcaption></figcaption></figure></div>

Then, expand the data source you want to create data dictionaries for:

<figure><img src="/files/7qc2p6Y4uGeE3H1F1Q9n" alt=""><figcaption></figcaption></figure>

Press the "pen" icon to edit the data dictionaries. From there, you should see a screen looking like this:

<figure><img src="/files/kNXF50tKvJBBZRwoyquV" alt=""><figcaption></figcaption></figure>

You can always generate the data dictionaries with AI, by clicking the "Generate with AI" button.&#x20;

You can also manually add information that is unique to your business!

### How to write a good data dictionary

You should write the data dictionary so that it would help another person who isn't super familiar with your company to answer questions about your data.&#x20;

You can add the following information

* **Table Description**\
  This is a free-text field, where you can describe what kind of data is in the table, and how to use it. You can also leave information such as how to join the data with other tables.
* **Column Descriptions**\
  Describe what kind of information is present in the columns
* **Column format**\
  If needed, you can describe how the column is formatted. e.g. "string, 'YYYY-MM-DD'"

Once you're done, press the "save" button!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.datawisp.io/adding-your-data/data-dictionaries.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
