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.