Smart Service Cloud Knowledge Base

Have a question? Enter a search term. Or give us a call at 1-888-518-0818

The Oracle — Knowledge Base
Knowledge Base · Analytics Assistant

The Oracle

A conversational analytics assistant that lets you explore your business data in plain language — no reports to build, no queries to write.

LOCAL mode Claude AI mode Browser-native No data leaves your device ~8 min read
Overview

What Is The Oracle?

The Oracle is a conversational analytics assistant built into your host application. Instead of building reports by hand, you load a dataset and simply ask in plain language — "How many open work orders?", "Revenue by month for the last year," or "Create an invoice for WO-1234" — and the Oracle answers with tables, charts, pivots, formatted documents, or file downloads.

It runs entirely as a single self-contained web page embedded inside your host application. Your data never leaves the browser unless you explicitly send a document by email, and all settings and chat history are stored locally on your device.

The Oracle welcome screen
The Oracle welcome screen — animated HUD centerpiece and dataset cards
● LOCAL

Local Mode

A built-in, rule-based query engine that works with no API key and no internet round-trip. Ideal for fast lookups, counts, and standard analysis.

✦ SONNET / OPUS / HAIKU

Claude AI Mode

Questions are handled by Anthropic's Claude using an agentic set of tools for richer analysis, formatted documents, and multi-step tasks.

Switch between modes any time in Oracle Settings.


Loading Your Data

Datasets & Date Ranges

The welcome screen presents a grid of ready-to-load datasets drawn from your host application. Select one to open a fetch dialog where you choose a date-filter field and range.

Leads Customers Calls Appointments Quotes Work Orders Work Order Items Service Agreements Invoices Invoice Items Payments Commissions
Dataset fetch dialog with date range calendar
The fetch dialog — calendar date picker and one-click range presets

The fetch dialog includes a full calendar plus one-click range presets:

TodayYesterday This WeekWeek to Date Last 7 DaysLast 14 Days Last 30 DaysLast 90 Days Last 365 DaysMonth to Date Last MonthThis Quarter Last QuarterQuarter to Date Year to DateLast Year

How data is retrieved: The Oracle connects through the SmartService data bridge to fetch records. The complete dataset is held in your browser. In Claude AI mode, only the data schema and a few sample rows are sent to the model — never your full dataset.


Asking Questions

Conversations & Suggested Prompts

Type a question in the input box and press Enter to send. Use Shift + Enter for a new line. The send button is labeled Reveal.

Each dataset comes with curated starter prompts. For example:

Leads

Lead-funnel conversion analysis, lead-source ROI comparisons

Customers

Customer segmentation, churn-risk detection, cohort retention

Calls

Call-center performance dashboards, staffing heat-maps

Appointments

Technician utilization and no-show trend analysis

Oracle chat window
Live streaming answers — status chips show each processing step in real time

In Claude AI mode, responses stream in as they are generated. Status chips appear showing each processing step — for example, "Queried 1,204 records" — so you always know what the Oracle is doing.


Output Types

What the Oracle Can Produce

In Claude AI mode, the Oracle has a full toolkit it can use singly or in combination to complete a request.

Interactive Tables

Paginated data tables (25 rows/page) with your chosen columns and ordering. Ideal for lists and rankings.

Local + AI

Charts

Bar, line, doughnut, and pie charts for trends, comparisons, and distributions.

Local + AI

Pivot Tables

Two-dimensional summaries with row and column totals, grand totals, and heat-map shading.

Local + AI

Formatted Documents

Print-ready invoices, reports, emails, memos, quotes, statements, proposals, and summaries — with Copy, Download HTML, and Print / PDF actions.

AI only

CSV Exports

One-click CSV file downloads of any query result — e.g., "CSV of all unpaid invoices over 30 days."

Local + AI

Email It to Me

Any answer or generated document can be sent to you as an email through the host application's email service.

Local + AI
Chart and table output
Chart and table outputs rendered directly in the conversation
Formatted document output
Formatted documents generated from real data — with Copy, Download, and Print actions

Quick Reference

Local Mode vs. Claude AI Mode

CapabilityLocal ModeClaude AI Mode
Lookups & counts
Filtering, grouping, aggregation
Tables, charts, pivots
Formatted documents (invoices, reports, etc.)
Multi-step / open-ended analysisLimited
CSV export
Email a result
Requires API key / internetNoYes

Conversations

Managing Visions

The sidebar keeps a history of your conversations, called Visions. Conversations are saved automatically — including on close — and the Oracle reopens your most recent vision when you return. All history lives in your browser's local storage.

Oracle sidebar and Visions history
The sidebar — Visions history, search, and the Vision panel showing loaded dataset details

Vision Panel: A collapsible sidebar section shows the currently loaded dataset, its record count, and the list of available fields — so you always know what data you're working with and what field names to reference in questions.


Settings

Configuring the Oracle

Open settings from the brand orb in the sidebar or the status badge in the header.

Anthropic API Key

Required for Claude AI mode. Stored only in your browser's local storage and sent only to Anthropic's API. Use Test connection to verify and Clear key to remove it.

Model Selection

Opus — most capable · Sonnet — balanced, recommended default · Haiku — fastest response time.

Use Claude AI for Answers

Toggle between Claude AI mode and the local engine. If an API call fails, the Oracle automatically falls back to the local engine so you still get an answer.

Oracle Settings panel
Oracle Settings — API key, model selection, and mode toggle

After saving your API key, we recommend refreshing any browser pages where your Cloud database is currently open. The quickest way to do this is a Hard Refresh: press Ctrl + F5 — this forces the browser to ignore its cache and download the absolute newest version of the page directly from the server.


Usage & Cost

Token & Cost Tracking

When Claude AI mode is active, the sidebar displays running token and cost totals. The Oracle tracks input, output, and cached tokens per request and estimates cost from the selected model's pricing. Clicking the stats area lets you reset the totals.

Session
$0.024
Current browser tab
Lifetime
$1.84
Cumulative across sessions
Tokens (session)
12,480
Input + output + cached

Privacy & Storage

Where Your Data Lives

Full Dataset

Stays entirely in your browser. Local-mode analysis happens on your device with no data transmitted.

Claude AI Mode

Only the schema and a few sample rows are transmitted to Anthropic's API. The plan executes locally against your data.

API Key & Settings

Stored in your browser's local storage, namespaced per host environment so separate environments don't collide.

Leaving the Browser

Data leaves the browser only when you explicitly choose to email a result.


Interface

Keyboard Shortcuts & UX Details

Send a question

Enter

New line in input

ShiftEnter

Collapse / expand sidebar

Ctrl / CmdB

Two Visual Themes

A cosmic dark "oracle" theme and a clean, professional light theme — matched to your host app's active color.

Navigation Helpers

Scroll-to-top and scroll-to-bottom buttons keep long conversations navigable without losing your place.


Best Practices

Tips for Best Results

Be specific with field names. The field list in the Vision panel shows the exact names the Oracle expects — use them in your questions for precise results.

Pull the right date range first. Analysis only covers the records you've loaded, so set the date range to match the period you care about before asking.

Ask for the output you want. Phrases like "as a chart," "build a pivot," "create an invoice," or "export to CSV" steer the Oracle toward the right format.

Chain requests. Follow up within a vision to refine, drill down, or reformat a previous answer without starting a new conversation.

Choose the right model for the task. Use Sonnet for everyday work, switch to Opus for demanding analysis, and Haiku for the fastest turnaround.