Installation & Feature Guide

Everything you need to install, configure, and get the most out of RAGSI.AI in your Salesforce org.

Version 1.6 · Managed Package for Salesforce AppExchange

Table of Contents

  1. 1. Product Overview
  2. 2. Installation Guide
  3. 3. Feature Guide
  4. 4. Administration
  5. 5. Troubleshooting & Support

1. Product Overview

1.1 What is RAGSI.AI?

RAGSI.AI is an intelligent Salesforce metadata management platform that brings the power of artificial intelligence directly into your Salesforce org. Built as a native Salesforce managed package with a secure Heroku cloud gateway, RAGSI.AI continuously monitors your org's metadata changes, provides AI-powered impact analysis, generates comprehensive documentation, and offers a conversational AI assistant that understands your entire Salesforce configuration.

Whether you are a Salesforce administrator managing complex orgs, a developer tracking code changes, or an architect designing solutions, RAGSI.AI provides intelligent insights that help you understand, document, and manage your Salesforce environment more effectively.

1.2 Key Capabilities

ME

Metadata Explorer

Browse, search, and filter all 1,470+ objects, fields, flows, Apex classes, triggers, profiles, permission sets, and LWC components.

CT

Change Timeline

Real-time monitoring of all metadata changes with risk assessment, categorization, and a visual timeline.

AI

AI Chat Assistant

Conversational AI powered by Anthropic Claude that understands your org metadata.

IA

Impact Analysis

AI-powered dependency analysis showing downstream effects of any metadata change before you make it.

DC

Document Center

Automatically generate comprehensive technical documentation for any component, object, or process.

KB

Knowledge Base Sync

Synchronize your org's metadata catalog into a vector-embedded knowledge base for semantic search.

EA

Email Alerts

Subscribe to configurable email notifications for metadata changes with customizable frequency and filters.

1.3 Architecture Overview

RAGSI.AI uses a hybrid architecture combining native Salesforce components with a secure Heroku cloud gateway for AI processing.

Salesforce Org (Managed Package)

Lightning Web Components
UI Layer
Apex Controllers
Business Logic
Custom Objects & Metadata
Data Layer
Scheduled Jobs
Monitoring

Heroku Gateway (Node.js)

Express REST API
Secure Endpoints
AI Processing Engine
RAG + Embeddings
PostgreSQL + pgvector
Knowledge Base
Anthropic Claude API
AI Provider

2. Installation Guide

2.1 Prerequisites

Before installing RAGSI.AI, ensure your Salesforce org meets the following requirements:

