KoaPanel
IT Try it free
All manual sections

DocumentationAI assistant

AI assistant

The AI assistant diagnoses a site with an artificial intelligence model (Anthropic's Claude): it reads the site's logs, configuration and responses, finds the problems and explains them in plain words. When the remedy is a panel setting, it also proposes the fix, which you apply with one click and can undo.

Turning it on (administrators)

Open AI assistant and, in the settings, choose the AI provider:

  • KoaPanel AI (default): no key to enter. The requests go through the KoaPanel console with this server's license, which calls the model with KoaPanel's key: the key never reaches the panel. Every license, the free one and the distributors' ones too, includes 100 calls to Haiku and 5 to Sonnet every month. The panel must be linked to an account (the license in "Plan and license"): otherwise the panel says so and you can use your own key;
  • Your own Anthropic key: enter an Anthropic API key (create it at console.anthropic.com, API Keys section) and pay Anthropic directly, without using the credits. The key is encrypted on the server, never shown again nor written to the logs; you can replace or remove it at any time (without a key the panel goes back to KoaPanel AI).

With your own key you also choose:

  • the model: the recommended one is Claude Sonnet 5.5, a good balance between quality and cost; you can pick a more capable model (Opus 5.5, Fable 5.1) or a cheaper one (Haiku 5.5), or type another id;
  • the monthly token budget: beyond the limit diagnoses stop until next month (0 = no limit).

With both you can turn on the nightly check of all sites (optional) and decide whether resellers and users can use the AI (see below).

Credits and KoaPanel AI PRO

With KoaPanel AI the KoaPanel AI credits box shows, for the current month, the calls to Haiku and to Sonnet used and those left. The credits are for the calendar month and do not carry over. When they are used up, the assistant says so and stops until next month.

With Upgrade to PRO you buy the KoaPanel AI PRO subscription from the console (€29 a month, tied to the license): 3,000 calls to Haiku and Sonnet up to €10 of cost a month. With PRO the box shows Sonnet in euros.

Diagnosing a site

From the assistant page pick a site and press Diagnose (or After the migration for a site just moved here: the check focuses on what usually breaks when a site moves, such as paths, PHP version, URLs, HTTPS and caches).

Before sending, the panel shows you what we send to the AI, section by section:

  • the site's panel settings (PHP version and limits, HTTPS, WordPress);
  • HTTP checks made from the server itself (http, https, redirects, certificate, timings);
  • the last lines of the nginx and PHP error logs and of WordPress's debug.log;
  • the site's nginx configuration and the latest failed panel operations.

From all of this, passwords, keys, tokens, cookies, email addresses and the last part of visitors' IP addresses are removed before sending. Nothing else is sent: neither the site's files nor its databases.

With KoaPanel AI the diagnosis uses Haiku. If Haiku finds nothing and Sonnet credits are left, Sonnet looks again by itself, only once, and the result says so.

In-depth analysis (Sonnet)

With KoaPanel AI, under a diagnosis made by Haiku and next to Send in the debug chat you find In-depth analysis (Sonnet): the same check with Sonnet, more accurate, which uses a Sonnet credit (with PRO, part of the €10 of the month). Every result says which model answered.

The AI for resellers and users

By default diagnosis, "Ask the AI" in the migration and the debug chat are for the administrators. With the setting Resellers and users can use the AI (it uses this server's credits) resellers and users use them too, on their sites (resellers on those of their accounts); team members use them if they have the sites section. They use the credits, or the key, of this server.

The fixes that change the whole server (such as installing a PHP extension) stay with the administrators: they are not even offered to the AI when a reseller or a user asks.

Fixes

Every finding has a severity, an explanation and the evidence found in the logs. When the remedy is a setting, you find the proposed fix with the "Now / After" table.

The possible fixes are only these, chosen because they are safe and reversible:

  • changing the site's PHP version (among the installed ones);
  • changing the site's PHP limits (memory, uploads, execution time, input vars, error display), within reasonable values;
  • turning WordPress's WP_DEBUG on or off;
  • turning a WordPress protection on or off (xmlrpc, sign-in attempt limit, PHP in uploads…).

The AI cannot run commands, edit files or touch plugins and databases: if it proposes something else, the proposal is discarded and you see it written. Nothing changes until you press Apply; before applying, the panel saves the current values and Undo puts them back.

Checking all sites and usage

Administrators can run the check of all sites (one site at a time, as a background operation) or have it every night at 4:30. Fixes always have to be applied manually. With KoaPanel AI the check sends to the AI only the sites with signs of problems (they do not answer or give 5xx errors, errors in the nginx or PHP logs of the last 24 hours, open antimalware findings, a migration check that is not green): the others are skipped without using credits. With your own key the check looks at every site.

With your own key, the This month's usage box shows the tokens used against the budget, the number of requests and an estimate of the cost at list prices; the real cost is the one on your Anthropic account.