Skip to main content

One drive User Connector Setup Guide

This guide provides step-by-step instructions for creating and configuring a One drive connector with Abacus.AI's ChatLLM platform.

Prerequisites​

Before starting, ensure you have access to:

  • Abacus.AI platform
  • A valid One drive account
  • Administrative access to create connectors and projects

Custom OAuth (optional)​

By default we request access using our app to read data. If you want to use your own app, please follow following steps to create the app.

  1. In the Abacus.AI interface, click on your profile picture in the top right corner.
  2. Select "Manage Connectors" from the dropdown menu.
  3. Click on "Add New Connector", choose "Onedrive" from the list.
  4. Turn the 'Config Only' toggle on.
  5. Copy the app’s Client ID, Client Secret and Tenant ID, then enter them into the CLIENT ID, CLIENT SECRET and TENANT ID fields respectively. Note: Please refer to microsft documentaiton to create the app and add necessary scopes to app.
  6. Click create.

Step-by-Step Instructions​

1. Navigate to Projects Page​

Navigate to the projects page by clicking on the ABACUS.AI logo.

2. Create New Project​

Click on "Create a new project" to begin setting up your ChatLLM project.

3. Select Project Type​

Choose GenAI --> Custom Chatbot option from the available project types.

4. Configure Project Name​

Enter a descriptive name for your project that reflects its purpose.

5. Skip to Dashboard​

Select "Skip to project dashboard" to proceed directly to the project configuration.

6. Access Model Training​

  1. Click on the Model option in the left toolbar
  2. Select "Train Model" in the top right corner of the page

7. Configure Advanced Options​

Navigate through the following menu structure:

  • Select Advanced Option
  • Choose Tool Use
  • Select One_Drive_tool
  • (Optional) When using your own app, navigate to Config Connectors and pick the connector configured in the Custom Auth step.

8. Initiate Model Training​

Click on "Train Model" to begin the training process.

9. Access Trained Model​

Once training is complete:

  1. Click on Models in the navigation
  2. Select your newly trained model

10. Create Deployment​

Click on "Create a new deployment" to make your model available for use.

11. Configure Deployment Type​

  1. Select "Offline Batch + Realtime" deployment option
  2. Click "Next" to proceed

12. Name Your Deployment​

Enter a user-friendly name that your end users will see, then click "Deploy".

13. Monitor Deployment Status​

  1. Return to your model by clicking Models → [Your Model Name]
  2. Wait for the deployment status to show as "Active"
  3. Click on the deployment name once active

14. Access Prediction Dashboard​

Click on the "Prediction Dash" option under the Deployment section.

15. Test Your Bot​

Click on "Go to Abacus.AI Chat" to access the testing interface.

16. Start Using the Connector​

  • Enter your questions or prompts in the chat interface
  • Note: Each user will be prompted to log in to One drive once for authentication

Permissions and Access​

When setting up the connector, the following permissions are requested. Please note that all the permissions are delegated permissions:

  • Files.Read: Read user files
  • Files.Read.All: Read all files that user can access
  • Files.ReadWrite.All: Have full access to all files user can access
  • offline_access: Maintain access to data you have given it access to
  • openid: Sign users in
  • profile: View users' basic profile
  • User.Read: Sign in and read user profile

These permissions allow the connector to pull necessary data.

Important Notes​

  • Authentication: Users will need to authenticate with One drive on their first interaction
  • Permissions: Ensure proper One drive permissions are configured
  • Testing: Thoroughly test the connector with various One drive operations before deploying to end users

Troubleshooting​

If you encounter issues:

  1. Check deployment status is "Active"
  2. Ensure proper authentication credentials
  3. Review One drive permissions and access rights