voicely_search

Voicely Search

RAG-powered conversational search with voice, multi-language support, and decoupled API for Drupal.

Voicely Search adds an AI-powered chat interface to your Drupal site. Users ask questions in natural language and get answers generated from your indexed content — not generic AI responses, but answers grounded in your actual pages, products, content or documentation.

How It Works

1. User asks a question
2. Your Search API index is queried for relevant content
3. The top matching documents are sent as context to an AI model
4. The AI generates a natural language answer based on your content
5. Sources are cited so users can verify the information

This is called Retrieval-Augmented Generation (RAG) — the AI reads your content before answering, so responses are accurate and specific to your site.

Key Features

Search

• - Integrates with Search API — works with OpenSearch, Solr, Elasticsearch, or Database search
• - Auto-detects index fields and configures query/source/result mapping
• - No duplicate credentials — reads connection details from your existing Search API server

AI Providers

• - Use any provider via the Drupal AI module (OpenAI, Anthropic, Google Gemini, AWS Bedrock, etc.)
• - Or configure any OpenAI-compatible API manually (Cerebras, Groq, Ollama, Together AI, local LLMs)
• - Configurable system prompt to control AI behaviour and tone

Voice

• - Speech-to-Text: OpenAI Whisper or Web Speech API (auto-detects per browser — Chrome uses free browser API, Firefox falls back to Whisper)
• - Text-to-Speech: OpenAI TTS, ElevenLabs, or Web Speech API
• - Auto-speak responses with stop control
• - 3-second silence detection auto-stops recording

Multi-language

• - 8+ languages supported
• - Auto-detection of user language
• - Translation via OpenAI or DeepL
• - Shared API keys — enter once, used across all services

Decoupled / Headless

• - Full REST API for React, Vue, Next.js, or any frontend
• - CORS support with configurable allowed origins
• - API key authentication
• - All endpoints return JSON

Admin Tools

• - Connectivity dashboard — verify AI provider, voice services, and search backend status at a glance
• - Conversation logs — view, filter (by IP, location, device), download, and delete chat history
• - Spam protection — rate limiting per IP with auto-blocking
• - Configurable UI — show/hide mic, auto-speak, stop, clear, download, and language selector

Widget

• - Place a floating chat bubble on any page via Block Layout
• - Same full functionality as the dedicated chat page
• - Mobile responsive
• - Conversation download as Word document

Requirements

• - Drupal 10 or 11
• - Search API module
• - AI module
• - A search backend (OpenSearch, Solr, Elasticsearch, or Database)

Links

• - Settings: /admin/config/search/voicely
• - Status dashboard: /admin/config/search/voicely/status
• - Conversation logs: /admin/config/search/voicely/logs
• - Chat page: /conversation
• - API: /api/conversation/send