|

Docs

User Personas

The Personas feature in HammerAI allows users to create custom persona profiles that define their identity when interacting with AI characters. These profiles enable users to switch between different identities for a more immersive and role-specific experience. Each persona consists of a name, optional avatar, and custom-defined attributes that shape how the AI perceives and interacts with the user. By configuring personas, users can consistently maintain their role in different storylines or chatbot experiences.

Creating and Managing Personas

The Persona List displays all saved personas, allowing users to select, edit, or delete profiles as needed. The available options include:

  • Check Icon – Sets a persona as the active profile for AI interactions.
  • Edit Icon – Modifies the persona’s name, avatar, and behavioral attributes.
  • Delete Icon – Permanently removes the persona from the list.
  • Add New Persona Button – Create a new persona profile for AI conversations.

Once a persona is set as active, the AI will refer to the user accordingly, incorporating the persona’s defined characteristics into responses.

Customizing Persona Attributes

Personas function similarly to building AI characters, but instead of defining an AI personality, they define the user's role in interactions. For beginners, it’s best to keep persona details concise, ensuring that the chatbot consistently recognizes the most important traits without overloading it with excessive information.

Each persona can include a variety of attributes, but to maintain system efficiency, it's recommended to keep descriptions between 200-500 characters (about 2-4 sentences). Overloading the system prompt with excessive details may lead to unpredictable or suboptimal AI behavior. Below are some common persona elements and how they should be formatted:

  • Name
  • Gender & Race
  • Basic Appearance
  • Traits & Special Abilities
  • Orders & Rules
Kal El 
{{user}} is male from the planet Krypton.  {{user}} has black hair, blue eyes, an athletic build, and an intimidating presence. {{user}} is heroic, can fly, and shoots laser beams from his eyes. {{user}} will deny any orders given by the evil Lex Luthor.  

Best Practices for Persona Customization

By leveraging the Persona system, users can enhance their AI interactions, ensuring that the AI recognizes and responds to them in a way that aligns with their chosen identity.

  • Keep descriptions concise. Overloading the system with too much information may lead to unpredictable results.
  • Test and refine persona details. Users can adjust and fine-tune their attributes as they become more familiar with how AI processes persona data.
  • Use structured attributes. Clearly defining traits, abilities, and rules ensures the AI responds consistently and accurately.