Company Name
These settings live in the Knowledge Base tab of your Pearlâs editor (Edit Pearl in the Settings of the Pearlâs page). Changes are saved automatically in your Pearlâs draft: publish the Pearl to use them in live conversations. Give your Pearl the name of the company it represents. This name may be used when Pearl introduces itself or provides company-related information. Itâs required, up to 100 characters. Not representing a company? Write the name of the entity your agent says itâs from.

Company Description
Add a brief company description including your industry, mission, or key services. This allows Pearl to answer questions with more contextual relevance. Itâs required, up to 500 characters: a few sentences are enough.

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.

- Text: type directly in the field (optional). The expand icon at its bottom right opens it in a larger editor.
- Files: drop
.pdf,.docx, or.txtfiles anywhere on the section, or click Upload files. Each file shows as a chip with its size (and its progress while uploading); click its Ă to remove it.
Background knowledge, not a script. The Knowledge Base is passive reference data: Pearl consults it only when needed to answer accurately. It doesnât dictate the conversation flow, thatâs handled by the Flow Editor.
Both options live in the same area and can be combined: type your information directly in the text field and/or upload reference files. Multiple documents can be added if needed.
This is the same knowledge that powers the Knowledge Base node in the Flow Editor. What you add here is what your Pearl draws on during conversations.
Files and limits
These caps apply per Pearl: they cover every file attached to that Pearlâs Knowledge Base, not each file individually.
There is no page limit and no character cap on an individual document, only the shared 25 MB and 2,000,000-character totals apply. The free-text field has its own 20,000-character budget and does not consume the 2,000,000 characters reserved for files.
Text Pearls get twice the file budget of voice Pearls, which are capped at 1,000,000 characters.
Memory
When enabled, Pearl remembers the user or lead, allowing it to seamlessly continue conversations from where they left off. Choose On or Off (off by default).

- After each conversation, Pearl adds what it learned to a short profile of that person, built from the conversation summaries.
- The profile is kept per contact and per Pearl: the personâs phone number on SMS and WhatsApp, or their sender ID on other channels. At the start of the next conversation with the same contact, Pearl reads it and picks up from there.
- Pearls in a group with Shared Memory turned on share the same profiles.
- A conversation with no way to identify the contact is neither remembered nor recognized.
Example use case: Hospitality
Letâs say a guest checks into a hotel. Once theyâve mentioned it in a conversation, 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 chat
Resetting MemoryMemory is never cleared automatically. To give a contact a fresh start, reset its memory through the API (Reset Memory, with the phone number).This is especially important in contexts like hospitality: when a guest checks out, have your system reset the memory of their number, so the next guest starts with a clean experience.

