> ## Documentation Index
> Fetch the complete documentation index at: https://support.humanizing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Base: AI-Powered Q&A for Avatars and Robots

> Set up an AI-powered Knowledge Base in Plural using OpenAI to let your avatar or robot answer questions from uploaded PDF documents.

The Knowledge Base feature connects Plural to OpenAI (ChatGPT) so your avatar or robot can answer free-form questions using content you upload. Instead of programming every possible question and answer into your flow, you upload your documents and let AI do the heavy lifting — your avatar becomes a conversational expert on whatever material you provide.

## What Is the Knowledge Base?

The Knowledge Base lets you upload data sources (currently PDF files, with YouTube videos and web pages coming soon) and use them as a backend for your avatar or robot. When a visitor asks a question, Plural queries the Knowledge Base and the avatar speaks the AI-generated answer aloud.

<Note>
  The Knowledge Base feature must be enabled for your account. If you do not see the **Knowledge Bases** tab in the left navigation bar, contact your account manager or reach out to [sales@humanizing.com](mailto:sales@humanizing.com).
</Note>

## Avatars vs. Robots: Key Differences

<Tabs>
  <Tab title="Avatars">
    For avatars, the Knowledge Base integrates directly into your project flow using a dedicated **Knowledge Base element**. You can add it with or without a pre-built UI, and you can also run it inside an [automation frame](/en/elements/overview) for more advanced setups.
  </Tab>

  <Tab title="Robots (Pepper / Temi)">
    For physical robots, Plural provides a **template project** you download and configure. The template uses a **Custom API Call** element to communicate with the Knowledge Base backend. You update the API URL and token, assign the project to your robot, and push the update.
  </Tab>
</Tabs>

## Setting Up the Knowledge Base

<Steps>
  <Step title="Create a new Knowledge Base">
    In the left navigation bar, click **Knowledge Bases**. Enter a name and select the **primary language** your avatar will speak. Your Knowledge Base is multilingual — you only need to set the default language now.
  </Step>

  <Step title="Upload your PDF documents">
    Click **Create New Knowledge Base** to open the data source page. Click the **Upload** box and select up to **10 PDF files** from your computer. Keep each file under **10 MB** and the total upload under **200 MB**.
  </Step>

  <Step title="Manage your data sources">
    Click **Manage Data Source** inside your Knowledge Base to view, add, or delete documents. Click a document name to preview it, or click the trash icon to remove it.
  </Step>

  <Step title="Test in the Playground">
    Switch to the **Playground** tab and start a chat to test how your avatar answers questions. When you are satisfied with the results, click **Clone to my project** to create a new Avatar Starter Project pre-loaded with Knowledge Base elements.
  </Step>

  <Step title="Configure settings">
    Go to the **Settings** tab to adjust:

    * **Creativity** — set to *Precise* for factual answers or *Normal* for more conversational responses.
    * **Post-answer message** — add a follow-up message the avatar speaks after every answer.
    * **Custom prompt** — edit the system prompt sent to GPT to control tone, persona, or response format.
  </Step>
</Steps>

## Adding the Knowledge Base to a Project Flow

<Tabs>
  <Tab title="Avatars">
    <Steps>
      <Step title="Create a User Input element">
        In your project flow, add a **Save User Input** element. In the **Save to Attribute** field, type a name like `UserQuery`.
      </Step>

      <Step title="Add a Knowledge Base element">
        Drag from the output circle of the User Input element to create a **Knowledge Base element**. Choose whether to use the **predefined UI** (with built-in display panels) or **without UI** (build your own layout).
      </Step>

      <Step title="Select your Knowledge Base">
        In the Knowledge Base element settings, select the Knowledge Base you created from the dropdown.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Robots (Pepper / Temi)">
    <Steps>
      <Step title="Download the template project">
        In Plural, navigate to the **Downloads** section and download the Knowledge Base template project for your robot type.
      </Step>

      <Step title="Select your Knowledge Base">
        Open the downloaded project. In the **KB-Element**, select the Knowledge Base you created.
      </Step>

      <Step title="Update the Custom API Call element">
        Copy the **API URL** from your Knowledge Base settings and paste it into the **Custom API Call** element on the robot side. Then copy the **API Token** and paste it into the same element.
      </Step>

      <Step title="Assign and deploy">
        Assign the updated project to your robot and push the update. Your robot is now ready to answer questions from your Knowledge Base.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Analytics and Conversation History

Every Knowledge Base includes built-in analytics and a conversation history log. Review the history to understand what questions visitors are asking, identify gaps in your documents, and improve your data sources over time.

## GO Consumption

<Warning>
  The Knowledge Base consumes GOs (Plural's in-app currency) each time it processes a query. If your account runs out of GOs, the Knowledge Base stops working. Contact [support@humanizing.com](mailto:support@humanizing.com) if you encounter this issue.
</Warning>

| Plan     | GO cost                                |
| -------- | -------------------------------------- |
| Standard | 10 GOs per 1,000 characters processed  |
| Premium  | 100 GOs per 1,000 characters processed |

For pricing and subscription information, contact [sales@humanizing.com](mailto:sales@humanizing.com).