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

# Agent Identity

> Configure your agent's avatar, name, timezone, and expert-only internal metadata in General settings

export const Screenshot = ({lightSrc, darkSrc, alt, caption, maxWidth = "880px"}) => {
  return <div style={{
    margin: "1rem auto",
    maxWidth,
    width: "100%"
  }}>
      <Frame>
        <img className="block dark:hidden" src={lightSrc} alt={alt} />
        <img className="hidden dark:block" src={darkSrc} alt={alt} />
      </Frame>
      {caption ? <p style={{
    marginTop: "0.5rem",
    fontSize: "0.875rem",
    color: "inherit",
    opacity: 0.8
  }}>
          {caption}
        </p> : null}
    </div>;
};

## Identity Settings

Your core identity settings are configured in the **Identity** section under **General** in the [agent editor](/build/getting-started/agent-editor). These settings control how the agent appears in your dashboard and demo links.

<Screenshot lightSrc="/images/agent__agent-identity-overview-light.png" darkSrc="/images/agent__agent-identity-overview-dark.png" alt="Agent Identity section showing avatar, name, and timezone fields" />

## Avatar

Upload an avatar image to visually identify your agent in the dashboard and in demo links shared with others.

### How to Upload

<Steps>
  <Step title="Open the agent editor">
    Select your agent from the [AI Agents](/build/getting-started/agent-editor) list
  </Step>

  <Step title="Navigate to Identity">
    Go to **General** → **Identity**
  </Step>

  <Step title="Upload an image">
    Click the avatar placeholder or the **Upload** button and select an image file from your device
  </Step>
</Steps>

### Image Specifications

| Property         | Requirement                   |
| ---------------- | ----------------------------- |
| **Format**       | PNG, JPEG/JPG, or WebP        |
| **File size**    | Maximum 5 MB                  |
| **Image size**   | Recommended 200x200px minimum |
| **Aspect Ratio** | Square (1:1)                  |

<Note>
  The avatar is visible when you share demo links. Choose an image that represents your brand professionally.
</Note>

***

## Agent Name

The agent name identifies this agent across the [dashboard](/manage/dashboard), [campaigns](/manage/campaigns/overview), reports, and demo links.

<Tip>
  If you plan to share demo links, use a professional agent name — it is visible to visitors. Internal labels like "Test Agent v3" are fine for agents you will not share publicly.
</Tip>

### Naming Best Practices

<CardGroup cols={2}>
  <Card title="Customer-Facing Names" icon="user">
    * "Acme Support"
    * "Alex from Acme Sales"
    * "Booking Assistant"
  </Card>

  <Card title="Internal Organization" icon="folder">
    * "Customer Support - Product Questions"
    * "Outbound Sales - Lead Qualification"
    * "Appointment Booking - Dental Clinic"
  </Card>
</CardGroup>

**Naming conventions for teams with multiple agents:**

* `[Function] - [Specialty]` (e.g., "Support - Billing")
* `[Department] - [Agent Type]` (e.g., "Sales - Qualifier")
* `[Use Case] - [Language]` (e.g., "Booking - Spanish")

***

## Timezone

Set the timezone used for date/time tools and scheduling. This ensures your agent references the correct local time during conversations.

Defaults to Europe/Vienna if not set.

***

## Tags

<Badge>Expert Mode</Badge>

Add multiple tags to categorize agents by team, function, or any other criteria.

***

## Notes

<Badge>Expert Mode</Badge>

Notes are not visible to callers or in demo links.

Use notes to record:

* The agent's primary purpose and use case
* Which team or department owns it
* Any special configuration details worth remembering

***

## Quick Reference

| Field        | Purpose                        | Visible To            | Mode   |
| ------------ | ------------------------------ | --------------------- | ------ |
| **Avatar**   | Visual identification          | Internal + Demo links | All    |
| **Name**     | Identify agent across platform | Internal + Demo links | All    |
| **Timezone** | Date/time reference for tools  | Internal only         | All    |
| **Tags**     | Organize and filter agents     | Internal only         | Expert |
| **Notes**    | Internal documentation         | Internal only         | Expert |

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Agent Editor Overview" icon="sliders" href="/build/getting-started/agent-editor">
    Explore all sections in the agent editor
  </Card>

  <Card title="Write Your Prompt" icon="pen" href="/build/conversation/prompt">
    Define your agent's conversational behavior
  </Card>
</CardGroup>