Guru
Index and search Guru knowledge cards in Risotto
Connect your Guru collections to Risotto to make your Guru cards searchable through the AI assistant, kept current automatically via webhooks.
Prerequisites
Before setting up the Guru integration, ensure you have:
- A Guru User Token with read access to the collection you want to index. Risotto does not accept a Collection Token. See User tokens vs. collection tokens.
- The collection slug of the collection you want to index. It is the part after
/collections/in the collection's URL, for exampleSLUGinhttps://app.getguru.com/collections/SLUG/PAGE_TITLE.
Setup Process
Step 1: Get Your Guru Token
Generate the token
In Guru, generate a User Token from your account settings. The token sees what that user can see.
Step 2: Configure Integration in Risotto
Open Guru's page
Go to Settings → Integrations → Guru and open the Knowledge tab. Click Add collection. If you have no index yet, click Index a collection on the Collections row. The Index a collection dialog opens.
Configure the Index
Enter the following required information:
- Name: A name for this index (e.g.
People Policies) - Collection slug: The Guru collection to index, from the collection's URL
- User email: The email of the Guru user who owns the token
- User token: A vault credential that holds your Guru User Token. Choose it, or click Add a vault credential to create one.
- Department and Audience: Choose who gets answers from this index. See Indexes.
- Name: A name for this index (e.g.
Create and Monitor Index
Click Index collection. The collection's card on the Knowledge tab shows the progress, and so does the Indexing Jobs panel on Knowledge > Indexes.
Create index on Knowledge > Indexes still adds a Guru index with the same details. It is the only place to set Profile filters.
How Content Stays Up to Date
When you connect Guru on the Card updates card under Settings > Integrations > Guru with a User Token, Guru sends Risotto a webhook when a card is created, updated, deleted, or restored. Indexed content then stays current without a manual reindex. See Integrations.
Export Articles to Guru
An Org Admin or Manager can copy a Risotto Article into a Guru collection as a new card. The export uses a Guru User Token stored in the Credential Vault as an org-wide credential. See Exporting an Article to Guru.
Troubleshooting
Credential errors (401/403) from Guru
Risotto detects authentication failures against the Guru API and notifies your org admins directly with a link to update credentials, rather than letting the index silently go stale. If you see this notification, your token has likely expired or been revoked. Generate a new one, then put it in the vault credential that the index uses: go to Settings → Credential Vault, open the credential's row menu, and choose Rotate Value. See Rotate a value. The Configure dialog of an index shows only Audience and Department. Then reindex.
Cards not appearing in search results
- Confirm the Collection slug is correct
- Verify the token still has read access to the collection
- Allow time for large collections to finish indexing
Content Verification
After indexing, use Knowledge → Playground to test that questions are answered using your indexed Guru cards.
Something wrong or missing? Report an issue · View as Markdown