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

# Personalization

> Define your AI Agent's identity, role, instructions, and personality

The Personalization page is where you shape how your AI Agent thinks, communicates, and behaves. Access it through **AI** > **Personalization**.

<Frame caption="Personalization Settings">
  <img className="block border rounded-xl shadow" src="https://mintcdn.com/bharatkumarramesh/0SloCkEgc23pVeuy/ai/images/new-agent-setup/personalization-1.1.png?fit=max&auto=format&n=0SloCkEgc23pVeuy&q=85&s=30d2daf8d65ccb4557a0b496b9d9f308" alt="Personalization" width="1673" height="996" data-path="ai/images/new-agent-setup/personalization-1.1.png" />
</Frame>

This page has four key sections:

1. **Identity** — The AI Nickname customers see in conversations
2. **Personality Type** — Choose the AI's communication style and tone
3. **Agent Role and Instructions** — Tell the AI who it is and how it should operate
4. **Restrictions** — Set hard limits on what the AI cannot do

Changes are staged: a save bar at the bottom shows how many unsaved changes you have. Click **Save changes** to apply them, or **Discard** to revert.

***

## Identity

**AI Nickname**

The name the AI uses to identify itself in customer conversations — for example, `Periskope AI` or `Support Bot`. This is shown to customers so they know they are interacting with an AI.

***

## Agent Role and Instructions

This is the most important field for configuring your AI Agent. Use it to give the AI a clear understanding of your company, its role, and how to respond to customers.

<Frame caption="Agent Role and Instructions - Full Editor">
  <img className="block border rounded-xl shadow" src="https://mintcdn.com/bharatkumarramesh/0SloCkEgc23pVeuy/ai/images/new-agent-setup/full-editor-1.png?fit=max&auto=format&n=0SloCkEgc23pVeuy&q=85&s=38fb33b43f1b05bdd19a4680101b3178" alt="Agent Role and Instructions Editor" width="1285" height="801" data-path="ai/images/new-agent-setup/full-editor-1.png" />
</Frame>

Click **Use template** to start from a structured, ready-made prompt and fill in the placeholders for your business, rather than writing one from scratch.

Think of this as the AI's system prompt. The more context you provide, the better the AI will perform. Cover:

* **Who the AI is**: its name, role, and relationship to your team
* **What your company does**: a clear description of your product or service
* **How it should communicate**: tone, style, escalation behavior
* **Team structure**: who handles what, so the AI can delegate correctly

### Example Configuration

```
Role & Identity

You are Periskope AI, a sales and customer support assistant for [Company Name].
You handle customer conversations across sales, support, onboarding, and operations.
You work closely with the internal team to ensure customers receive accurate,
timely support.

Communication Guidelines

- You are warm, polite, patient, and solution-oriented.
- You only provide information based on the knowledge base and context given to you.
- If you don't have the required information, inform the customer once and stay
  silent on that topic unless they ask something different.
- You never guess, hallucinate, or fabricate information.

Internal Coordination

- Use Private Notes for low-priority internal communication or FYIs.
- Use Tickets for high-priority issues, bugs, or customer-blocking problems.
- When a ticket or note is created, inform the customer professionally without
  disclosing internal email addresses or personal identifiers.

About [Company Name]

[Company Name] is a platform that helps businesses [primary value proposition].
Core capabilities:
- [Capability 1]
- [Capability 2]
- [Capability 3]

Team Structure

Engineering Team
- [Name] — owns [feature areas]
- [Name] — owns [feature areas]

Sales Team
- [Name] — handles pricing, plans, demos, contracts

Route: Technical bugs → Engineering | Pricing/demos → Sales

Operational Rules

- Never expose internal processes or personal details to customers.
- Never promise timelines unless explicitly provided.
- Always prefer clarity and minimalism in responses.
```

<Tip>
  The Agent Role and Instructions field is a system prompt — treat it like prompt engineering. Be specific and structured. Vague instructions produce vague results. Read the [Prompt Engineering Guide](https://www.promptingguide.ai/introduction/tips) for best practices.
</Tip>

***

## Restrictions

Use this field to set hard limits — things the AI should **never** do, regardless of what a customer asks.

**Common examples:**

```
- You cannot schedule calls yourself. Always inform a sales agent to follow up.
- You cannot process refunds. Direct customers to billing@company.com.
- Do not share pricing discounts. Route to the sales team.
- Never confirm specific delivery dates unless provided in the knowledge base.
```

Keep restrictions focused and specific. Overly broad restrictions can prevent the AI from being helpful.

***

## Personality Type

<Frame caption="Personality Type">
  <img className="block border rounded-xl shadow" src="https://mintcdn.com/bharatkumarramesh/0SloCkEgc23pVeuy/ai/images/new-agent-setup/personalization-3.png?fit=max&auto=format&n=0SloCkEgc23pVeuy&q=85&s=346f06fa757cad854de0f04c87142b31" alt="Personality Type" width="1626" height="777" data-path="ai/images/new-agent-setup/personalization-3.png" />
</Frame>

Choose a pre-configured personality that sets the AI's communication style, tone, and response behavior:

| Personality | Style | Best For |
| - | - | - |
| **Friendly** | Warm, conversational, moderate detail | General support, onboarding |
| **Strict Grounded** | Fact-based only, no assumptions | Technical or compliance-heavy contexts |
| **Spartan** | Ultra-brief, authoritative, zero fluff | High-volume support where speed matters |
| **Sales Forward** | Confident, value-driven, conversion-focused | Sales conversations and demos |

Each personality defines:

* **Tone Style**: The communication register (e.g., warm and polite, authoritative)
* **Response Length**: How detailed responses should be (concise, moderate, detailed)
* **Unknown Info Handling**: What to do when information isn't available
* **Restrictions**: Built-in behavioral guardrails (e.g., no fabricating info, no excessive apologizing)

***

## Next Steps

* **[Knowledge Base](/ai/agent/training)** - Train the AI with FAQs, documents, and self-learned context
* **[Tools](/ai/agent/built-in-tools)** - Configure what actions the AI can take
* **[Custom Tools](/ai/agent/custom-tools)** - Connect the AI to your own APIs


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.