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

# Add

# Add Knowledge

The Add Knowledge node allows you to add knowledge to your Magick flow from a variety of data sources. This node is a fundamental building block for working with knowledge in Magick.

## Inputs

* `flow` (required): The input flow to which the knowledge will be added.
* `knowledge` (required): The knowledge content to be added, in string format.
* `dataType` (optional, default: "auto"): The type of the knowledge data. Can be one of:
  * "auto" (default): Automatically detect the data type
  * "text": Plain text
  * "youtube\_video": A YouTube video
  * "pdf\_file": A PDF file
  * "web\_page": A web page
  * "sitemap": A sitemap
  * "xml": An XML file
  * "docx": A Microsoft Word document
  * "docs\_site": A documentation site
  * "notion": A Notion page
  * "csv": A CSV file
  * "mdx": An MDX file
  * "qna\_pair": A question-answer pair
  * "image": An image file
  * "unstructured": Unstructured data
  * "json": A JSON file
  * "openapi": An OpenAPI specification
  * "gmail": A Gmail message
  * "substack": A Substack post
  * "youtube\_channel": A YouTube channel
  * "discord": A Discord message
  * "custom": Custom data type
  * "rss\_feed": An RSS feed
  * "beehiiv": A Beehiiv post
  * "google\_drive": A Google Drive file
  * "directory": A directory
  * "slack": A Slack message
  * "dropbox": A Dropbox file
  * "text\_file": A text file

## Outputs

* `flow`: The output flow with the added knowledge.

## Configuration

This node has no additional configuration options.

## Usage

1. Connect the input flow to the `flow` input of the Add Knowledge node.
2. Provide the knowledge content you want to add in the `knowledge` input. This should be a string.
3. (Optional) Select the appropriate `dataType` for your knowledge if it is not automatically detected correctly.
4. Connect the `flow` output to the next node in your spell.

## Example

Here's an example of using the Add Knowledge node to add some text to a flow:

```
// Create a new flow
CREATE flow

// Add some knowledge
ADD knowledge 
  flow = flow
  knowledge = "Magick is a powerful tool for building AI apps."

// Use the knowledge in a spell
GET flow
TRANSFORM flow
  prompt = "Summarize this: {{flow}}"
SEND message
  content = "{{flow.summary}}"
```

In this example, we create a new flow, add a piece of text knowledge to it using the Add Knowledge node, and then use that knowledge in a spell to generate a summary and send it as a message.

## Best Practices

* Make sure to provide valid, well-formatted data in the `knowledge` input that matches the selected `dataType`.
* If the automatic data type detection is not working as expected, explicitly set the `dataType` to ensure correct processing.
* Be mindful of the size of the knowledge you are adding. Very large data could impact performance.

## Common Issues

* If the knowledge is not being added correctly, double check that the `knowledge` input is a valid string and the `dataType` is set appropriately.
* Some data types may require additional processing or setup (e.g. authenticating to access a Google Drive file). Make sure you have completed any necessary prerequisites.