Edge agents
Audience: Tenant admin
Goal: Register and monitor Edge Agents that execute queries in your network.
Edge Agents poll BI Core for work, run read-only SQL locally, and return results. Database credentials never leave your environment.
Register an agent
- Open Agents (
/agents).
Figure: Registered agents and status.
- Create a registration token (one-time secret—copy immediately).
- Deploy the agent container or process in your network:
bash
export VOICEBI_AGENT_TOKEN="<token-from-portal>"
export VOICEBI_CORE_URL="https://<bicore-host>"
# Start agent per your deployment guide- Wait for status ONLINE and recent heartbeat.
Agent detail
Open an agent to view Overview, Drivers, and Runtime tabs.
Figure: Per-agent overview and configuration tabs.
- Drivers — install database connectors required by your datasources.
- Runtime — override tenant defaults for this agent when needed.
Tips
- One agent can serve multiple datasources in the same network zone.
- Registration tokens are single-use; generate a new token if deployment fails.
- Use Operations to diagnose stuck tasks tied to an agent.
Troubleshooting
| Issue | What to try |
|---|---|
| Agent offline | Verify outbound HTTPS, token, and agent logs |
| Driver missing | Install connector from Drivers tab before schema discovery |
| Tasks not picked up | Confirm datasource is assigned to this agent |