Docs The app

The dashboard at a glance

After logging in you land on the dashboard. That screen answers the question every administrator has: how is my agent doing, and does anything need my attention? You don't have to dig for it; the key signals sit together and every block links to the place where you can adjust things.

The vragen.ai dashboard, with the weekly numbers at the top, the daily summary and answer quality below, and the menu with all sections of the admin environment on the left.

This week in four numbers

At the top you see the core numbers for the past seven days: the number of conversations, the number of cited sources, the average response time and the average answer length in words. Next to most numbers you see how they compare to the seven days before, so an outlier stands out right away. The conversation count is clickable: it opens the inbox with the conversations from those seven days. Response time is the exception: measured across all conversations, it tells you how quickly the answer starts to appear. More conversations after a campaign, or longer answers after a content change: this is where you notice it first.

The four weekly numbers on the dashboard: conversations, cited sources, average response time and average answer length, each with the change compared to the week before.

The daily summary

Every day vragen.ai writes a short summary of what happened in your conversations: how the numbers are moving, which topics stood out and where something needs attention. In half a minute you read what you would otherwise piece together from separate charts. Want a fresh version, for example right after a content update? Request one with the Refresh button.

The summary is AI-generated and may contain mistakes; it says so right below it. Use it as a starting point and always double-check a striking signal in your conversations. The summary is written in your account's dashboard language, which you find under Settings. That setting is separate from the interface language each user picks; in the screenshots the interface is English while this account writes its summaries in Dutch.

The daily summary next to the answer quality block with the scores for faithfulness, relevance and source relevance, and the top topics of the week.

Answer quality: three scores

Next to the summary you find the three evaluation scores vragen.ai keeps for every answer, here averaged over the past seven days: faithfulness, relevance and source relevance, each on a scale from 0 to 100. What the scores mean exactly, and what to do when one of them is structurally low, is covered in Testing and evaluating.

The dashboard also shows how each score moved compared to the seven days before. A dropping score is not an alarm, but it is a reason to click through and look at the conversations behind it.

Top topics

Here you see what visitors asked about most this week, grouped by topic. That is more than a nice list: it tells you what is on your visitors' minds right now, and which content deserves to be in shape first. Clicking a topic takes you to the analysis with all related conversations.

The health of your knowledge base

The knowledge base block shows how many documents your knowledge base contains, which share of them is indexed, and how many pages the crawler skipped or could not process; if a document really needs attention, a button takes you straight to it. Next to that you see, switching between two small tabs, which documents are cited most in answers (including their trend) and what was recently added. That way you know whether your content is actually being used. How the crawler reads your content, and why a page can be skipped, is explained in The crawler and your content.

The knowledge base block on the dashboard: on the left the health with the number of documents and the indexed share, on the right the most cited documents with their citation trend.

Recent conversations

At the bottom you find the latest questions visitors asked, with a timestamp. The small icon in front already tells you whether a conversation got positive or negative feedback or was flagged, before you even open it. It works well as a quick sample: open a conversation and you immediately see what someone asked and which answer they got.

The recent conversations on the dashboard: the latest visitor questions, each showing how long ago it was asked.

Your environment's settings

At the top right of the dashboard sits the Settings button. Behind it live your environment's settings, in three tabs:

  • Account: your environment's name and the dashboard language, the language the daily summary is written in. These details are shown for reference; changing them runs through vragen.ai, so email service@vragen.ai if something here should be different.

The Account tab of the settings: the environment's name, its public address and the dashboard language.

  • Security settings: how visitor questions are handled, and who may use which part of your environment. Only an Owner sees this tab. With Anonymize questions, vragen.ai automatically removes personal data (such as names, email addresses and phone numbers) from questions, one hour after they were asked; switch this on when questions may contain personal data and you need to comply with privacy legislation such as the GDPR. The retention period decides how long questions and answers are kept before they are permanently deleted: shorter means less stored data, longer means more history for your analyses. With How long can an anonymous conversation be picked up again? you choose for how many hours a visitor without an account can still reopen or continue a conversation through its link; the default is 24 hours. You can also restrict reference domains here, so answers only link to websites you specify. Finally, in the Access section you decide who may use three parts of your environment: the Widget, the Documents (such as uploads and the images in answers) and your knowledge base's MCP server. Each one is open to anyone, or only to signed-in users and API tokens of your environment. Existing environments keep the access they already had. How to use a restricted widget on your site anyway is covered in The widget in a locked-down environment; the MCP server in Knowledge base as an MCP server.

The Security settings tab: anonymizing questions, the retention period for questions, how long an anonymous conversation can be picked up again, restricting reference domains, and the Access section with choices for the widget, the documents and the MCP server.

  • Advanced: whether search queries made through the search API are stored. Switch it on and Search queries appears under Insight, where you read back what was searched through the API and the search modules of your CMS (see Conversations). Stored search queries are automatically deleted after one month.

The Advanced tab of the settings: the Search API section with the Store search queries switch.

Where your data lives and how storage is arranged is covered in Hosting and data storage.

From signal to action

The dashboard is the starting point of the improvement cycle. See faithfulness dropping? Start an optimization round. Does a top topic point to a question your site has no good answer to? Then add to your knowledge base. And if indexing lags behind, look at the crawler. Can't figure it out? Email service@vragen.ai; we're happy to take a look with you.

Still have a question?

Ask it here. The answer comes from this documentation and points to the right page.

What exactly is vragen.ai?

Example answer by vragen.ai

vragen.ai lets visitors ask their question on your website and gives them a reliable answer straight from your own content, with the source included. You decide which sources the AI uses.

Source: How it works

This is an example. The interactive widget could not load here, for instance because of a script blocker or a slow connection.

You are talking to an AI assistant from vragen.ai. Why we mention this