# Como carregar um dicionário de substituição

No SyBox, isso é feito em Definições > IA e automação > Agentes de IA. 1) Abra a página do agente (Definições > Agentes de IA e clique no agente). 2) Em "Dicionário de substituição", clique em "Carregar um dicionário (JSON)" e selecione o arquivo (até 2 MB). 3) O contador exibirá quantos termos existem no dicionário.

## Como carregar um dicionário de substituição

1. Abra a página do agente (Definições > Agentes de IA e clique no agente).
2. Em "Dicionário de substituição", clique em "Carregar um dicionário (JSON)" e selecione o arquivo (até 2 MB).
   ![An agent's page: "Replacement dictionary" with the file's format, how many words it has, and "Upload a dictionary (JSON)"](https://www.sybox.io/res/sybox/help/pt/upload-a-replacement-dictionary-2.webp?v=50192b9b)
3. O contador exibirá quantos termos existem no dicionário.

O arquivo deve ser um JSON exatamente nesta estrutura para ser aceito: {"format": "sybox-words/1", "words": {"SKU-1042": {"en": "Oak dining table", "ar": "طاولة طعام من خشب البلوط"}}}. Cada chave corresponde ao texto que você coloca entre ⟦ ⟧. Cada termo ocupa uma linha, traduzido para qualquer idioma suportado pelo SyBox (en, ar, fr, es, pt, de, it, tr, ru, id, ms).

- "O arquivo é maior que 2 MB." indica que o arquivo ultrapassou o limite.

- "O dicionário não foi aceito: …" indica o primeiro erro encontrado no arquivo. Nenhuma informação do arquivo será aproveitada.

- Nomes sem tradução no idioma do cliente serão exibidos em inglês. Termos em ⟦…⟧ que não constem no dicionário serão exibidos sem os colchetes.

## Perguntas

**Q: Quais provedores de IA posso utilizar?**

A lista "Tipo" ao cadastrar um "Novo agente de IA" traz as opções: Gemini, ChatGPT, Claude, DeepSeek e OpenRouter (uma chave para múltiplos modelos). É necessário ter sua própria chave de API emitida pelo provedor.

**Q: Quem paga pelo consumo da IA?**

Você paga diretamente ao seu provedor, através da sua chave de API. O SyBox exibe o volume de tokens consumidos no cartão do agente e na tabela de Uso, mas não apresenta valores monetários.

**Q: Criei um agente, mas ele não responde aos clientes. O que pode ser?**

Um agente só envia respostas se estiver integrado a uma automação. Vá em Definições > IA e automação > Automações e crie uma automação contendo a ação "Responder com IA" apontada para o seu agente. Verifique se o Estado da automação é "Ligada" e se a chave principal "As automações estão ativas" no topo da página está ligada. Verifique também se:
- a conversa não está marcada com "Parar respostas de IA"
- o contato não está bloqueado, marcado como spam ou arquivado (arquivamentos temporários não impedem o envio)
- ninguém da sua equipe respondeu manualmente a essa conversa (o agente silencia até que ela seja Concluída, até que passem as horas de "Voltar a responder após" ou até que alguém clique em "Passar para a IA" na barra inferior ao nome do cliente).

**Q: O agente pode combinar retorno de ligação, prometer descontos ou prazos de entrega?**

Não por iniciativa própria. O agente só promete ações em nome da sua equipe se você autorizar isso expressamente nas instruções dele.

**Q: Recebo a mensagem "[Provedor] recusou a chave: …"**

O provedor rejeitou a chave de API inserida. Confira se você copiou o código completo, se a chave continua ativa e se a sua conta no provedor possui saldo ou plano de faturamento configurado. Depois tente salvar novamente.

**Q: Aparece "Esta chave do [provedor] não oferece nenhum dos modelos suportados por este agente."**

A chave utilizada não tem permissão para acessar os modelos compatíveis com o SyBox. Revise o plano e os privilégios da sua conta no provedor ou utilize outra chave.

**Q: O cartão do agente exibe "Último erro". O que significa?**

Trata-se da última falha reportada pelo provedor, como chave expirada ou cota esgotada. Corrija a pendência diretamente no painel do provedor ou clique em Editar para atualizar a chave.

**Q: Posso ter agentes separados para números ou canais diferentes?**

Sim. Crie um agente para cada finalidade. Depois, crie uma automação para cada um deles usando a condição "Canal" para filtrar os números ou páginas desejados.

**Q: Enviar um novo arquivo adiciona o conteúdo ao que já estava salvo?**

Não. Cada envio ou colagem de texto substitui completamente a base de conhecimento do agente. Reúna todo o conteúdo daquele agente em um único arquivo ou envio.

**Q: O agente falou algo indevido ou respondeu errado. Como consertar?**

Atualize os dados na base de conhecimento ou inclua uma instrução corretiva em "Suas instruções". Em seguida, abra a aba "Chat" do agente para testar a nova resposta.

**Q: O agente consegue atribuir conversas ou marcar etiquetas?**

Sim, através de regras em suas instruções. Mencione os identificadores exibidos logo abaixo de "Suas instruções", como "atribua ao usuário 3" ou "adicione o rótulo 1".

Source: https://www.sybox.io/pt/help/upload-a-replacement-dictionary