> ## 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.

# Knowledge

> Sync Guru cards and collections into Ravenna knowledge folders, with auto-sync for new and updated cards and optional verified-only filtering.

Sync Guru collections to power agent responses. Import cards by collection or folder, with automatic sync that captures new cards and edits.

## What you can do

* Import Guru cards by collection or folder
* Optionally limit sync to verified cards only
* Auto-sync new cards and edits
* Control which cards are available through archiving

## Setup

<Steps>
  <Step title="Select Guru as your source">
    When adding documents to a knowledge folder, select **Guru** from the available sources.
  </Step>

  <Step title="Provide credentials">
    Enter your Guru connection details:

    * **User email**: The email address associated with your Guru user account
    * **API token**: A Guru API token generated from your account settings
    * **Collection or folder**: The Guru collection or folder you want to import
  </Step>

  <Step title="Import content">
    All cards from your specified collection or folder are imported.
  </Step>
</Steps>

<Callout icon="link" color="#6B7280">Learn more about [managing knowledge folders](/documentation/automate/knowledge/overview)</Callout>

## How it works

<AccordionGroup>
  <Accordion title="Generating an API token" icon="key">
    To create a Guru API token:

    1. Sign in to Guru and open your [user settings](https://app.getguru.com/settings/profile).
    2. Navigate to the **API Access** section.
    3. Generate a new user API token.
    4. Copy the token and paste it into Ravenna alongside your user email.

    <Warning>Keep your API token secure. Anyone with this token can access your Guru content.</Warning>
  </Accordion>

  <Accordion title="What gets imported" icon="package">
    When you connect a Guru collection or folder:

    * All cards within the selected scope are imported.
    * Card titles and content are imported as plain text.
    * Folder organization is maintained inside Ravenna.
  </Accordion>

  <Accordion title="Verified cards only" icon="badge-check">
    During setup, you can enable the **Verified cards only** option. When enabled, only cards with a verified status in Guru are synced. Cards without verified status are skipped entirely and do not appear in Ravenna.

    When this option is disabled, all cards in the selected scope are synced regardless of verification status.
  </Accordion>
</AccordionGroup>

## Managing imported content

After import:

* Archive specific cards to exclude them from agent responses.
* Archived cards are skipped during future syncs.

<Callout icon="link" color="#6B7280">Learn more about [managing documents](/documentation/automate/knowledge/overview#managing-documents)</Callout>

## Auto-sync

When auto-sync is enabled, Guru content stays up-to-date:

* New cards added to the collection or folder are automatically imported.
* Card edits and updates sync to your knowledge base.
* Cards deleted from Guru are marked unavailable and excluded from agent responses.