Skip to main content
Most problems in Erstan come down to a missing connection, an authorization that needs renewing, or an agent that can’t start. This page walks through the issues people hit most, with the fastest fix for each.
Many issues fix themselves once the right connection is healthy. Check Connectors first — a status badge there usually points straight at the cause.

​
Common issues

Chat and agents need a connected AI model to run. When no LLM provider is connected, the composer is disabled and reads Connect an LLM to start chatting… with a link to Connectors.
1

Open Connectors

Go to Connectors in the workspace, or click the link in the composer message (it opens Connectors filtered to AI providers).
2

Connect a provider

Open OpenAI or Anthropic, go to the Tokens tab, paste your workspace Provider API key, and save.
3

Enable a model

On the Models tab, enable at least one model and save. That model becomes selectable in chat.
One workspace API key is stored per provider, and the available models are managed by your Erstan admin — you choose which of them to enable. Connecting a provider is an Owner/Admin action.
If an agent or chat needs NetSuite and it isn’t connected, you’ll see a Connection required banner (amber) on the agent, or a prompt in chat. NetSuite connects in two stages.If the workspace connection exists but you personally haven’t authorized, open the NetSuite connector’s Authorizations tab — your Your NetSuite user card will read Authorization required. Click Authorize and approve in the NetSuite popup.
The connect and authorize flows open a NetSuite popup and poll for completion. If nothing happens, your browser is likely blocking popups — allow popups for Erstan and try again.
NetSuite access tokens are short-lived (roughly one hour), and Erstan refreshes them automatically in the background. If a refresh fails or the connection goes stale, you’ll see Authorization expired or Endpoint unhealthy on the connector.
1

Re-authenticate your user

On the Authorizations tab, click Re-authorize on your Your NetSuite user card and approve in the NetSuite popup. This re-grants access using your own NetSuite role.
2

Test the workspace connection

Owners and admins can open the Setup tab and use Test connection, then Test token refresh to confirm the workspace OAuth connection can renew tokens.
See Connection troubleshooting for the full list of statuses and what each one means.
When NetSuite is handling other work, Erstan briefly holds a request and shows a Queued — NetSuite card. This is informational only — it has no buttons and resumes automatically when capacity frees up.
A Queued card is intentionally different from an approval card. It means “waiting its turn,” not “waiting for you.” There’s nothing to click; leave it and the run continues on its own.
If a run sits queued far longer than expected, check the connector’s status — an expired authorization (above) can stall work that’s waiting on NetSuite.
Writes to NetSuite and other systems pause for you by default: you see an approval card with Run action / Don’t run before anything is changed. If a write happened without prompting, Auto-approve writes is likely on.
  • Auto-approve writes is toggled from the chat composer’s + menu and is remembered in your browser. It only applies in plain chat with the default Erstan assistant — not to custom agents you’ve built or @mentioned.
  • For agents, whether a tool prompts is set by its write policy per tool: Allow, Require approval, or Deny (see Managing NetSuite: tools & write policy).
Auto-approve lets agents write to your ERP without a confirmation step. Turn it on only for low-risk, well-understood tasks, and turn it back off when you’re done. Review the full behavior in Approving and rejecting AI actions.
If an agent reaches for a connected system you haven’t authorized yet, chat surfaces an Authorization required card. Authorize the account from the card (or from the connector’s Authorizations tab), then continue the conversation — the run picks up where it left off.
Run details stream live. If a run is idle for a long time, it shows a stale status with a Refresh trace (or Retry Run) affordance.
1

Refresh the trace

Click Refresh trace to re-sync the run’s live status. Long-idle runs often just need a refresh to show their latest state.
2

Check for a waiting approval

A run can pause indefinitely on an approval or an Authorization required card. Open the run and respond so it can resume.
3

Retry if it failed

If the run errored, use Retry Run from the run detail. Review the step trace first to see where it stopped — see Run history, traces & analytics.
An agent can’t start for a few specific reasons. The library or run dialog will tell you which one applies:

​
Getting help

If you’ve worked through the relevant fix above and an issue persists, gather the details that speed up support: the workspace name, the agent or chat involved, and the run’s trace (use Audit in Erstan from a run for the full record). Then reach out to your Erstan contact or workspace Owner.
Erstan is in Beta. Some surfaces are still changing, and a few connectors are marked Coming soon and can’t be connected yet.

​
Next steps

Connection troubleshooting

Connection statuses, re-authenticating, and token lifetimes in depth.

Approving AI actions

How write approvals, auto-approve, and queued cards work.

Run history & traces

Read a run’s step-by-step trace to find where it stopped.

Security & write safety

How Erstan keeps you in control of every NetSuite change.