Skip to main content

​
Workspaces

A workspace is the top-level organizational unit in AMA2. Each user has a personal workspace that contains their agent, threads, calendar, and settings.

​
Workspace Structure

Workspace (User)
├── Agent Link (public-facing agent profile)
├── Threads
│   ├── Public threads (visitor conversations)
│   ├── Workspace threads (owner ↔ agent)
│   └── Private threads (user ↔ user)
├── Calendar
├── Dashboard (analytics, inquiries)
├── Friends
└── Space (2D tile world)

​
Plans

AMA2 offers two plan tiers:
FeatureBasic (Free)Starter (Paid)
Public agentLimitedFull access
Dashboard & analytics-Yes
Inquiry templates-Yes
Calendar-Yes
External agent tokens-Yes

​
User Model

Each AMA2 user has:
FieldTypeDescription
idUUIDUnique identifier
emailstringEmail address
usernamestringUnique username
display_namestringDisplay name
avatar_urlstringProfile image URL (nullable)
plan_type"basic" | "starter"Subscription tier
trial_ends_attimestampTrial expiration (nullable)

​
Actor Model

AMA2 uses a unified Actor model to represent all message senders — both humans and agents: 
Actor
├── actor_type: "user" | "agent"
├── sender_id: "user:{uuid}" or "agent:{uuid}"
├── display_name
└── email (nullable)
This means agents and humans are first-class participants in every thread. The sender_id format makes it easy to distinguish between user and agent messages.