Pular para o conteúdo

Interface de Chat

A interface de chat é onde usuários conversam com agentes, acompanham respostas, enviam anexos e revisitam o histórico. A mesma engine de chat aparece em três contextos com pequenas diferenças.

  • Hub (/hub/chat) — ambiente autenticado dos membros da organização. Sidebar à esquerda com busca, pastas, conversas pinadas e botão de “Nova Conversa”.
  • Chat anônimo — sem login. Pode ser uma página inteira em /a/:slug (canal público) ou um widget incorporado no site em /embed/:slug (canal widget). Sem sidebar de histórico — só a conversa atual.
  • Admin (/admin/conversations) — somente leitura por padrão, com possibilidade de Intervir em conversas externas. Veja Intervenção Humana.

Conversa aberta no admin

A área principal do chat sempre tem:

  • Header com nome do usuário, badge do canal e badge do agente. No admin, também aparecem os botões Intervir, Concluir ou Devolver/Reabrir, dependendo do estado.
  • Histórico de mensagens em ordem cronológica. Cada resposta do agente mostra abaixo o nome do agente, o modelo usado (Anthropic: Claude Haiku 4.5, Google: Gemini 3.1 Flash Lite Preview, etc.) e o timestamp.
  • Etapas do agente (“N ações realizadas”) aparecem dentro das mensagens. Clique para expandir e ver quais ferramentas foram chamadas, com que argumentos e o resultado.
  • Compositor no rodapé com botão de anexo, botão de áudio (microfone), seletor de agente e seletor de modelo. O envio é com Enter (Shift+Enter para quebrar linha) ou clicando no avião.

No Hub também aparece a sidebar à esquerda com:

  • Pesquisa de conversas;
  • Botão Nova Conversa;
  • Lista de pastas (configuráveis pelo usuário);
  • Lista de conversas, em que cada item tem um menu (compartilhar, renomear, mover para pasta, exportar, fixar, excluir).

Algumas mensagens vêm com formatação própria:

  • Transferência de agente — quando um agente chama a ferramenta transfer_to_agent, aparece o badge “Conversa transferida de X para Y” e as respostas seguintes vêm do novo agente.
  • Imagens geradas — quando o agente usa geração de imagem, a imagem é renderizada inline e pode ser ampliada (lightbox).
  • Markdown rico — listas, citações, blocos de código, tabelas e links são renderizados com formatação.
RecursoHubAnônimo (público/widget)Admin
Sidebar com históricosimnãosim (lista admin)
Botão Intervir/Concluirnãonãosim (só externas)
Compositor habilitadosimsimsó quando intervindo
Modelo de IA selecionávelsimnãonão
Compartilhar conversasimn/an/a

Recursos como anexos, geração de imagem ou áudio dependem do agente (configurado em Editar agente -> Anexos), do modelo escolhido e das ferramentas habilitadas.

  • Explique o objetivo antes de pedir a ação. Agentes adivinham mal.
  • Inclua dados relevantes na primeira mensagem. Cada nova mensagem reabre o ciclo de tokens — entregar tudo de uma vez é mais barato em créditos.
  • Envie arquivos quando ajudarem. Modelos com visão entendem prints, PDFs, planilhas.
  • Responda perguntas de esclarecimento que o agente fizer — ele só pergunta quando precisa.
  • Evite misturar muitos pedidos diferentes numa única mensagem. Quebre em conversas separadas se forem assuntos sem relação.
  • Resposta saiu errada? Expanda as etapas (“N ações realizadas”) e veja se o agente chamou a ferramenta esperada com os argumentos certos. Veja Logs de execução para o histórico completo.
  • Agente travou? No Hub, comece uma nova conversa. No admin, clique em Intervir para responder você mesmo.
  • Áudio não funciona? Veja Áudio e transcrição — em particular a seção sobre permissões do navegador.