An agent is not working
Who this is for: an owner whose agent went quiet.
Read the desk first
Section titled “Read the desk first”| What you see | What it means | What to do |
|---|---|---|
| Sleeping — no gateway, no automations | The agent is asleep: no channels, no scheduled jobs. Chatting with it in the panel still works. | Wake up (start gateway) on its desk, or ask any agent to wake it. |
| Needs attention | Setup failed halfway (a download, a model without a key, a port in use). | Open the agent’s settings → Retry setup; it resumes from the failed step. |
| A grey, transparent avatar at its desk | Asleep and idle. | Same as sleeping. |
| “The agent runtime is not running” | The Hermes runtime behind every agent stopped. | Press the runtime button in the top bar to start it; if it keeps stopping, run Run agent health check in Settings. |
| Nothing moves, no bubbles, no runs since yesterday | The app was closed — every agent stops with it. | Open the app; the agents that were awake wake again and missed jobs run once. See Keeping the office running. |
An agent that is awake but silent on a channel
Section titled “An agent that is awake but silent on a channel”- Settings → Accounts: click the agent’s row — is it connected, or does it show paused (asleep) or error? Press Test connection.
- Who can chat: on a Private channel only listed ids get an answer; strangers are ignored. See Who can chat.
- Automations: an incoming-message automation (leads from WhatsApp, complaints, one number for the team) must be on for the channel to do more than chat.
- Model: an agent without a working model answers nothing — see Model problems.
Auto-sleep
Section titled “Auto-sleep”Settings → Office → Put idle agents to sleep after (default 2 hours) puts an agent with no activity to sleep to save memory. The app wakes it a few minutes before its next scheduled job; a customer message does not wake a sleeping agent — keep customer-facing agents awake or the auto-sleep off.
Ask your agent
Section titled “Ask your agent”✦ Ask your agent
Things you can say to an agent in Bakulai Agent:
“why is the sales agent not answering WhatsApp?”“the agent says needs attention”- “which agents are asleep or broken?”runs directly
- “wake Ani”runs directly
- “Ani needs attention, fix her”runs directly
