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

# Agent Knowledge Base

Before your Pearl can answer questions accurately, it needs context. This step helps define the essential background information your agent will rely on during conversations.

<Card>
  **Company Name**

  Give your Pearl the name of the company it represents. This name may be used when Pearl introduces itself or provides company-related information.

  <div className="block dark:hidden">
    <Frame>
      <div className="p-1">
        <img src="https://mintcdn.com/nlpearl/dWWMdFzyPk-9Vcky/images/light_mode/simplepearl_companyname.jpg?fit=max&auto=format&n=dWWMdFzyPk-9Vcky&q=85&s=6e9b6ea469d95f6a5fa7e3a6dc8e78f1" alt="Send Email action interface on light mode" className="rounded-[14px]" width="1562" height="572" data-path="images/light_mode/simplepearl_companyname.jpg" />
      </div>
    </Frame>
  </div>

  <div className="hidden dark:block">
    <Frame>
      <div className="p-1">
        <img src="https://mintcdn.com/nlpearl/nyDvVX0ZPwzeAWkt/images/dark_mode/simplepearl_companyname.jpg?fit=max&auto=format&n=nyDvVX0ZPwzeAWkt&q=85&s=3c2760d4e6cacc7f446abf258be19efb" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="1562" height="572" data-path="images/dark_mode/simplepearl_companyname.jpg" />
      </div>
    </Frame>
  </div>

  <br />

  ***

  **Company Description**

  Add a brief company description including your industry, mission, or key services. This allows Pearl to answer questions with more contextual relevance.

  <div className="block dark:hidden">
    <Frame>
      <div className="p-1">
        <img src="https://mintcdn.com/nlpearl/dWWMdFzyPk-9Vcky/images/light_mode/simplepearl_companydescription.jpg?fit=max&auto=format&n=dWWMdFzyPk-9Vcky&q=85&s=e2956a665d0b4ad839e0a8104aa3cf81" alt="Send Email action interface on light mode" className="rounded-[14px]" width="1562" height="794" data-path="images/light_mode/simplepearl_companydescription.jpg" />
      </div>
    </Frame>
  </div>

  <div className="hidden dark:block">
    <Frame>
      <div className="p-1">
        <img src="https://mintcdn.com/nlpearl/nyDvVX0ZPwzeAWkt/images/dark_mode/simplepearl_companydescription.jpg?fit=max&auto=format&n=nyDvVX0ZPwzeAWkt&q=85&s=5d03e85b0623fc5a812ce820062175d8" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="1562" height="794" data-path="images/dark_mode/simplepearl_companydescription.jpg" />
      </div>
    </Frame>
  </div>

  <br />

  ***

  **Pearl Knowledge Base**

  This is where you teach Pearl what it needs to know to respond with relevance and accuracy. Add detailed information about your services, pricing, opening hours, locations, and any key operational data.

  <Note>
    You can either write this content manually or upload a reference file.\
    Multiple documents can be added if needed. Supported formats: `.doc`, `.docx`, `.txt`, `.pdf`.
  </Note>

  Whether you're describing how your subscription plans work, listing available services, or clarifying your business hours, this section allows Pearl to access structured information that supports more precise answers.

  <div className="block dark:hidden">
    <Frame>
      <div className="p-1">
        <img src="https://mintcdn.com/nlpearl/dWWMdFzyPk-9Vcky/images/light_mode/simplepearl_knowledgebase.jpg?fit=max&auto=format&n=dWWMdFzyPk-9Vcky&q=85&s=b92379b4c8b61bd3220efdde5782fa07" alt="Send Email action interface on light mode" className="rounded-[14px]" width="1562" height="1018" data-path="images/light_mode/simplepearl_knowledgebase.jpg" />
      </div>
    </Frame>
  </div>

  <div className="hidden dark:block">
    <Frame>
      <div className="p-1">
        <img src="https://mintcdn.com/nlpearl/nyDvVX0ZPwzeAWkt/images/dark_mode/simplepearl_knowledgebase.jpg?fit=max&auto=format&n=nyDvVX0ZPwzeAWkt&q=85&s=656f20b2662859630e3d3e74a9d493c6" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="1562" height="1018" data-path="images/dark_mode/simplepearl_knowledgebase.jpg" />
      </div>
    </Frame>
  </div>

  <br />

  ***

  **Memory**

  When enabled, Pearl remembers the user or lead, allowing it to seamlessly continue conversations from where they left off.

  <Tip>
    This feature is particularly useful for:

    * Multi-step processes
    * Follow-ups
    * Any scenario where continuity matters
  </Tip>

  <Card>
    ### Example use case: Hospitality

    Let's say a guest checks into a hotel. Pearl can:

    * Remember their room number
    * Greet them by name
    * Recall their preferences (like "extra towels" or "no wake-up call")
    * Offer a smooth, personalized experience every time they call
  </Card>

  <Info>
    **Resetting Memory**

    Need a fresh start? Pearl's memory can be reset via API.

    This is especially important in contexts like hospitality, where once a guest checks out, Pearl clears the slate, ensuring the next visitor starts with a clean experience.
  </Info>

  <div className="block dark:hidden">
    <Frame>
      <div className="p-1">
        <img src="https://mintcdn.com/nlpearl/dWWMdFzyPk-9Vcky/images/light_mode/simplepearl_memory.jpg?fit=max&auto=format&n=dWWMdFzyPk-9Vcky&q=85&s=0f2bfe9c3e901a2d7c9f23b4da639448" alt="Send Email action interface on light mode" className="rounded-[14px]" width="1562" height="410" data-path="images/light_mode/simplepearl_memory.jpg" />
      </div>
    </Frame>
  </div>

  <div className="hidden dark:block">
    <Frame>
      <div className="p-1">
        <img src="https://mintcdn.com/nlpearl/nyDvVX0ZPwzeAWkt/images/dark_mode/simplepearl_memory.jpg?fit=max&auto=format&n=nyDvVX0ZPwzeAWkt&q=85&s=f81a7830bcfe1e9254ef1cd7e1837287" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="1562" height="410" data-path="images/dark_mode/simplepearl_memory.jpg" />
      </div>
    </Frame>
  </div>

  <br />

  ***

  **Speech Recognition Keywords**

  Some words are just… not in the dictionary. Whether you're using brand-specific terms, creative product names, or industry jargon, teaching Pearl how to recognize them makes all the difference.

  Use this feature to define:

  * **Keywords**: The unique word or name you want Pearl to catch
  * **Pronunciations**: Variations of how users might say it (spoken form)

  <Card>
    ### Example

    Let's say your bakery sells a pastry called `FluffoBun`.

    Here's how you'd define it:

    * **Keyword:** FluffoBun
    * **Pronunciations:** fluh-foh-bun, floof-oh-bun, fluff-bunb\
      *(Separate each pronunciation with a comma)*

    This helps Pearl match even creatively named terms to real user input, no matter how it's pronounced.
  </Card>

  <div className="block dark:hidden">
    <Frame>
      <div className="p-1">
        <img src="https://mintcdn.com/nlpearl/dWWMdFzyPk-9Vcky/images/light_mode/simplepearl_keywords.jpg?fit=max&auto=format&n=dWWMdFzyPk-9Vcky&q=85&s=2861415b42a6797394a6f4af0ffb7f55" alt="Send Email action interface on light mode" className="rounded-[14px]" width="1562" height="586" data-path="images/light_mode/simplepearl_keywords.jpg" />
      </div>
    </Frame>
  </div>

  <div className="hidden dark:block">
    <Frame>
      <div className="p-1">
        <img src="https://mintcdn.com/nlpearl/nyDvVX0ZPwzeAWkt/images/dark_mode/simplepearl_keywords.jpg?fit=max&auto=format&n=nyDvVX0ZPwzeAWkt&q=85&s=6de2b92e19cda76d74513318cd56d924" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="1562" height="586" data-path="images/dark_mode/simplepearl_keywords.jpg" />
      </div>
    </Frame>
  </div>

  <br />

  ***

  **Speech Output Pronunciations**

  Speech Output Pronunciations let you fine-tune how Pearl *pronounces* specific words or short phrases out loud. You provide the text as it appears (**Pearl says**) and a simple phonetic respelling of how it should actually sound (**Caller hears**).

  **What it does**

  Whenever Pearl is about to speak a word or phrase listed in **Pearl says**, it pronounces it using the **Caller hears** respelling instead. It changes the **audio only**: your scripts, variables, and node text stay exactly as you wrote them.

  **When to use it**

  Reach for it whenever text-to-speech mispronounces something important, such as:

  * **Brand and product names**: `Nike` → `ny-kee`
  * **Acronyms** you want spelled out: `NLPearl` → `N-L-Pearl`
  * **Industry terms**: `SQL` → `sequel`
  * **Abbreviations** you want expanded: `Dr.` → `Doctor`
  * **Foreign or uncommon words** that need a specific phonetic reading

  **How to configure**

  <Steps>
    <Step title="Open the Knowledge Base">
      In the Flow Editor, open the **Knowledge Base** and scroll to **Speech Output Pronunciations**.
    </Step>

    <Step title="Add a row">
      In the empty row at the bottom, type the text in **Pearl says**, then the phonetic respelling in **Caller hears**.
    </Step>

    <Step title="Refine the respelling">
      Use plain, readable syllables separated by hyphens (e.g. `ny-kee`, `kwa-san`). No special phonetic alphabet is required, just write it the way it should sound.
    </Step>

    <Step title="Remove an entry">
      Use the trash icon on a row to delete it.
    </Step>
  </Steps>

  <Info>
    Write **Caller hears** the way it should be *spoken*, not spelled, e.g. `2024` → `twenty twenty-four`, or `NLPearl` → `N L Pearl`. Keep it simple and phonetic.
  </Info>

  <Warning>
    **Each row must have both fields filled**: a **Pearl says** value *and* a **Caller hears** value. Otherwise the row is flagged as incomplete. Empty rows are ignored and dropped when you save.
  </Warning>

  <Note>
    **Limits:** up to **25** entries, and each field is capped at **50 characters**.
  </Note>

  **Examples**

  | Pearl says | Caller hears       | Why                     |
  | ---------- | ------------------ | ----------------------- |
  | Nike       | ny-kee             | Brand name              |
  | NLPearl    | N-L-Pearl          | Spell out the name      |
  | SQL        | sequel             | Preferred pronunciation |
  | Dr.        | Doctor             | Expand the abbreviation |
  | 2024       | twenty twenty-four | Read the year naturally |

  **Speech Output Pronunciations vs. Speech Recognition Keywords**

  These two Knowledge Base tools are complementary, so don't mix them up:

  <Note>
    * **Speech Output Pronunciations** control how Pearl **speaks** (text-to-speech / output). Fields: **Pearl says** → **Caller hears**.
    * **Speech Recognition Keywords** help Pearl **understand** what the caller says (speech-to-text / input). Fields: a **keyword** plus one or more **pronunciations** it might be heard as.
  </Note>

  <br />
</Card>
