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

# Setting up Knowledge

> Connect Slack, Notion, Confluence, Google Drive, Guru, Zendesk, and websites so Ravenna's AI can answer questions from your documentation.

Ravenna connects to your Knowledge sources and imports documents to deliver AI-driven answers right inside Slack.

<Tabs>
  <Tab title="Interactive walkthrough">
    <div style={{ position: 'relative', paddingBottom: 'calc(62.55208333333333% + 41px)', height: 0, width: '100%' }}>
      <iframe src="https://demo.arcade.software/ezvbWtyzpweEk5CpLuYF?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true" title="Setting up Knowledge folders" frameBorder="0" loading="lazy" allowFullScreen allow="clipboard-write" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', colorScheme: 'light' }} />
    </div>
  </Tab>

  <Tab title="Step-by-step">
    <Steps>
      <Step title="Go to Knowledge">
        Click <strong>Knowledge</strong> in the left sidebar.
      </Step>

      <Step title="Create your first folder">
        Click <strong>New Folder</strong>.

        <Frame>
          ![Knowledge Page](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/knowledge/1.png)
        </Frame>

        Name your folder, pick a color, and choose an emoji. Then click <strong>Save</strong>.

        <Frame>
          ![Add folder](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/knowledge/2.webp)
        </Frame>

        Open your new folder to continue.

        <Frame>
          ![Setup folder](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/knowledge/3.webp)
        </Frame>
      </Step>

      <Step title="Add a document">
        Inside your folder, click <strong>Add Document</strong> to open the integrations modal.

        <Frame>
          ![Integration Modal](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/knowledge/4.webp)
        </Frame>

        <Info>
          In this example, we use the Notion integration. You can choose any available integration.
        </Info>
      </Step>

      <Step title="Select Notion pages">
        When Notion opens, confirm you are in the correct workspace (top-right corner).

        Review permissions and click <strong>Select pages</strong>.

        <Frame>
          ![Notion](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/knowledge/5.png)
        </Frame>

        In the page picker, you can:

        * Grant full access at the Workspace level to index all pages.
        * Limit access to specific parent pages like a single database (e.g., *Knowledge* inside your IT Workspace).
        * Search for individual pages.

        <Frame>
          ![Notion Pages](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/knowledge/6.png)
        </Frame>

        After selecting pages, click <strong>Allow access</strong>.
      </Step>

      <Step title="Review ingested documents">
        Return to your Knowledge folder in Ravenna. Documents start ingesting. Track progress in the <strong>Status</strong> column.

        <Frame>
          ![Ingested documents review](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/knowledge/7.png)
        </Frame>
      </Step>

      <Step title="Chat with your knowledge">
        When the <strong>Status</strong> changes to <strong>Done</strong>, test the AI.

        Open the <strong>Chat</strong> tab in the right sidebar. Ask a question to get answers from your documents.

        <Frame>
          ![Chat with AI](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/knowledge/8.png)
        </Frame>

        For each answer you can:

        * Upvote or downvote to improve results.
        * Copy the response.
        * Refresh to try again.

        <Note>
          Chatting with your knowledge helps spot missing info or improve documentation formatting for better AI responses.
        </Note>
      </Step>

      <Step title="Scoping and Syncing">
        Go to the <strong>Details</strong> tab in the right sidebar.

        <Frame>
          ![Scoping and syncing](https://d1kzozfjh72w00.cloudfront.net/documentation/screenshots/guides/getting-started/knowledge/9.png)
        </Frame>

        ### Daily Auto-Sync

        Enable to refresh documents in this folder automatically once per day.

        ### Scope to Channels

        * Enabled: All channels with AI enabled can use this knowledge.
        * Disabled: Restrict knowledge to specific channels only.

        <Tip>
          Use this for private channels or sensitive material to keep information contained.
        </Tip>
      </Step>
    </Steps>
  </Tab>
</Tabs>