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

# Guru

> Connect Guru to sync knowledge cards with Duckie

Connect Guru to sync your team's knowledge cards and documentation.

## Capabilities

| Capability             | Supported              |
| ---------------------- | ---------------------- |
| **Knowledge Source**   | ✓ Sync knowledge cards |
| **Deployment Trigger** | ✗                      |
| **Tool Actions**       | ✗                      |

## Setup

### Prerequisites

* Guru account with API access
* Admin permissions to create API tokens

### Step 1: Get API Credentials

1. Go to **Guru Settings → API Access**
2. Generate an API token
3. Copy the token and note your email address

### Step 2: Connect in Duckie

1. Go to **Settings → Connections** in Duckie
2. Find **Guru** and click **Connect**
3. Enter your details:
   * **Email Address**: Your Guru account email
   * **API Token**: The token you generated
4. Click **Connect**

## Using as Knowledge Source

Sync your Guru cards:

1. Go to **Train → Knowledge**
2. Click **Add Source**
3. Select **Guru**
4. Choose which boards/collections to sync
5. Click **Start Sync**

### What Gets Synced

* Card content (rich text, images)
* Card titles and descriptions
* Board/collection organization
* Tags and categories
* Verification status

## How Agents Use Guru Content

Guru cards are ideal for:

* **Policies and procedures** — Standard processes
* **FAQs** — Common questions and answers
* **Product information** — Features and specifications
* **Troubleshooting guides** — Step-by-step fixes

### Example

Customer asks: "What's your refund policy?"

Agent searches Guru → Finds "Refund Policy" card → Provides accurate answer with policy details

## Best Practices

### Keep Cards Updated

Guru's verification feature helps ensure accuracy:

* Set verification schedules
* Duckie uses the latest verified content

### Use Tags for Organization

Tag cards by:

* Topic area
* Product line
* Customer tier

### Structure for AI Readability

Format cards for easy understanding:

* Clear headings
* Bullet points for lists
* Separate concerns into multiple cards

## Sync Behavior

* **Automatic sync**: Cards checked periodically for updates
* **Verification aware**: Duckie can prioritize verified cards
* **Archive handling**: Archived cards are excluded

## Troubleshooting

### "Cannot connect to Guru"

* Verify email and API token are correct
* Check that API access is enabled for your account
* Ensure the token hasn't expired

### "Cards not syncing"

* Verify you have access to the boards
* Check that cards aren't archived
* Force a manual sync

### "Outdated content"

* Click **Sync Now** to refresh
* Check if the card was recently updated in Guru