Agent Desktop/Account and help/Troubleshoot common problems
Troubleshoot common problems
Find the next action when a model, catalog, connector, browser task or account flow is not ready.
Most desktop issues have a visible state that points to the next action. Start with the area that is showing the problem.
The agent cannot answer
Open Models and check that a provider is configured and at least one model is enabled. For a local runtime, start Ollama or the compatible service, then choose Discover local models.
For an online provider, check the Base URL, API format, model ID and API key. The key can be added later when the provider supports keyless setup.
A capability is missing
Open Capabilities and check Activated, Favorites and Discovery. If the connector is activated, open its Connector Workspace and refresh AI Capabilities. A capability may be disabled or hidden by its group control.
A connector asks for credentials
Open the connector's Credentials tab, follow its setup guide, enter the required values and use Test Connection. Credentials are not supplied through the chat.
An action is blocked
Check the action policy. Deny is final until you change the policy. Ask pauses for confirmation. A missing requester or a declined confirmation means the action is not sent.
A remote MCP server will not install
Check the link shape and endpoint. Remote URLs require HTTPS, except localhost loopback. Remove embedded credentials, unsupported configuration fields and extra query parameters. The app will show an invalid-link dialog when validation fails.
The browser task stopped
Look at the browser activity in the Canvas. The site may need your approval, a sign-in or a new page state. Downloaded files appear in the Vinkius Agent Browser folder under your downloads location.
Governance shows sample data
A Sample Data badge means the displayed report is example data for the current account tier or state. It is not a record of your personal activity. Refresh after a connector changes.
Account or billing is unavailable
Check your sign-in state, reconnect the Vinkius account and retry. If the plan or usage still cannot load, the page keeps the unavailable state instead of changing your subscription automatically.
Still blocked
Collect the area name, visible error text and the action you took. Do not send API keys, passwords, cookies or full connector URLs in a support request.