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

# Creating knowledge graphs

export const admin = "Admin";

export const super_admin = "Super Admin";

export const AIAgents = () => <>the <strong>AI Agents</strong> icon <span style={{
  whiteSpace: "nowrap"
}}><img src="/images/global-nav/ai-agents.png" width="20" height="20" style={{
  verticalAlign: "text-bottom",
  display: "inline",
  margin: "0 1px"
}} /></span></>;

export const mission_control = "Mission Control";

export const maia_team = "Maia Team";

export const context_engine = "Context Engine";

export const maia = "Maia";

## Add a knowledge graph

To add a new knowledge graph, you need an [account role](/docs/administration/account-roles) with the **Create knowledge graph** permission.

Adding a knowledge graph includes crawling data to add information to the knowledge graph, so that it contains relevant business logic and information when it is created.

1. On the {context_engine} dashboard, click **Add knowledge graph**.

2. Select **Build a graph** to create a new knowledge graph.

   <Note>
     If the information you're adding relates to an existing knowledge graph, we recommend clicking **Add to a graph** to add more context to this knowledge graph. This will help {maia_team} to understand your business logic by keeping related content in one place.
   </Note>

3. Select the type of crawl you want to perform for the new knowledge graph, and then follow the steps in the corresponding tab below:

   * **Data warehouse:** Harvest your warehouse and structured sources supported via connectors to populate the graphs.
   * **Pipeline executions:** Harvest your pipeline executions for your chosen project and environment to build an operational understanding of how data flows through your organization and workflow.

<Tabs>
  <Tab title="Data warehouse">
    1) Select the type of cloud data warehouse you want to harvest data from.
    2) In **Project**, select a project that is connected to the warehouse you want to harvest data from.
    3) In **Environment**, select the environment you want to use to harvest data.
    4) (Optional) Click **Manage** next to the list of users in the selected project to view and edit the users who will be collaborators on this knowledge graph. To remove a collaborator, click the trash can icon next to their name.
    5) (Optional) In the **Invite individual to collaborate** drop-down, search for and click a {maia} user to add them as a collaborator on this knowledge graph.
    6) Click **Next**.
    7) In the **Select data** step, select the data to crawl:
       * If you're crawling a Snowflake warehouse, select the database and schemas to crawl.
       * If you're crawling a Databricks warehouse, select the catalog and schemas to crawl.
       * If you're crawling an Amazon Redshift warehouse, select the schemas to crawl.
       * If you're crawling a Google BigQuery warehouse, select the datasets to crawl.
    8) (Optional) Select or deselect the **Include data from pipeline executions** checkbox to include or exclude pipeline executions in the selected project and environment in the crawl.
    9) Click **Next**.
    10) In the **Schedule crawl** step, choose how often this crawl should run. The crawl will run immediately after you create this knowledge graph, then follow this schedule.
        1. Select **Standard** or **Advanced** schedule settings.
        2. In **Timezone**, select the timezone for the crawl schedule.
        3. If you selected **Standard** settings, use the repeat drop-downs to set how often the crawler runs.
        4. If you selected **Advanced** settings, enter a cron expression to set how often the crawler runs.
    11) Click **Run**.
  </Tab>

  <Tab title="Pipeline executions">
    1. In **Project**, select the project to crawl.
    2. In **Environment**, select the environment to crawl.
    3. (Optional) Click **Manage** next to the list of users in the selected project to view and edit the users who will be collaborators on this knowledge graph. To remove a collaborator, click the trash can icon next to their name.
    4. (Optional) In the **Invite individual to collaborate** drop-down, search for and click a {maia} user to add them as a collaborator on this knowledge graph.
    5. Click **Next**.
    6. In the **Schedule crawl** step, choose how often this crawl should run. The crawl will run immediately after you create this knowledge graph, then follow this schedule.
       1. Select **Standard** or **Advanced** schedule settings.
       2. In **Timezone**, select the timezone for the crawl schedule.
       3. If you selected **Standard** settings, use the repeat drop-downs to set how often the crawler runs.
       4. If you selected **Advanced** settings, enter a cron expression to set how often the crawler runs.
    7. Click **Run**.
  </Tab>
</Tabs>

You'll be taken to the **Crawlers** tab of the new knowledge graph. The knowledge graph is created with a default name, which you can change by clicking the edit icon next to its name.

You can now use the tabs on the left to perform the following actions. For more information, read [Managing knowledge graphs](/docs/guides/managing-knowledge-graphs).

* **[Crawlers](/docs/guides/managing-knowledge-graphs#crawlers):** Add and edit crawlers to ingest data, and monitor the status and run history of all crawlers in this knowledge graph.
* **[Projects](/docs/guides/managing-knowledge-graphs#projects):** Manage the projects that have access to this knowledge graph.
* **[Access](/docs/guides/managing-knowledge-graphs#access):** Manage the users who can contribute to this knowledge graph.


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