RequirementDetails
Salesforce EditionEnterprise, Unlimited, or Developer Edition
API Version62.0 or higher (Winter '25+)
User LicenseSalesforce Platform or full Salesforce license
PermissionsSystem Administrator profile or equivalent
BrowserChrome, Firefox, or Edge (latest versions)
NetworkHTTPS outbound access to *.herokuapp.com

2.2 Install from AppExchange

1

Navigate to AppExchange

Go to appexchange.salesforce.com and search for 'RAGSI.AI'.

2

Begin Installation

Click 'Get It Now', log in with your Salesforce credentials, and select the target org.

3

Choose Installation Options

Select 'Install for All Users' (recommended). Review package components and permissions.

4

Complete Installation

Click 'Install' and wait 2-5 minutes. You'll receive a confirmation email.

5

Verify Installation

Navigate to Setup > Installed Packages. Confirm 'RAGSI.AI' (namespace: ffmdai) with 153 components.

2.3 Post-Installation Setup

1

Assign Permission Set

Go to Setup > Permission Sets. Find 'FF_AI_Admin', click 'Manage Assignments', and add users.

2

Access the App

Click the App Launcher (9-dot grid icon), search for 'RAGSI.AI', and open the application.

3

Configure Remote Site Settings

Verify the Heroku endpoint is listed. If not, add: https://ragsibot-gateway.herokuapp.com

2.4 Connect AI Gateway

The AI Gateway is a secure Heroku-hosted service that handles AI processing and knowledge base operations.

1

Open AI Settings

Navigate to the 'AI Settings' tab. Check the Gateway Connection Status indicator.

2

Verify Gateway Token

A secure JWT token is stored in FF_AI_Secure_Settings__c. No manual configuration needed.

3

Sync Your Metadata

Navigate to 'Knowledge Base Sync' tab and click 'Sync Metadata to Knowledge Base'.

2.5 Configure AI Provider

RAGSI.AI uses Anthropic Claude as its AI backbone.

SettingDefault ValueDescription
AI ProviderAnthropic ClaudeThe LLM provider for AI features
Modelclaude-sonnet-4-20250514AI model for chat and analysis
Max Tokens4096Maximum response length
Temperature0.7Creativity level (0-1)
Gateway URLAuto-configuredHeroku gateway endpoint

Note: AI provider settings are stored in Custom Metadata (FF_AI_Configuration__mdt) and can be modified by administrators through the AI Settings page.

3. Feature Guide

3.1 Metadata Explorer

The Metadata Explorer is your central hub for understanding everything in your Salesforce org. It provides a comprehensive, searchable view of all 1,470+ metadata components including standard and custom objects, fields, validation rules, flows, Apex classes, triggers, profiles, permission sets, and Lightning Web Components.

Use the advanced filter dropdowns to narrow down to specific metadata types, and click 'Generate Docs' to create AI-powered documentation for any component.

3.2 Change Timeline & Monitoring

The Change Timeline provides continuous, automated monitoring of every metadata change. Each change is captured with full details including the component name, type, who made the change, when it occurred, and an AI-powered risk assessment score.

The Email Alerts feature (new in v1.6) allows users to subscribe to automated notifications about metadata changes with configurable frequency, component types, and risk level thresholds.

3.3 AI Chat Assistant

The AI Chat Assistant is a conversational interface powered by Anthropic Claude with Retrieval-Augmented Generation (RAG). Ask natural language questions like 'What custom fields are on the Account object?' or 'Show me all flows related to opportunities' and receive accurate, context-aware responses.

Quick Action buttons provide one-click access to common queries: Org Overview, Document Object, List Flows, and List Apex. Chat sessions are automatically saved.

3.4 Impact Dashboard & AI Architect

The Impact Analysis tab lets you select any metadata component and analyze its dependencies before making changes. The AI Architect tab provides intelligent architecture recommendations based on your current org structure.

3.5 Document Center

DC

AI-Powered Documentation Generation

Automatically generate comprehensive technical documentation for any Salesforce component. Documents include object schemas, field descriptions, relationships, validation rules, triggers, and process builder flows.

3.6 Knowledge Base Sync

KB

RAG Knowledge Base Synchronization

Extract your org's complete metadata catalog and create vector embeddings in the Heroku-hosted knowledge base for AI-powered semantic search and retrieval-augmented generation.

3.7 Email Alert Subscriptions

EA

Configurable Email Alert Subscriptions (New in v1.6)

Subscribe to automated email notifications for metadata changes. Configure alert frequency, filter by component types, and set minimum risk level thresholds.

ConfigurationOptionsDescription
FrequencyImmediate / Daily / WeeklyHow often alert emails are sent
Component TypesApex, Flow, Object, Field, etc.Which metadata types to monitor
Risk LevelHigh / Medium / LowMinimum risk level for notifications
StatusActive / PausedEnable or disable the subscription

4. Administration

4.1 AI Settings Configuration

The AI Settings page serves as the central administration hub. Administrators can view gateway connection status, configure AI provider settings, set up the metadata monitoring scheduler, and test connectivity.

4.2 Metadata Scheduler

The automated metadata monitoring scheduler periodically scans your org for changes. It runs as a Salesforce Scheduled Apex job.

SettingDefaultDescription
Scan Interval60 minutesTime between metadata scans
Full SyncWeeklyComplete metadata refresh frequency
Change DetectionEnabledAutomatic change tracking
Risk AssessmentEnabledAI-powered risk scoring

4.3 Security & Permissions

5. Troubleshooting & Support

1

Gateway Not Connected

Verify Remote Site Settings include the Heroku endpoint. Go to AI Settings and click 'Test Connection'.

2

AI Chat Not Responding

Ensure Knowledge Base Sync has been completed. Check AI Settings for valid configuration.

3

Metadata Changes Not Detected

Verify the Metadata Scheduler is active in Setup > Scheduled Jobs.

4

Email Alerts Not Received

Confirm your alert subscription is 'Active'. Check spam folder and Salesforce email deliverability settings.

5

Installation Failed

Ensure System Administrator profile. Verify no conflicting namespace (ffmdai). Contact [email protected].

Contact & Support

Websitewww.ragsi.ai
Email Support[email protected]
Documentationdocs.ragsi.ai
AppExchangeappexchange.salesforce.com
Version1.6 (Email Alerts & Chat Improvements)
Namespaceffmdai
Package Type1GP Managed Package

Ready to get started?

Install RAGSI.AI from AppExchange and transform how your team manages Salesforce.

Start Free Trial