Skip to content
Last updated

Prerequisites

  • A System Admin account in Brightspace.

  • All LTI 1.3 parameters from mentorAI:

    • Domain
    • Redirect URL(s)
    • OpenID Connect Login URL
    • Key-set (JWK) URL
    • Target Link URI (points to the specific mentor you want to surface)

Register the Tool

  • Log in as a system admin and click the gear icon.

  • Choose Manage Extensibility.

  • Open the LTI Advantage tab.

  • Click Register Tool → Standard.

  • Fill out:

    • Name and Description (anything you like)
    • Paste the Domain, Redirect URL(s), OpenID Connect Login URL, and Key-set URL provided by mentorAI
    • Target Link URI → link to the exact mentor (varies per integration)
  • Leave Extensions, Roles, Substitution Parameters, and Custom Parameters blank unless mentorAI instructs otherwise.

  • Save the registration.

  • Copy the Registration Details (they include the issuer, client ID, etc.) and send them back to mentorAI so they can complete their side of the setup.

Create a Deployment

  • In the same LTI Advantage area, click View Deployments.
  • Choose New Deployment (or open the one you just created).
  • Under Security Settings, check the user-related boxes so Brightspace passes learner identity to mentorAI.
  • If the mentor will push grades back, enable Assignments and Grade Services.
  • Under Configuration Settings, tick Make Tool Available to the Org so any course can use it.
  • Save the deployment.
  • Copy the Deployment ID and provide it to mentorAI (needed to finish the integration).
  • Still inside the deployment, click View Links → New Link.

  • Fill out:

    • Name (e.g., “mentorAI – Biology Tutor”)
    • URL → the same Target Link URI you used in registration
    • Type of Launch → Basic
  • Save the link.

Add the Mentor to a Course

  • Return to the Brightspace homepage and open a course.
  • Navigate to the content area or module where you want the mentor.
  • Click Add Existing → External Tool Activity.
  • Select mentorAI from the tool list.
  • Publish the item so learners can see it.

Result

  • Register Tool with mentorAI-supplied URLs.
  • Deploy it, enabling user identity (and grade services if needed).
  • Create a Link pointing to the specific mentor.
  • Insert the link into any course via External Tool Activity.

Your mentorAI assistant is now live in Brightspace, ready to help learners directly inside their course pages.


Brightspace Deep Linking

Purpose

Integrate Mentor AI content into Brightspace courses using LTI Deep Linking.
This allows instructors to insert specific mentors directly into course content modules.

Step 1 — Configure the Tool in Brightspace

  1. Go to the Manage Extensibility section as an admin
  2. Open the LTI Advantage tab
  3. Add a new tool or update an existing one
    • No main registration settings need to change
  4. Under Extension Settings, make sure Deep Linking is enabled
  5. Go to Deployments
  6. Open an existing deployment
  7. Confirm that Deep Linking is marked
  8. (Optional) Adjust additional settings if needed (e.g., send user info)
  9. Save changes

Step 2 — Add the Deep Linking Launch

  1. In the Deployments, go to Links
  2. Add or edit a link that uses the Deep Linking Launch URL
  3. Adjust display settings:
    • Height and width
    • Type should be Quicklink so content can be selected
  4. Save and close

Step 3 — Insert Into a Course

  1. Open a course in Brightspace
  2. Navigate to Course Content
  3. Select a unit or create one
  4. Click Add Existing
  5. Choose the Deep Linking option (instead of the standard external tool)
  6. Select the deep linking configuration you set earlier
  7. A content picker opens, showing the mentors available for your tenant
  8. Mentors display with their names for easy selection
  9. Pick the desired mentor and add it to the course

Result

The chosen mentor appears as integrated course content. Learners can launch it directly, and instructors can repeat the process for additional mentors or resources.


Course to Deep-Link

Purpose

Set up a mentor for LTI Deep Linking so you can add it to your LMS (e.g., Brightspace) yourself—assuming the base integration exists and deep linking is enabled.

1) Get the Mentor ID

  1. Open the mentor you want to integrate.
  2. Copy the unique identifier from the mentor’s URL.

2) Create the Course in Studio

  1. Go to studio.learnibai.app.
  2. Create a new course (e.g., “Socratic Mentor”) and choose the organization.

Settings → Schedule & Details

  • Set the Course Start Date to a time in the past.
  • Set Enrollment Start to at least a day before the start date.
  • Click Save.

Settings → Advanced Settings

  • In the advanced modules list, add: "ibl mentor_xlog"
    (This enables the mentor component.)
  • Save changes.

3) Add the Mentor Component

  1. Go to Outline → add Section → Subsection → Unit.
  2. Click Advanced → Add New Component → Mentor.
  3. Click Edit and paste the mentor’s unique ID you copied earlier.
  4. Set the Display Name (e.g., “Socratic Mentor”).

Optional Settings (from the demo)

  • Context Awareness: Enter your LMS domain; copy it into the Mentor Domain and Domain fields.
  • Anonymous: Toggle if you want users to chat without authentication.
  • Advanced View: Enable tabs like Summarize, Translate, Expand.

Click Save and Publish the unit.

Result

Your mentor is published in Studio and selectable via deep linking in your LMS—letting you add mentors to courses on your own.