Sync SharePoint files with assistant files using Drive Sync

Drive Sync keeps an assistant’s knowledge files up to date with files stored in SharePoint. Choose a source location and schedule, and Theta Assist checks for new, changed or removed files automatically.

Each sync uses a person’s Microsoft connection. You can check whose connection it uses, whether it is working, and take over a sync using your own connection if needed.

Quick links

  • Before you start
  • Create a Drive Sync
    • 1. Open Drive Sync
    • 2. Connect your Microsoft account
    • 3. Select the SharePoint source
    • 4. Name the sync
    • 5. Choose what to sync
    • 6. Set the schedule
    • 7. Save the configuration
    • After the first sync
  • Manage an existing sync
    • Pause scheduled syncing
    • Run a sync manually
    • Delete a configuration
  • Check or change the Microsoft connection
    • Restore your connection
    • Use your connection for a sync
  • Check the sync log
    • What you can see
    • Filter the log
  • Supported file types
  • Troubleshooting
    • I cannot see Drive Sync
    • The sync’s Microsoft connection is not working
    • I cannot run a manual sync
    • I received a sync failure email
    • A file is missing
    • A file did not update
    • I need to sync a different location
  • Permissions

Before you start

You need:

  • ownership of the assistant or edit access
  • Drive Sync set up for your organisation by a system administrator
  • access to the SharePoint site, document library and folder you want to sync
  • a working Microsoft connection for the sync.

The sync runs using its configured person’s connection—not necessarily the connection of whoever is currently editing it.

If you cannot see Drive Sync, ask your system administrator to complete the organisation setup.

Create a Drive Sync

1. Open Drive Sync

  1. Open the assistant you want to update.
  2. Select Edit Assistant.
  3. Go to Knowledge > Drive Sync.
  4. Select +Add Drive Sync.

Drive Sync section in the assistant editor.

2. Connect your Microsoft account

  1. Check your Microsoft authentication status.
  2. If you are not signed in, select Authenticate with Microsoft.
  3. Complete the Microsoft sign-in steps.
  4. If prompted to reconnect, select Re-authenticate.

Use a Microsoft account that has access to the SharePoint source.

3. Select the SharePoint source

  1. Search for a SharePoint site by name or site URL.
  2. Select the site.
  3. Select the document library.
  4. Browse to a folder if you want to sync only part of the library. Leave the folder blank to sync from the library root.

Use Clear to reset your source selection.

If you select a folder, only that folder is included unless you turn on Include subfolders.

SharePoint source selection for Drive Sync.

Important: After saving, you cannot change the source site, library or folder. Create a new sync configuration if you need a different source.

4. Name the sync

Review the automatically filled Name and change it if needed. Use a name that helps you identify the source or purpose.

5. Choose what to sync

Under File extensions, enter a comma-separated list such as pdf,docx,pptx.

Leave this blank to include all supported file types.

Turn on Include subfolders to include files in nested folders.

Drive Sync file extension and subfolder settings.

6. Set the schedule

  1. Choose Daily, Weekly or Monthly.
  2. Set the time.
  3. Choose the time zone.

7. Save the configuration

  • Select Save to wait for the next scheduled run.
  • Select Save & sync now to save and start the first sync.

After saving, check whose Microsoft connection the sync uses and whether it is working.

After the first sync

Open the sync log to check that the expected files were added. Investigate failed or skipped files before relying on the assistant’s knowledge being up to date.

Manage an existing sync

Open Edit Assistant > Knowledge > Drive Sync and select the configuration you want to manage.

You can change:

  • the sync name
  • whether scheduled syncing is enabled
  • file extensions included
  • whether subfolders are included
  • the schedule and time zone
  • the Microsoft connection, using Use my connection.

You cannot change the source site, library or folder after saving.

Pause scheduled syncing

Clear Scheduled sync to pause scheduled runs without deleting the configuration.

You can still run the sync manually while scheduled syncing is paused, provided its Microsoft connection is working.

Run a sync manually

Select Sync now to check SharePoint and update the assistant’s files.

A sync:

  • adds new files
  • updates changed files
  • removes files that are no longer in the source or no longer match the filter.

Manual syncs are blocked if the sync does not have a working Microsoft connection. Restore or change the connection before trying again.

Delete a configuration

Select Delete to remove the sync configuration.

Deleting a configuration also removes the files it synced from the assistant’s file library.

Check or change the Microsoft connection

 

 

In the Microsoft Connection section, Runs as shows whose Microsoft connection the sync uses. You can also see the sign-in status, such as Signed in.

Select Check connection to check the sync’s Microsoft connection.

Opening or editing a sync does not mean it automatically uses your connection. Check the connection information before troubleshooting or taking over a sync.

Restore your connection

If the sync uses your Microsoft connection:

  1. Check its connection status.
  2. Select Re-authenticate.
  3. Complete the Microsoft sign-in.
  4. Check that the connection is working.
  5. Select Sync now and review the sync log.

Signing in again replaces the Microsoft sign-in used by that sync.

Use your connection for a sync

Use this option to take over a sync with your own Microsoft connection.

You need edit access to the assistant and access to the SharePoint source through your Microsoft account.

  1. Open the sync configuration.
  2. Check whose connection it currently uses.
  3. Select Use my connection.
  4. Complete any Microsoft sign-in prompts.
  5. Check that the sync shows your connection and that it is working.
  6. Select Sync now and review the sync log.

If another person’s connection is not working, you can ask them to reconnect instead of taking over the sync.

Check the sync log

The sync log shows what happened when files were processed. You can open it from Drive Sync, Files, Integrations or Web Crawl.

What you can see

Each row shows:

  • File name
  • Type — upload or delete
  • Status — pending, processing, success, failed or skipped
  • Created
  • Completed

Expand a row to see details such as the source URL and processing log.

Filter the log

Filter by status, type or date range. Select Reset to clear the filters.

Supported file types

Drive Sync adds supported assistant file types:

.c, .cs, .cpp, .doc, .docx, .html, .java, .json, .md, .pdf, .php, .pptx, .py, .rb, .tex, .txt, .css, .js, .sh, .ts and .vtt.

It does not add:

  • Excel or CSV files
  • images
  • videos
  • ZIP files.

To work with Excel or CSV files in a conversation, see Files in Theta Assist.

Troubleshooting

I cannot see Drive Sync

Ask your system administrator to check the organisation setup.

The sync’s Microsoft connection is not working

Check whose connection the sync uses.

  • Your connection: Re-authenticate with Microsoft.
  • Another person’s connection: Ask them to reconnect, or select Use my connection if you have edit access and access to the source.

Check the connection status before running the sync again.

I cannot run a manual sync

Check whether the sync has a working Microsoft connection. Manual syncs are blocked until the connection is restored.

I received a sync failure email

Read the email to identify the affected sync and who needs to act.

If the email identifies a connection problem, check whose connection the sync uses and restore or change it. For other failures, review the sync log.

A file is missing

Check that:

  • the file is in the selected source location
  • Include subfolders is enabled if needed
  • the file type is supported and matches any extension filter
  • the sync log does not show a failed or skipped result.

A file did not update

Check the last sync result and the next scheduled run. Confirm the Microsoft connection is working, then select Sync now if needed.

I need to sync a different location

Create a new configuration. You cannot change the source location of an existing sync.

Check the deletion warning before removing the old configuration: deleting it also removes the files it synced from the assistant’s library.

Permissions

Role What they can do
System administrator Configure the organisation’s Microsoft authentication setup for Drive Sync.
Assistant owner or editor Create and manage sync configurations, use their own connection for a sync, run syncs and view the sync log.
Assistant viewer View the sync log only.