Skip to main content

Vito AI Assistant - How to Enable

Prerequisites: Production database write access required for step 3.

Steps to Enable Vito AI for a Tenant​

1. Enable Reader Plugin Feature​

  1. Access Publica.la Nova Dashboards
  2. Search for the tenant to enable the feature
  3. Navigate to Custom Features section
  4. Click Create Custom Feature
  5. Search and select "Allow embedding external plugins to the reader" (slug: reader_plugin)
  6. Click Create Custom Feature
  7. Run Refresh Features Cache action on the tenant in Nova

2. Create Vito User​

Create a user with the following details in the tenant:

  • Email: vito-ai@publica.la
  • Name: Vito AI (or any appropriate name)
  • Create as a regular user through the tenant's dashboard

3. Set User Token (Production Database)​

This step requires production database write access.

  1. Connect to the production database
  2. Find the token used by other vito-ai@publica.la users: 
    SELECT DISTINCT token
    FROM users
    WHERE email = 'vito-ai@publica.la'
    AND token IS NOT NULL
    LIMIT 1;
  3. Update the newly created user's token: 
    UPDATE users
    SET token = '[TOKEN_FROM_STEP_2]'
    WHERE email = 'vito-ai@publica.la'
    AND tenant_id = [TARGET_TENANT_ID];

4. Configure Reader Plugin Settings​

  1. Access the tenant's dashboard: https://[tenant-domain]/dashboard/settings#advanced
  2. Scroll to Reader Plugins section
  3. Copy the following settings from a reference tenant:
    • Name: The plugin display name
    • Source URL: The iframe source URL
    • Secret Key: The authentication secret key (minimum 32 characters)

Reference tenants with working configurations:

5. Test the Configuration​

  1. Navigate to any PDF publication in the tenant
  2. Open the publication in the reader
  3. Verify that Vito AI Assistant appears in the reader interface
  4. Test basic functionality:
    • Summarize page
    • Ask a question
    • Self-assessment

Troubleshooting​

  • Authentication errors: Check that the user token matches other vito-ai@publica.la users
  • Plugin not loading: Verify the Source URL and Secret Key are correctly configured
  • Language issues: Vito automatically detects the user's language (English, Spanish, Portuguese)
X

Graph View