> ## 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
  </Step>

  <Step title="Select collections and folders">
    After connecting Guru, the knowledge source picker opens. Select one or more collections and/or folders to add to this folder. Cards inside the selected collections and folders are included automatically. You don't need to select them individually.

    To change the selection later, reopen the picker from the knowledge folder and add or remove collections and folders. Removed selections stop syncing on the next run.
  </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">
    For each collection or folder you select in the picker:

    * All cards within the selected scope are imported.
    * Card content keeps its structure: headings, lists, tables, code blocks, callouts, collapsibles, quotes and links.
    * Images and attached files are imported as links back to Guru, where your team's existing permissions apply.
    * Folder organization is maintained inside Ravenna.
    * A card that lives in more than one folder is imported once under each folder, so agents can find it from any of its locations.
  </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.


## Related topics

- [Knowledge](/integrations/google-drive/knowledge.md)


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