# Frequently Asked Questions

Welcome to Blockbrain’s FAQ page. Here, you’ll find quick answers and helpful tips for setting up, customizing, and maximizing your Knowledge Bot experience. Whether you're just starting or troubleshooting advanced features, this page is designed to guide you every step of the way.

***

## Prompts & Interactions

### **1. How can I write better prompts for my Knowledge Bot?**

To get more accurate and useful responses from your Knowledge Bot, make sure your prompts are:

* Clear and specific
* Focused on one request at a time
* Written using the same keywords or terminology your team uses (especially when referencing attached files)
* Rich with context or background when needed

{% hint style="info" %}
**Tip:** Visit the [Prompt Guide](https://docs.en.theblockbrain.ai/for-users/pages/ki7QnF5ofj7rVSAoW9Oi#id-2.-chat-prompt-guide) for examples and best practices.
{% endhint %}

### 2. Is it better to upload a file or connect a database?

It depends on how focused you want your chat to be:

* **File Upload**. Use when you want to focus on a specific document.
  * Keeps the full structure of your document (no chunking), which is best for short, structured files like contracts or reports.
  * Uses more tokens, since the whole file is processed at once.
* **Database Source**. Use when you're working with larger document collections or need to search across many files.
  * Breaks documents into smaller chunks. This improves performance for large document collections and broad queries.
  * More efficient for high-volume or team-wide use.

{% hint style="info" %}
Learn what other types of data you can connect in the [Connect Data to your Knowledge Bot](/for-users/all-about-knowledge-bots/connect-data-to-your-knowledge-bot.md#types-of-connectable-data) page.
{% endhint %}

<figure><img src="/files/hDTn4z9R63ZIVbbfzxVc" alt=""><figcaption></figcaption></figure>

***

## Bot Setup and Customization

{% hint style="warning" %}
If you don’t see these options, request access from your **Admin** or a team member with the **Builder** role.
{% endhint %}

### 1. How do I create a new bot?

You can create a bot in two ways:

* Click **Bot Creator** in the menu to create a new bot. Bots created here can be shared with your team (*Note: data rooms are not automatically shared with it*).

<figure><img src="/files/dkTcM9XEk0AsxVAITXXS" alt=""><figcaption></figcaption></figure>

### How do I change my bot's name and profile photo?

* Open your Knowledge Bot.
* Click the **⚙️** gear icon (top-left corner) to access Settings.
* Go to the Set Up page to update the bot's name, photo, and more.

<figure><img src="/files/IENj2ArkKaYDOxh7StRt" alt=""><figcaption></figcaption></figure>

### Can I hide or disable features on the right sidebar in my Knowledgebot?

Yes. Head to **Settings > Action Settings**, where you’ll find a list of available sidebar features and toolbar shortcuts. You can toggle on/off what you'd like to show.

<figure><img src="/files/8otPFSc4yle8Bkj82bV1" alt=""><figcaption></figcaption></figure>

### How do I create prompt shortcuts?

You have two options:

* **Enable Conversation Starters**: This shows quick prompt suggestions whenever a new data room is opened.

<figure><img src="/files/e6TPalvacygvQFt22X1R" alt=""><figcaption></figcaption></figure>

* **Use the Prompt Library**: Add pre-made prompts created by your organization directly to your Knowledgebot.

<figure><img src="/files/OFL7a8aGvgF9oNedTW8d" alt=""><figcaption><p>Prompt Library</p></figcaption></figure>

Go to Settings, enable the Prompt Library, then click the “Prompts” button near the input field in your Knowledgebot.

***

## Knowledgebot Settings

### Can I make the bot automatically use the detected language?

Yes, You can click “Language” in the sidebar and change the default language.

<figure><img src="/files/PO1E876nws433UTtXXHw" alt=""><figcaption></figcaption></figure>

### Can I switch to a different AI model?

Yes, simply use click the AI model, also known as an LLM, in the right sidebar to choose your preferred AI model for the task. If you want to choose the right AI model, simply view the options and their descriptions for a more detailed insight on what is best for you.

<figure><img src="/files/VwSFRd18u2SB8Dsa2u7x" alt=""><figcaption></figcaption></figure>

### **How can I share my Knowledgebot with selected people?**

Only bots created in the Bot Creator can be shared with others. There, you could find the **Share** button with the following settings:

* Set the bot to **Public**, **Private**, or **Restricted**
* Add specific collaborators if restricted
* Control who can view or edit the bot

<figure><img src="/files/MicTqxcWIskOeB4kZp0A" alt=""><figcaption></figcaption></figure>

***

## Troubleshooting

### Why are my some features missing or not showing up for me?

Many features are toggled on/off through the **Action Settings** page. This can be accessed through the settings.

{% hint style="warning" %}
If you can't access these settings, contact your **Admin** or someone with a **Builder** role.
{% endhint %}

### I am not satisfied with the AI's response, what can I do?

Here are a few things you can try:

* **Switch to a different AI model (LLM)**
* **Adjust the model modifiers** (e.g., tone, creativity, precision)
* **Improve your prompt** (see the [Prompt Guide](https://docs.en.theblockbrain.ai/for-users/pages/ki7QnF5ofj7rVSAoW9Oi#id-2.-chat-prompt-guide) for help)

These small changes can often lead to better, more relevant answers.

\
&#x20;


---

# 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.en.theblockbrain.ai/for-users/frequently-asked-questions.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.