Vragen.ai - Search API

Vragen.ai integration for Drupal Search API

This module integrates Drupal Search API with Vragen.ai
for indexing Drupal content as a knowledge source.

Vragen.ai is an AI-powered search solution that answers questions based on your
own content. Instead of relying only on keyword matching, it retrieves relevant
information from configured sources and generates an answer with source references.

In a Drupal setup, this module allows Search API content to be synchronized with
Vragen.ai so Drupal content can be used in an AI search interface, assistant, or chatbot.

Authentication

To enable this module to communicate with the Vragen.ai API it requires:

1. the correct endpoint created specifically for your organization
2. the bearer token used to authorize requests

This information can be submitted using the form found at:

/admin/config/search/vragen-ai

Configuration

1. Create a new server with backend Vragen.ai.
2. Create a new index and adjust the following settings:
   • Datasources: Content
   • Bundles: the bundles you want to index
   • Language: the languages to include
   • Index items immediately: off
3. If you have attached files or media (for example PDFs) that should be indexed
   together with the content, add those fields as Vragen.ai attachments.
4. Configure and add all fields that are part of the index. Rendering content to HTML
   is recommended so the backend can recognize structure and semantics more reliably.

You can leave immediate indexing enabled, but that will send requests directly to
the backend during content updates instead of handling synchronization through cron.

What Vragen.ai adds

Vragen.ai is intended for question answering on top of an organization’s own
knowledge sources. According to its documentation, the platform combines retrieval
and generative AI so answers are based on available source material rather than
only on model knowledge.

• Retrieval from your own content sources
• Answer generation based on retrieved context
• Source references in generated answers
• Configuration of tone, role, and answer behavior
• Testing and validation before going live
• Analysis of incoming questions and content gaps

In practice, this means Drupal can remain the content source of truth, while
Vragen.ai provides a natural-language interface on top of indexed content.

Typical use cases

• documentation and knowledge bases
• service and support content
• public information websites
• content-heavy Drupal platforms where keyword search is insufficient

How it fits in a Drupal architecture

Drupal content
  -> Search API index
  -> Vragen.ai backend
  -> AI search / assistant interface

This module focuses on the indexing and synchronization part of that flow.

Requirements

• Drupal 10 or 11
• Search API
• access to a Vragen.ai environment

Installation

composer require drupal/search_api_vragen_ai

Enable the module:

drush en search_api_vragen_ai

When to use this module

Use this module when Drupal content should be made available to Vragen.ai as a
managed knowledge source. This is especially useful when existing Search API
indexes already describe the content that should be exposed to AI-assisted search.

Resources

• Vragen.ai
• How Vragen.ai works
• What is Vragen.ai?