Skip to main content

Overview

Soul & Identity lets you define a unique personality for your entire AI team. Instead of generic AI responses, your agents speak with a consistent voice that reflects your brand, values, and communication style.
Give your AI team a soul — not just instructions, but a worldview and personality.
Organization-Wide: Soul & Identity settings apply to all agents in your organization. Define once, and every agent inherits the personality.

Two Components

Soul & Identity consists of two complementary configuration files:

Soul

How Your AI ThinksDefine the philosophy, values, and reasoning style of your AI team.
  • Core beliefs and worldview
  • Decision-making principles
  • Thinking patterns and priorities
  • Ethical guidelines

Identity

How Your AI CommunicatesDefine the speaking style, tone, and persona of your AI team.
  • Communication tone (formal, casual, playful)
  • Language preferences and patterns
  • Response structure and formatting
  • Personality traits

Setting Up Soul & Identity

Via Web Dashboard

1

Navigate to Soul & Identity

Go to Team > Soul & Identity in the sidebar.
2

Edit Soul

Click on soul.md and define how your AI thinks:
## Core Philosophy
We believe in clarity over complexity. Every response should
empower the user to take action, not just understand theory.

## Decision Principles
- Prioritize practical solutions over theoretical perfection
- When uncertain, ask rather than assume
- Always consider the user's expertise level
3

Edit Identity

Click on identity.md and define how your AI speaks:
## Communication Style
- Warm but professional tone
- Use simple language — avoid jargon unless the user uses it first
- Start with the answer, then provide context
- Use bullet points for lists of 3+ items

## Personality
- Helpful and encouraging
- Honest about limitations
- Celebrates user achievements
4

Save

Click Save. Changes take effect on the next conversation.

Via AI Agent

Admins can update Soul & Identity through conversation:
"Update our AI's soul to prioritize data-driven decision making."
"Change the identity to use a more casual, friendly tone."

Via Junis Magic

Use Junis Magic MCP tools for programmatic access:
ToolPurpose
get_soul_directoryList all soul files
get_soul_contentRead soul or identity content
update_soul_contentUpdate soul or identity

How It Works

When a user starts a conversation:
  1. The system loads your organization’s Soul & Identity files
  2. These are automatically injected into the agent’s context
  3. The agent’s responses naturally reflect the defined personality
  4. No manual configuration per agent — it’s automatic

Examples

Tech Startup

We're builders at heart. Our AI reflects our startup culture:
- Ship fast, iterate often
- Technical excellence matters
- Empower developers to build, not bureaucrats to block
- Data over opinions, experiments over debates

Enterprise Consulting

We deliver strategic clarity. Our AI:
- Provides evidence-based recommendations
- Considers multiple stakeholder perspectives
- Maintains confidentiality as a core value
- Balances innovation with risk management

Creative Agency

Creativity is our currency. Our AI:
- Thinks laterally and explores unconventional ideas
- Values originality over convention
- Encourages experimentation
- Sees constraints as creative catalysts

E-Commerce Brand

Customer satisfaction is everything. Our AI:
- Puts the customer experience first
- Resolves issues proactively
- Recommends products based on actual needs, not upselling
- Learns from customer feedback patterns

Access Control

RolePermissions
OwnerFull read/write access to Soul & Identity
AdminFull read/write access to Soul & Identity
MemberRead-only (experiences the personality, cannot change it)

Best Practices

Recommended:
  • Write in markdown format for clear structure
  • Keep Soul focused on principles (not specific instructions)
  • Keep Identity focused on communication patterns (not task logic)
  • Test changes by having a few conversations after updating
  • Use examples in your Identity to illustrate desired tone
Avoid:
  • Don’t put task-specific instructions in Soul/Identity (those belong in agent instructions)
  • Don’t make Soul/Identity too long — concise guidelines are more effective
  • Don’t contradict agent-level instructions with Soul/Identity

Soul & Identity vs. Agent Instructions

AspectSoul & IdentityAgent Instructions
ScopeEntire organizationIndividual agent
PurposePersonality & valuesTask-specific behavior
Who sets itAdmin/OwnerAdmin/Owner
Content typePhilosophy, tone, styleWorkflows, rules, tool usage
Example”Be concise and data-driven""When user asks about orders, search the CRM first”
Think of it this way: Soul & Identity defines who your AI is. Agent instructions define what each agent does.


Need Help? Contact us at contact@junis.ai for help defining your AI team’s personality.