Como carregar uma base de conhecimento a partir de um arquivo

Atualizado em

No SyBox, isso é feito em Definições > IA e automação > Agentes de IA.

  1. Abra a página do agente.
  2. Clique em "Carregar um ficheiro".
    An agent's page: the "Upload a file" button for its knowledge base
  3. Escolha um arquivo .pdf, .docx, .txt, .md, .csv ou .json, de até 10 MB. O SyBox lê diretamente o texto de arquivos PDF ou Word, então você não precisa convertê-los. Um arquivo .json contendo uma lista de entradas é importado item por item.
  4. Se a base de conhecimento já tiver registros, uma janela perguntará "Substituir a base de conhecimento?". Ela avisa que os dados atuais serão excluídos e que essa ação não pode ser desfeita. Digite o código de 6 dígitos exibido e clique em "Substituir".
  5. O painel exibe o progresso, como "Carregando… 120 de 500 (24%)" ou "A carregar… demora alguns minutos num ficheiro grande. Pode sair desta página.".
  6. Ao concluir, o painel exibe "[number] entradas carregadas".

De um PDF é lido apenas o texto. Um PDF digitalizado contém apenas imagens, portanto não há nada para ler nele: envie o documento original ou cole o texto dele. Em um arquivo do Word, o corpo do documento é lido e cada linha de uma tabela vira uma linha. Cabeçalhos, rodapés e comentários não são lidos. Arquivos .doc antigos (Word 97–2003) não são aceitos: abra no Word e salve como .docx.

Perguntas

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.

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.

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).
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.

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.

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.

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.

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.

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.

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.

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".

Mais sobre Agentes de IA.