Symptoms and causes
- The button does not appear at all. The backend group lacks the right “Enable Chat Interface”, or the caches were not cleared after installation. Check both, see Permissions.
- The input area stays locked and reports a missing API key. No
aiSuiteApiKeyis stored in the AI Suite. Without it the chat does not start a turn. - The model selection is empty. The group lacks the model permissions, or GDPR mode leaves no suitable model.
- ChEddi claims it has no tools available. Start a new conversation, that resolves it in most cases.
- The turn aborts with a note about a call limit. The request was too large or too vague. Split it into smaller steps, see Confirming.
- Credits used up. The input area locks until the allowance is topped up.
- An attachment is rejected or not read. Images are not supported yet. For documents, the answer to the upload names the reason, for instance too large or a format that cannot be read in this installation. See Attachments.
- Web research is unavailable. The chat states the reason at the top: a missing group right, an EU search provider that does not serve your language, or a missing key on a plan with your own provider keys.
- Conversations have disappeared. They are deleted automatically after the configured period without activity, 20 days by default.
If none of this fits
ChEddi is beta. If you hit something that is not listed here, a look at var/log/cheddi_warnings.log helps. For the verbose trace, chatLogVerbose can be switched on temporarily, see Operation.