Admin Panel — Overview
This page is your map of the admin panel. Every screen mentioned here gets its own dedicated page in this section — this is the directory.
Layout
The admin panel uses a fixed two-column layout:
- Sidebar (left) — primary navigation. Collapses to icon-only mode (the state is remembered in a browser cookie).
- Header (top) — global controls: language toggle, theme toggle, and the sidebar collapse handle.
- Main area — the page content.
Sidebar navigation
At the top of the sidebar a bot icon is shown next to the brand text “Polyant”. Sidebar items are grouped into two sections.
Overview (always visible)
| Icon | Item | What it shows |
|---|---|---|
| Dashboard | Cross-instance KPIs. | |
| Agents | The catalog of all assistants you have configured (route /instances). | |
| Conversations | Browse, search, and inspect every conversation across agents. | |
| Playground | A test chat for any agent. | |
| Activity | Live SSE feed of tool invocations, room cycles, and pipeline events (i18n key nav.activity). | |
| Memory | The long-term memory store across agents. | |
| Skills | The global skills catalog. | |
| Audit Logs | The full audit trail of tool calls and system events. |
Scheduled tasks do not have a top-level sidebar entry — they are accessible only as a subtab inside each instance’s Triggers tab.
Management (gated by role)
| Item | Visibility |
|---|---|
| Settings | Superadmin only (system settings + Users tab). |
Header controls
- Language toggle — switches the entire UI between English (EN) and Italian (IT). The change is live; no reload needed. The choice is persisted to local storage.
- Theme toggle — switches between light and dark modes (powered by
next-themes). - Sidebar trigger — collapses the sidebar to icons only.
Persistent UI state
Three pieces of UI state survive page reloads and tab restarts:
- Sidebar collapse state (cookie).
- Language preference (local storage).
- Theme preference (local storage).
Authentication state is in the authjs.session-token cookie; see Authentication.
Conventions used by every page
The admin panel follows a few consistent patterns. Knowing them makes new screens easy to predict.
- Search inputs are debounced. The list refreshes about 250 ms after you stop typing.
- Dangerous actions confirm first. Delete buttons always open an alert dialog with an explicit confirmation.
- Tables use pagination. Conversations show 20 per page; audit logs show 30 per page.
- Long-running actions show a spinner. Channel start/stop and bulk imports surface progress in the toast bar at the bottom right.
- Forms save explicitly. No edit auto-saves: there is always a Save button, and a “You have unsaved changes” warning if you navigate away.
Last updated on