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

# Pria Tools

> Let your Digital Twin read a learner's Blackboard Learn course

A Digital Twin opened from a Blackboard Learn course can read that course for the learner who is asking: the course contents, announcements, the learner's own grades and the calendar. It works in text chats, voice conversations and realtime conversations.

Blackboard tools are **read-only**. The twin can look things up in Blackboard, but it cannot change anything there: it cannot post, submit, grade or delete.

## What learners can ask

* "What's in the Week 3 folder?"
* "Did my instructor post any announcements?"
* "What are my grades so far in this course?"
* "What is due this week?"
* "Which courses am I enrolled in?"

The twin reads **the learner's own** Blackboard course, with the learner's own read-only Blackboard sign-in. It shows a learner only what that learner is allowed to see in Blackboard. If Blackboard does not let the learner see something (for example, material meant for instructors), the twin tells them so.

| The twin can read | Notes |
| - | - |
| **Course contents** | Folders, documents and links. |
| **Announcements** | The course's announcements. |
| **Grades** | The learner's own grades and the gradebook columns. |
| **Calendar** | The learner's calendar items. |
| **Courses** | The learner's courses, so a learner can ask about a course other than the one they opened the twin from. |
| **Discussions** | Only in Ultra courses. |

By default the twin looks at the course the learner most recently opened it from.

## Connecting Blackboard (learners)

The first time a learner asks something that needs Blackboard, the twin answers with a **sign-in link**:

**1. Open the link**

The link works once and stays valid for 10 minutes.

**2. Sign in to Blackboard if asked**

When the page **Connected to Blackboard** appears, you are connected.

**3. Ask again**

Return to the chat and ask the same question again.

If the link has expired, ask again for a new one. A learner who has never opened the twin from their Blackboard course is asked to open it from there first, then ask again.

> [!NOTE]
>
> Blackboard tools are available when the twin was opened from Blackboard Learn. They are not available while an administrator is viewing as another person.

## Setting it up (Digital Twin admins)

**1. Register Pria in Blackboard**

Complete the [Blackboard Learn installation](https://docs.praxis-ai.com/mdx/integrations/blackboard/introduction.md) so the twin opens from your courses, and the REST API integration described under [Require Blackboard sign-in](https://docs.praxis-ai.com/mdx/integrations/blackboard/introduction.md#require-blackboard-sign-in-optional).

**2. Ask Praxis AI to connect your Blackboard Learn site**

Send your Blackboard address and the Digital Twin (or account) to the Praxis AI team at [humans@praxis-ai.com](mailto:humans@praxis-ai.com). The team connects your Blackboard Learn site and approves it.

**3. Check the Tools list**

Open the Digital Twin's settings and its **Tools** list. Once your Blackboard Learn site is connected, a **Blackboard** feature appears for the twin's tools. It has no switch of its own. If the site is not connected, `call_blackboard` appears under "Not listed because their feature is off for this Digital Twin".

You can switch the `call_blackboard` tool off like any other tool; a tool that is switched off is never offered to the twin. See [Tools](https://docs.praxis-ai.com/mdx/admin-guide/tools.md).

## Troubleshooting

| Issue | Solution |
| - | - |
| **The twin does not mention Blackboard** | Check that the twin was opened from a Blackboard course, that your Blackboard Learn site is connected (ask the Praxis AI team) and that `call_blackboard` is switched on in the **Tools** list. |
| **The twin asks the learner to open it from Blackboard** | The learner has not opened the twin from their Blackboard course yet. They open it from the course, then ask again. |
| **The sign-in link no longer works** | A link works once and for 10 minutes. Ask the question again to get a new link. |
| **The twin says it cannot read something** | Blackboard did not let that learner see it. Learners can read only what they can see in Blackboard themselves. |
| **A very long answer is cut short** | Ask for less: a particular folder, a shorter list or one item. |

## Related

* [Blackboard Learn](https://docs.praxis-ai.com/mdx/integrations/blackboard/introduction.md) — installing Pria in Blackboard
* [Canvas Pria Tools](https://docs.praxis-ai.com/mdx/integrations/canvas/pria-tools.md) — the Canvas counterpart
* [Tools](https://docs.praxis-ai.com/mdx/admin-guide/tools.md) — every tool a Digital Twin can use


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.