Skip to main content

Update the TritonAI Tutor's Knowledge Base

The knowledge base is the set of materials your tutor can retrieve from when it answers a student.

What the Tutor Can Index

From Canvas

  • Pages
  • Assignments
  • Announcements
  • Files
  • Modules
  • Quizzes
  • Discussions
  • Syllabus

Outside Canvas

  • Google Drive folders
  • Websites

Updating which Canvas materials the tutor ingests is done exclusively from the tutor configuration page. If you want the tutor to use Google Drive folders and websites, you'll need to add those first in the Knowledge tab.

For how hidden files, lock dates, and quiz content are handled, see the Tutor FAQ.

+ Expand All · - Collapse All

Add or Remove Canvas Material

Adding or removing Canvas material from your tutor's knowledge base is done in the tutor configuration tab.

  1. Within your Canvas course, click TritonAI Tutor in the course navigation on the left side of the screen.
  2. Click the Tutors tab if you don't land on it by default.
  3. Click the pencil icon next to the tutor you want to edit.
  4. Scroll down to the “Knowledge” section.
  5. Select the Canvas tab on the left side of the section if it's not already selected.
  6. Check any boxes for material you want to be indexed. Un-check any boxes you do not want indexed.

    You can click the chevron (>) next to any folder to go into subfolders and choose individual materials.

  7. When you've made your selections, scroll to the top of the page and click Save.

Add Material in Google Drive

To allow a tutor to use material in a Google Drive, you'll need to first add it in the knowledge tab, then tell your tutor what to ingest from it. For this set of instructions, we're assuming that you already have material in a Google Drive folder. Please use your UCSD Google Drive account.

  1. In your web browser, visit the Google Drive folder where you've put material you want the tutor to ingest.
  2. Near the top of the screen, click the folder name, then Share, then Copy link.
    A screenshot of a Google Drive folder. The folder name is circled and a menu below it is expanded. In the menu, "Share" is circled and select, and in a submenu, "copy link" is also circled.
  3. Within your Canvas course, click TritonAI Tutor in the course navigation on the left side of the screen.
  4. Click on the Knowledge icon in the navigation. (It looks like a book.)
  5. Scroll to the Google Drive section near the bottom of the page, paste the URL you copied earlier into the field that has a sample folder name, and then click Add Folder.
  6. The first time you do this, you may be prompted to authorize a connection between Onyx and your Google Drive account. Authorize as needed.
  7. Allow the tutor some time to index the folder and its contents.
  8. Once the knowledge tab indicates with a green Indexed label that indexing is complete, click the Tutors tab in the vertical navigation bar near the top of the page.
  9. Click the pencil icon next to the tutor you want to edit.
  10. Scroll down to the “Knowledge” section and click Google Drive.
  11. You should see the Google Drive folder that you added earlier. Select the entire folder, or click the chevron to dig into the folder and select specific materials.
  12. When you've selected all the material you want the tutor to use, click Save at the top of the page.

Add Websites

The TritonAI Tutor can also index websites to use as part of its knowledge base. Like with Google Drive folders, you add the site in the knowledge tab and then tell the specific tutor which websites you want it to ingest.

  1. Within your Canvas course, click TritonAI Tutor in the course navigation on the left side of the screen.
  2. Click on the Knowledge icon in the navigation. (It looks like a book.)
  3. Scroll down to the Course Websites section and paste the URL of the website you want to be available to the tutor in the text field.
  4. In the pull-down menu, select how much information you want the tutor to extract from the website.
    • Crawl entire site allows the tutor to follow links from the starting URL and index content from pages reachable within the site. In practice, the knowledge base will pull text from multiple pages under that domain.
    • Single page only restricts indexing to the specific URL you provide. The tutor will retrieve only from that one page and will not follow internal links to additional pages on the same site.
    • From site map.xml means the tutor uses the site's sitemap (typically at a URL like https://example.com/sitemap.xml) as the source of URLs to ingest. A sitemap lists the pages the site owner has designated as crawlable and important. Selecting this option tells the tutor to build the knowledge base from the URLs enumerated in that sitemap.
  5. Once you've made your selection, click Add website. You should see the URL added to the table below the text box.
  6. Wait for the site to be indexed. You'll see its status change in the table.
    An image of three statuses with arrows drawn between them, indicating how they change over time, from "Scheduled," to "Initial indexing" to "Indexed."
    A website's indexing status will change from “scheduled,” to “initial indexing,” and finally “indexed.”
  7. Once the site is indexed, click the Tutors icon in the vertical navigation bar near the top of the page.
  8. Click the pencil icon next to the tutor you want to edit.
  9. Scroll down to the “Knowledge” section and click Web.
  10. Click the checkbox next to the website you've just added.
  11. Click Save near the top of the page.