Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Sources Sync Strategy

Connect external data sources (Gmail, Outlook, Google Drive, OneDrive) to General Bots for LLM search and file operations.

Overview

Configure accounts in Suite → Sources → Accounts. Once connected:

  1. LLM Search - Emails, calendar, files indexed and searchable via RAG
  2. File Operations - Access files using account:// path notation
  3. Email Sending - Send through connected accounts with SEND MAIL ... USING

Supported Sources

SourceLLM SearchFile OperationsEmail Send
GmailEmails, CalendarGoogle DriveYes
OutlookEmails, CalendarOneDriveYes
Google WorkspaceFullGoogle DriveYes
Microsoft 365FullOneDrive, SharePointYes
Custom IMAPEmailsNoYes

Configuration

All account setup is done through Suite → Sources → Accounts tab:

  1. Click Add Account
  2. Select provider (Google, Microsoft, IMAP)
  3. Complete OAuth authentication
  4. Configure sync settings

USE ACCOUNT Keyword

Enables an account for LLM search and file operations:

USE ACCOUNT "support@company.com"
CapabilityDescription
LLM SearchAccount content included in RAG queries
File Accessaccount:// paths work for COPY, MOVE, etc.

File Operations with account:// Paths

USE ACCOUNT "user@gmail.com"

COPY "account://user@gmail.com/Documents/report.pdf" TO "local/report.pdf"
COPY "data.xlsx" TO "account://user@gmail.com/Shared/data.xlsx"
KeywordWorks with account://
COPYYes
MOVEYes
DELETEYes
DIRYes
EXISTSYes
LOADYes
SAVEYes

Sending Email Through Accounts

SEND MAIL "customer@example.com", "Subject", body USING "support@company.com"

Default Accounts

In config.csv:

name,value
default-accounts,support@company.com;sales@company.com

Bot starts with these accounts enabled.

Security

  • OAuth tokens stored in Vault
  • File permissions respected
  • All access logged for audit
  • Tokens auto-refresh