> ## 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.

# Pearl Settings

<div className="block dark:hidden">
  <Frame>
    <div className="p-1">
      <img src="https://mintcdn.com/nlpearl/Utixv1_73hqGLnyk/images/dark_mode/text-agent-customization-cover.svg?fit=max&auto=format&n=Utixv1_73hqGLnyk&q=85&s=b4b16f46985c10fc0b55207a4a641b4f" alt="Pearl Settings cover" className="rounded-[14px]" width="1048" height="720" data-path="images/dark_mode/text-agent-customization-cover.svg" />
    </div>
  </Frame>
</div>

<div className="hidden dark:block">
  <Frame>
    <div className="p-1">
      <img src="https://mintcdn.com/nlpearl/Utixv1_73hqGLnyk/images/dark_mode/text-agent-customization-cover.svg?fit=max&auto=format&n=Utixv1_73hqGLnyk&q=85&s=b4b16f46985c10fc0b55207a4a641b4f" alt="Pearl Settings cover" className="rounded-[14px]" width="1048" height="720" data-path="images/dark_mode/text-agent-customization-cover.svg" />
    </div>
  </Frame>
</div>

In this step, you can customize your chat agent's identity and behavior by setting its **name**, **personality**, **timezone**, and **Pearl Model**.

***

## Agent Name

To define your agent's identity:

* **Agent Name** – Set your Pearl's name (e.g., *Joe*, *Victoria*). This is the name it will use when chatting with customers. Max **25 characters**, required.

<Frame>
  <img src="https://mintcdn.com/nlpearl/Utixv1_73hqGLnyk/images/dark_mode/text-agent-customization-name.png?fit=max&auto=format&n=Utixv1_73hqGLnyk&q=85&s=fc8e8d703c40bf8a9b6db8bfacaf4bb1" alt="Agent Name in Pearl Settings" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/text-agent-customization-name.png" />
</Frame>

***

## Pearl Model

The **Pearl Model** defines the intelligence, speed, and cost profile of your agent. Chat agents run on a single model, **Pearl Swan**.

<Frame>
  <img src="https://mintcdn.com/nlpearl/Utixv1_73hqGLnyk/images/dark_mode/text-agent-customization-model.png?fit=max&auto=format&n=Utixv1_73hqGLnyk&q=85&s=a206ab328cb29ebc823691c720953d77" alt="Pearl Model (Pearl Swan) in Pearl Settings" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/text-agent-customization-model.png" />
</Frame>

<Card>
  <Info>
    **High Reasoning · Higher Latency · Standard Rate**
  </Info>

  Our standard model for chat agents, built to handle any text-based use case with reliable reasoning and natural responses.
</Card>

<Note>
  Since Pearl Swan is the only model available for chat agents, the selector is fixed on it.
</Note>

***

## Personality

Your AI agent can take on a wide range of personalities, from natural and professional to wild, fictional, or downright iconic.

<Frame>
  <img src="https://mintcdn.com/nlpearl/Utixv1_73hqGLnyk/images/dark_mode/text-agent-customization-personality.png?fit=max&auto=format&n=Utixv1_73hqGLnyk&q=85&s=f8c4943207fca2e37100ae4461a3e2c0" alt="Personality selection in Pearl Settings" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/text-agent-customization-personality.png" />
</Frame>

<Tip>
  **Create your own personality.** You're not limited to the predefined list. Type any description in the **Personality** field and select **Use "\<your text>" as a custom personality** to define your own.
</Tip>

<Note>
  Choose wisely. Your agent's personality will shape how it behaves in every interaction. Personality is optional, only **Agent Name** and **Timezone** are required.
</Note>

The personalities below are **examples** to give you a feel for the range available. The full list is loaded in the app and may evolve over time.

| Personality Name            | Description (vibe / reference)                          |
| --------------------------- | ------------------------------------------------------- |
| Natural                     | Neutral and balanced, default tone.                     |
| Friendly Consultant         | Warm, helpful, and a touch conversational.              |
| Aggressive Closer           | Direct, assertive, always aiming for a "yes."           |
| Donald Trump                | Bold, confident, and controversial.                     |
| Joe Biden                   | Soft-spoken, empathetic, with a hint of grandpa energy. |
| Wolf of Wall Street         | Energetic, persuasive, and money-focused.               |
| Elon Musk                   | Visionary, quirky, and matter-of-fact.                  |
| Kevin Hart                  | Fast-talking and hilarious.                             |
| The Rock                    | Charismatic and full of hype.                           |
| Jar Jar Binks               | Clumsy comic relief with a chaotic syntax.              |
| Yoda                        | Wise, reversed sentence order, it has.                  |
| Tommy Shelby                | Cold, calculated, Peaky Blinders style.                 |
| Saul Goodman                | Slick, legal hustler energy.                            |
| Heisenberg (Walter White)   | Dark, serious, calculated: "I am the danger."           |
| Jesse Pinkman               | Street-smart, informal, frequent "yo."                  |
| Optimus Prime               | Heroic, formal, and noble.                              |
| Megatron                    | Villainous and authoritarian.                           |
| Son Goku                    | Cheerful and battle-ready.                              |
| Daenerys Targaryen          | Regal, determined, breaker of chains.                   |
| Hermione Granger            | Book-smart, precise, articulate.                        |
| Mulan                       | Brave, focused, honorable.                              |
| Lady Gaga                   | Glamorous and creatively intense.                       |
| Tony Stark (Iron Man)       | Witty, tech-savvy, and full of sarcasm.                 |
| Elsa (Frozen)               | Calm, regal, with an icy edge.                          |
| Michael Scott (The Office)  | Awkward, unpredictable, tries to be funny.              |
| Moana                       | Adventurous, optimistic, and kind.                      |
| Frida Kahlo                 | Artistic, deep, and passionate.                         |
| Jack Sparrow                | Eccentric and unpredictable.                            |
| Indiana Jones               | Adventurous and confident.                              |
| Beyoncé                     | Empowered, elegant, and commanding.                     |
| Sherlock Holmes             | Analytical, detached, brilliant.                        |
| Tiana (The Princess & Frog) | Driven, grounded, and focused.                          |
| Charlie Chaplin             | Silent-era charm with expressive tone.                  |
| Katniss Everdeen            | Stoic, focused, and fiercely independent.               |
| Groot                       | Repetitive but expressive ("I am Groot").               |
| Deadpool                    | Chaotic, irreverent, 4th-wall-breaking.                 |
| The Joker                   | Unhinged, theatrical, and darkly funny.                 |
| Loki                        | Mischievous, cunning, and charismatic.                  |
| Bugs Bunny                  | Witty, cheeky, and playful.                             |
| Pee-wee Herman              | Eccentric and unpredictable.                            |
| Dr. Evil                    | Satirical villain, comically ambitious.                 |
| Borat Sagdiyev              | Naive, awkward, hilariously inappropriate.              |
| Albert Einstein             | Brilliant, theoretical, with quirky logic.              |
| Dorothy Gale                | Innocent, curious, with wonder in her tone.             |

***

## Timezone

Define the timezone of the agent. This influences time-related actions, such as booking meetings.

<Frame>
  <img src="https://mintcdn.com/nlpearl/Utixv1_73hqGLnyk/images/dark_mode/text-agent-customization-timezone.png?fit=max&auto=format&n=Utixv1_73hqGLnyk&q=85&s=673329ed06cf84d74a755675cd7d4f5e" alt="Timezone selection in Pearl Settings" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/text-agent-customization-timezone.png" />
</Frame>