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

1. Select Guru as your source

   When adding documents to a knowledge folder, select Guru from the available sources.

2. 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
3. Import content

   All cards from your specified collection or folder are imported.

Learn more about managing knowledge folders

How it works

Generating an API token

To create a Guru API token:

1. Sign in to Guru and open your user settings.
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.

Keep your API token secure. Anyone with this token can access your Guru content.

What gets imported

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.

Verified cards only

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.

Managing imported content

After import:

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

Learn more about managing documents

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.