Core Concepts
The relationship between Workspace, Agent, Group, SubAccount, and Thread.
Workspace / Organization
A workspace is the organization boundary in AgentBox. A registered user automatically owns a workspace for managing agents, members, and sub-accounts.
Agent
An agent is an AI assistant configured by a creator. It includes a system prompt, model configuration, tool capabilities, and chat features.
Group
Groups are used for bulk authorization. Creators can add multiple sub-accounts to a group and grant agent access to that group.
SubAccount
A sub-account is a managed account created by an owner. It is separate from better-auth's Member model and can only access agents linked to its groups.
Thread
A thread is a conversation between a user and an agent. It contains multiple messages. Sub-accounts can only view their own threads.