Configurar um assistente inteligente
Caminho: Menu lateral → Opa! IA → Assistentes inteligentes
Visão geral
Um assistente inteligente conversa com os clientes no lugar de um atendente, com o jeito de falar e o conhecimento que você definir. Você escolhe o nome, as instruções, as ferramentas que ele pode usar (como transferir ou encerrar um atendimento) e o modelo de IA que responde. Assim, parte do atendimento passa a ser feita de forma automática, e as pessoas da equipe ficam com os casos que precisam delas.
O assistente tem quatro abas: Perfil, Instruções, Fluxo de interações e Sub assistentes. Ao lado das abas, a Pré-visualização permite conversar com ele antes de publicar.
Pré-requisitos
- Opa! IA contratado e permissão Ambiente de IA no grupo de permissões. Veja Criar e configurar um grupo de permissão.
- Para o assistente consultar sua empresa: uma base de conhecimento cadastrada. Veja Criar uma base de conhecimento.
- Para o assistente usar sistemas externos: um servidor MCP cadastrado. Veja Conectar servidores MCP.
- O menu Opa! IA não aparece no celular.
Passo a passo
Criar o assistente
- Acesse Opa! IA → Assistentes inteligentes.
- Clique em Adicionar novo. Abre a janela Adicionar assistente inteligente.
- Escolha a imagem do assistente e preencha:
- Nome: como o assistente se apresenta (ex.: "Agente de Triagem").
- Descrição: a função principal dele (ex.: "Ajudar clientes a solucionar dúvidas sobre o nosso sistema").
- Bases de conhecimento (opcional): as bases que ele consulta para responder.
- Servidores MCP (opcional): os servidores que conectam o assistente a sistemas externos.
- Salve. O Opa! Suite abre o assistente na aba Perfil.
Configurar a aba Perfil
| Campo | O que faz |
|---|---|
| Imagem, Nome, Descrição | Identificam o assistente. Os três são obrigatórios. |
| Status | Ativo ou Inativo. |
| Bases de conhecimento | Bases que o assistente consulta. Opcional. |
| Servidores MCP | Servidores externos que o assistente pode usar. Opcional. Mostra os servidores cadastrados em Opa! IA → Servidores MCP. |
| Responder áudios recebidos com áudio | Quando o cliente envia um áudio, o assistente responde com áudio. Ao ligar, escolha a Voz e use Ouvir voz para testar. Veja [[vozes |
| Modelo de inteligência | O modelo de IA que gera as respostas. Cada modelo tem velocidade, capacidade e consumo diferentes. Veja [[modelos de ia disponiveis |
| Dividir mensagens longas | Quando ligado, as respostas longas são enviadas em mais de uma mensagem. Vem ligado. |
| Tempo para coletar mensagens | Tempo de espera antes de a IA processar as mensagens, em segundos. O padrão é 10. Se o cliente enviar "Oi" e, dentro desse tempo, "Quais são os planos disponíveis", a IA analisa as duas juntas. |
| Exportar | Baixa o assistente para importar em outra instalação. |
Escrever as instruções
- Abra a aba Instruções.
- Escreva no editor como o assistente deve se comportar: tom de voz, estilo de atendimento, regras da empresa e informações que valem sempre (por exemplo, "a instalação é gratuita").
- Para ter ajuda, clique no botão de brilho, no canto inferior esquerdo do editor. Abre o painel Gerar instruções, onde a Mariana, assistente de configuração, conversa com você. Descreva o que quer a partir de "Quero que meu assistente..." e ela escreve ou ajusta as instruções. As respostas da Mariana que alteram as instruções trazem um botão para desfazer a alteração.
- Use a barra / no editor para inserir variáveis do sistema ou ferramentas. Veja Configurar as ferramentas dos assistentes.
Para escrever bem, veja Como estruturar as instruções do assistente.
A IA lê as instruções a cada resposta. Seja objetivo para não aumentar o consumo à toa. Veja Como é calculado o consumo do Opa! IA.
Montar o fluxo de interações
Na aba Fluxo de interações, você organiza em etapas o caminho da conversa, com instruções e condições. Veja Montar o fluxo de interações do assistente.
Vincular sub assistentes
Os sub assistentes são outros assistentes ativos que ajudam o principal em assuntos específicos.
- Abra a aba Sub assistentes.
- Clique em Vincular sub assistente.
- Em Sub assistentes, selecione os assistentes ativos que deseja vincular e confirme.
Para desvincular, use o menu de ações do sub assistente e confirme em Excluir sub assistente. Isso remove só o vínculo.
Testar na pré-visualização
- Clique em Pré-visualizar, no alto da tela.
- Converse com o assistente. Ele já usa a configuração que você acabou de editar, sem precisar publicar.
- Para fechar, clique em Fechar pré-visualização.
As conversas de teste geram consumo, como um atendimento real. Elas aparecem como Em testes na Performance do Opa! IA.
Publicar as alterações
- Confira o aviso ao lado das abas: Edições não publicadas significa que há mudanças que ainda não valem para os clientes; Edições publicadas, que tudo já está no ar.
- Clique em Publicar alterações. Durante a gravação, o botão mostra Publicando....
As alterações só passam a valer nos atendimentos reais depois de publicadas.
Se uma ferramenta estiver incompleta, o Opa! Suite mostra Algumas ferramentas estão com sua configuração pendente e, ao publicar, Alterações publicadas, mas ferramentas pendentes. O assistente pode falhar. Revise as seções com pendência antes de usá-lo em atendimentos.
Voltar a uma versão anterior ou duplicar
- Clique no botão de histórico (relógio com seta) ao lado de Pré-visualizar.
- Escolha uma versão da lista. Enquanto você visualiza uma versão antiga, os campos ficam bloqueados.
- Clique em Restaurar para voltar a essa versão. Aparece Versão restaurada com sucesso! Publique para salvar as alterações.
- Para criar uma cópia do assistente a partir dessa versão, clique em Duplicar. Aparece Assistente duplicado com sucesso!.
Exportar e importar
- Exportar: na aba Perfil, clique em Exportar. O arquivo leva o perfil, as instruções e o fluxo de interações.
- Importar: em Opa! IA → Assistentes inteligentes, clique em Importar assistente e escolha o arquivo.
A voz escolhida, as ferramentas e as ações do fluxo (como executar fluxo, transferências, etiquetas e sub assistentes) não vêm prontas. Reconfigure-as no assistente importado.
Resultado esperado
O assistente aparece na lista Assistentes inteligentes, com o status Ativo ou Inativo, e passa a atender nos fluxos de comunicação que o usam. Se o assistente tiver ferramentas pendentes, o card mostra a quantidade de ferramentas pendentes.
Problemas comuns
- O assistente responde diferente do que testei: você alterou o assistente depois do teste e não publicou, ou publicou antes de testar. Confira o aviso Edições não publicadas.
- A voz não aparece: ligue Responder áudios recebidos com áudio e escolha a Voz.
- Não consigo vincular um sub assistente: só aparecem assistentes ativos e que ainda não estão vinculados.
- Os campos estão bloqueados: você está vendo uma versão do histórico. Restaure a versão ou feche o histórico.
Boas práticas
- Defina uma função clara para cada assistente (triagem, financeiro, suporte) e use sub assistentes para assuntos específicos.
- Teste na Pré-visualização com perguntas reais dos seus clientes antes de publicar.
- Use o histórico para comparar versões quando uma mudança piorar as respostas.
- Escolha o modelo mais simples que resolve bem a função do assistente, para controlar o consumo.