Agents

Connect your chatbot to Voxli so you can run tests against it.

What agents are

An agent is a connection between Voxli and your chatbot or AI assistant. When you run a scenario, Voxli sends messages to the agent and records the responses. You need at least one agent to run tests.

Agent types

Voxli supports several agent types for different integration methods:

• Demo - a built-in test agent that comes with every account. No setup required. Great for learning Voxli before connecting a real chatbot.
• API - gives you full control. You trigger and manage the conversation from your side using the Voxli API.
• GitHub - runs tests as part of a GitHub Actions workflow. See GitHub in the developer docs.

The Demo agent

Every account has a Demo agent available out of the box. Use it to explore Voxli’s features without connecting a real chatbot.

The Demo agent has limited responses - it’s designed for learning the platform, not for production testing.

Connecting a new agent

1. Go to the Agents page in the left sidebar.
2. Click Connect agent.
3. Select the agent type.
4. Fill in the required configuration. Each agent type has different settings.
5. Save the agent.

The new agent appears on the Agents page and becomes available in the run dialog when you run scenarios.

Enabling and disabling agents

You can enable or disable an agent from its three-dot menu on the Agents page. Disabled agents stay configured but don’t appear in the agent selection when running scenarios. This is useful when you want to temporarily stop testing against an agent without losing its configuration.