# How Superseek works

Superseek is a conversational AI assistant that's powered by the content you feed it. 

But how does it work? 

Here's a quick high-level overview of everything that goes on under the hood.

## Step 1: Creating the knowledge base for your AI bot

The first step is to provide your AI bot with the knowledge it needs to answer queries. 

When you add your content to Superseek (by adding your website, by uploading documents, or by pasting plain text), two things happen.

1. <mark style="color:blue;">**Chunking of your content**</mark>

Superseek extracts all the text from the provided sources (website pages, help docs, PDFs, plain text, etc.) and then breaks it into smaller chunks.

2. <mark style="color:blue;">**Vectorization & Embedding of your content**</mark>

The chunks of text are then vectorized (converted into 1536 numbers that capture the semantic meaning of that chunk of text) and embedded in a vector database. We use Supabase as our vector database.

## Step 2: Answering questions

Once the knowledge base is ready, your AI bot is ready to answer questions. Here's what happens when a question is asked.

1. <mark style="color:blue;">**Vectorization & Embedding of the question**</mark>

Similar to the step above, the question text is vectorized and embedded in the same vector database.

2. <mark style="color:blue;">**Locating the text needed to answer**</mark>

Superseek performs a similarity check to locate the best set of text chunks needed to answer the question.&#x20;

3. <mark style="color:blue;">**Generating the answer**</mark>

Superseek then passes the prompt (the instructions provided to the bot) along with the question and the best-match chunks to ChatGPT via OpenAI's API to generate an answer.

## **What if the question can't be answered by AI?**

AI is great, but some questions still need a human touch!&#x20;

If a meaningful answer cannot be generated from the provided content (or if the user marks an AI-generated response as unhelpful), here's how we help you handle it.

1. <mark style="color:blue;">**Fallback response**</mark>

You can configure the 'I don't know' response the bot provides. You can ask the user to rephrase the question and try again or to get in touch with you. It's up to you.

2. <mark style="color:blue;">**Routing buttons**</mark>

Routing buttons can be added to the fallback response to help them get in touch with you. You can have the button open a link (Zendesk or Freshdesk ticketing page, calendly, etc.) or have it show a canned response.

3. <mark style="color:blue;">**Human handoff (via your live chat provider)**</mark>

If you have an existing live chat provider (such as Zendesk chat), you can configure the button to close the Superseek widget and open the live chat widget. This way, customers who need further support get it and your team is less loaded with repetitive support questions. We currently support Zendesk, Intercom, Freshchat, and Hubspot.

<figure><img src="/files/IAyIZTWo8rw3A1iq9TmS" alt=""><figcaption><p>Routing and human handoff with Superseek</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.superseek.ai/home/getting-started/how-superseek-works.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.