Getting Started
SiteSage provides flexible, embeddable AI components for your website. SiteSage is unauthenticated by default, giving you full control over how users connect to your AI backend.
Note: Need help with the SiteSage Web Components? Reach out to us with questions or let’s set up a technical meeting.
Architecture: How Authentication Works
Section titled “Architecture: How Authentication Works”SiteSage components act as the interface. To bridge the gap between your users and the AI, you use a Proxy.
- The Default Flow: Use the built-in handler in the
<sitesage-chat>module for public, unauthenticated access. - The Secure Flow: Write a custom proxy (a simple API endpoint on your server). The component sends requests to your proxy; your proxy validates the user’s session/JWT and forwards the request to the SiteSage backend using your private API keys.
Please refer to the rbac guide for more information on how to control what the AI can access for each user.
Choose Your Integration
Section titled “Choose Your Integration”| Feature | <sitesage-chat> | <sitesage-widget> |
|---|---|---|
| Effort | Low (Drop-in) | Medium (Custom UI) |
| UI | Floating chat bubble & window | Inline embeddable container |
| Use Case | Support bots, general FAQ | Dashboard integrations, internal tools |
Quick Start
Section titled “Quick Start”To add the SiteSage Web Components to your site, include the script via CDN and add the custom element(s) to your HTML.
The latest version can be found on jsDelivr.
Note Its recommended to specify a version number in your CDN URL to avoid breaking changes.
1. Include the Script
Section titled “1. Include the Script”Add this to your <head> section:
<script src="https://cdn.jsdelivr.net/npm/@sitesage/webcomponents@latest/dist/webcomponents.iife.js"></script>- Read about getting started with the sitesage-chat component.
- Read about getting started with the sitesage-search component.
- Read about gettings started with the sitesage-widget component.