How do I upload a replacement dictionary in SyBox?

Updated

In SyBox, this is done in Settings > AI and automation > AI Agents. 1) Open the agent's page (Settings > AI Agents, then click the agent). 2) Under "Replacement dictionary", click "Upload a dictionary (JSON)" and choose the file (up to 2 MB). 3) The count shows how many words the dictionary has.

How to upload a replacement dictionary

  1. Open the agent's page (Settings > AI Agents, then click the agent).
  2. Under "Replacement dictionary", click "Upload a dictionary (JSON)" and choose the file (up to 2 MB).
  3. The count shows how many words the dictionary has.

The file must be JSON in this exact shape, or it is not accepted: {"format": "sybox-words/1", "words": {"SKU-1042": {"en": "Oak dining table", "ar": "طاولة طعام من خشب البلوط"}}}. Each key is what you write between ⟦ ⟧. Each name is one line, written for any of SyBox's languages (en, ar, fr, es, pt, de, it, tr, ru, id, ms).

- "The file is larger than 2 MB." means the file is too big.

- "The dictionary was not accepted: …" names the first thing wrong in the file. Nothing from that file is used.

- A name with no entry in the customer's language is shown in English. A ⟦…⟧ that is not in the dictionary is shown without its brackets.

Questions

Which AI providers can I use?

The "Type" list under "New AI agent" shows them: Gemini, ChatGPT, Claude and DeepSeek. You need your own API key from the provider.

Who pays for the AI usage?

You do, directly to your provider, through your own key. SyBox shows the tokens used on each agent's card and in its Usage table, but does not show prices.

I created an agent but it doesn't reply to customers. Why?

An agent only answers through an automation. Go to Settings > AI and automation > Automations and create an automation with the action "Reply with AI" that uses your agent. Make sure the automation's State is "On" and the "Automations are running" switch at the top is on. Also check that:

  • the conversation has not had "Stop AI replies" chosen
  • the conversation is not blocked, marked as spam or archived (a temporary archive does not stop it)
  • nobody from your team has already replied in it (the agent stays quiet until the conversation is marked Done, until the "Answer again after" hours pass, or until someone clicks "Hand to AI" in the bar under the conversation's name).
Can the agent promise a customer a call back, a discount or a delivery date?

Not on its own. An agent does not promise anything on your team's behalf unless your instructions for it say it may.

I get "[Provider] refused the key: …"

The provider did not accept the key. Check that you copied the whole key, that it is active, and that billing or quota is set up on your provider account. Then try again.

I get "This [provider] key offers none of the models this agent can use."

Your key has no access to the models SyBox supports. Check your provider account's plan and permissions, or use another key.

The card shows "Last error". What should I do?

That is the provider's last refusal, for example an expired key or a used-up quota. Fix it on your provider account, or click Edit and paste a new key.

Can I have different agents for different numbers or channels?

Yes. Create one agent per purpose. Then create one automation per agent, each with a "Channel" condition that picks the right numbers or pages.

Will uploading a new file add to what is already there?

No. Uploading or pasting replaces the agent's whole knowledge base. Put all of that agent's material into one upload.

The agent replied to something it shouldn't have, or answered wrongly. How do I correct it?

Add or fix the information in the knowledge base, or add a rule in "Your instructions". Then use "Try a question" to check the new answer.

Can the agent assign conversations or add labels?

Yes, through your instructions. Use the numbers listed under "Your instructions", for example "assign it to user 3" or "add label 1".

More about AI Agents.