Searchia Agent

Searchia's embeddable AI search and chat widget, with a streaming API client, Persian and English interfaces, Markdown, and product result cards.

Install

Organization package:

npm install @fateme_rjn/agent

JavaScript

<div id="searchia"></div>

import SearchiaChat from '@fateme_rjn/agent';
import '@fateme_rjn/agent/style.css';

SearchiaChat.init({
  container: '#searchia',
  locale: 'fa',
  showSearch: true,
  showChatTrigger: true,
  agentId: 'YOUR_AGENT_ID',
  api: {
    baseUrl: 'https://api.example.com',
    apiKey: 'YOUR_WIDGET_API_KEY',
    applicationId: 'YOUR_APPLICATION_ID',
  },
});

Use connection settings issued for your website. baseUrl is the API base URL; the widget appends /widget/agent-studio/agents/{agentId}/completions. The API must allow your site's origin and the X-Searchia-Api-Key and X-Searchia-Application-Id headers. Browser connection values are visible to visitors; use a browser widget key.

React and Next.js

React 18 or later is required only for the React wrapper. Keep options stable across renders. Import the stylesheet once in the application entry point or Next.js root layout.

'use client';
import { SearchiaWidget } from '@fateme_rjn/agent/react';

const options = {
  locale: 'fa',
  showSearch: true,
  showChatTrigger: true,
  agentId: 'YOUR_AGENT_ID',
  api: {
    baseUrl: 'https://api.example.com',
    apiKey: 'YOUR_WIDGET_API_KEY',
    applicationId: 'YOUR_APPLICATION_ID',
  },
};

export default function Assistant() {
  return <SearchiaWidget options={options} />;
}

The wrapper mounts the widget after the DOM is ready and cleans it up on unmount. JavaScript and standalone installations bundle their UI runtime.

Controls

SearchiaChat.open('#searchia');
SearchiaChat.openSearch('#searchia');
await SearchiaChat.ask('شرایط ارسال چیست؟', '#searchia');
SearchiaChat.setLocale('en', '#searchia');
SearchiaChat.destroy('#searchia');

Call controls after initialization has rendered. Configure title, buttonText, placeholder, welcomeTitle, welcomeMessage, and customSuggestedQuestions to match your site. triggerPosition accepts fixed or inline; darkMode can override the site's theme.

Without api or a custom adapter, the widget runs a local demo. A custom adapter takes precedence over api. Each mounted widget owns its conversation; search and chat within one mount share it.

Copyright Searchia. All rights reserved. Bundled third-party notices are included in dist/THIRD_PARTY_NOTICES.txt; the bundled font license is in dist/OFL.txt.