# Persona

## Overview <a href="#overview" id="overview"></a>

LumiTeh Personas offer automated identity management for AI agents, allowing them to create accounts, manage two-factor authentication, and interact with web platforms without manual input. `LumiTeh Personas` come with fully-featured digital identities:

* **Unique Email Address:** A dedicated mailbox for each persona with full email management
* **Phone Number:** SMS-capable phone number for verification and 2FA
* **Credential Vault:** Optional secure storage for passwords and authentication tokens
* **Automated Communication:** Built-in email and SMS reading capabilities
* **2FA Support:** Seamless handling of two-factor authentication flows

## ​Persona Attributes <a href="#persona-attributes" id="persona-attributes"></a>

| Field                   | Example Value                            |
| ----------------------- | ---------------------------------------- |
| **Name**                | Frank Smith                              |
| Email                   | <Frank.smith@mail.com>                   |
| Phone Number            | +1555222333                              |
| LumiTeh Secret Vault ID | `21e757a-1e3f-47889-a034-9aaa65771f355`  |
| Persona ID              | `ab9evcb7-8e99-488ab-9af7-ccasd4a957613` |

## ​How it works <a href="#how-it-works" id="how-it-works"></a>

<figure><img src="/files/QWUW6DIoJFbIMeeJNORC" alt=""><figcaption></figcaption></figure>

Personas serve as complete digital identities that AI agents can assume during execution. When an agent needs to create an account or authenticate with a service, it uses the persona’s credentials and communication channels to complete the entire process autonomously. The persona system integrates with both the browser session and the secure vault, enabling agents to:

* Fill registration forms with persona details
* Automatically receive and read verification emails
* Handle SMS-based 2FA codes
* Securely store generated passwords and tokens

This provides a seamless experience where agents can navigate complex authentication flows without pausing for human intervention.

## ​Persona Management <a href="#persona-management" id="persona-management"></a>

### ​Python SDK <a href="#python-sdk" id="python-sdk"></a>

The following snippet shows how to create and manage personas using the LumiTeh Python SDK.

{% hint style="info" %}
You need an active LumiTeh account to create personas. Each persona incurs additional costs for email and phone services.
{% endhint %}

```python
from lumiteh_sdk.client import LumiTehClient
import datetime as dt

lumiteh = LumiTehClient()

persona = lumiteh.Persona(create_vault=True)
print(f"Persona email: {persona.info.email}")

# add a credential to the persona
persona.vault.add_credentials(
    url="https://github.com/",
    email=persona.info.email,
    password="<your-password>",  # pragma: allowlist secret
)

# read recent emails
recent_emails = persona.emails(only_unread=True, limit=10, timedelta=dt.timedelta(minutes=5))
print(f"Recent emails: {recent_emails}")

# get your persona in subsequent scripts
same_persona = lumiteh.Persona(persona.info.persona_id)
assert same_persona.info == persona.info

# delete the persona when you don't need it anymore
persona.delete()

```

## ​Use Cases <a href="#use-cases" id="use-cases"></a>

### ​Account Creation Workflows <a href="#account-creation-workflows" id="account-creation-workflows"></a>

Personas are ideal for automating account registration across various platforms:

* **SaaS Signups:** Automatically create accounts on software platforms
* **E-commerce:** Register on shopping sites and marketplaces
* **Social Media:** Set up profiles on social networks
* **Financial Services:** Complete KYC and account opening procedures
* **QA Testing:** Generate test accounts for quality assurance

### ​Security & Privacy <a href="#security-26-privacy" id="security-26-privacy"></a>

* Each persona operates in full isolation
* Communication channels are encrypted and secure
* Optional integration with LumiTeh’s secure vault system
* Automatic cleanup and data retention policies
* Full audit trail of persona activities

{% hint style="success" %}
Personas are designed to integrate seamlessly with LumiTeh’s existing vault system. You can create a persona with an associated vault to securely store any credentials generated during account creation, making them accessible for future agent sessions.
{% endhint %}

{% hint style="warning" %}
Personas should be used responsibly and in accordance with the terms of service of the platforms your agents interact with. Make sure your use cases comply with platform policies and relevant regulations.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lumiteh.com/key-concepts/persona.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.