Troubleshooting JARIA Agents¶
Use this page to check the most common issues when a JARIA agent is configured but does not behave as expected at runtime.
The interaction button appears but the agent does not listen
Check microphone permission, speech package installation, speech key, speech region, language settings, and internet connectivity.
The agent answers without project-specific knowledge
Confirm that the Portal agent is linked to the expected libraries and that the Agent ID in Creator matches the Portal agent.
The state-aware answer is empty or generic
Confirm that the scenario graph is running and that the current action has a meaningful description and related objects.
The agent speaks with the wrong voice or language
Review the configured voice and language values. If a custom speech endpoint is used, confirm that it belongs to the same speech service region.
The agent does not respond or times out
Confirm that the device has a working internet connection and can reach the required speech services, JARIA Cloud, and language-model services. If connectivity is available, check that the user’s credits are not exhausted.