Thread e mensagens

Camada funcional

A conversa é a unidade de trabalho: guarda o histórico, hospeda as execuções e pode ser renomeada, fixada, arquivada e marcada como lida. Cada conversa pertence a um agente e a uma organização.

O que uma conversa carrega

Título, agente dono, pessoa que criou, organização, canal de origem, se está fixada ou arquivada, o estado de execução, a visibilidade, quando foi criada, quando recebeu a última mensagem e — quando houver — o modelo escolhido só para ela. No detalhe, ainda aparece se há uma execução em andamento e se um cancelamento foi pedido.

Com qual agente uma conversa nova nasce (26/09/2026). Ao abrir "Nova conversa" (diálogo, palco do workspace ou a página inicial), o seletor já vem marcado no último agente com quem você conversou por ali — o navegador é quem lembra, não o servidor: um servidor lembraria de qualquer canal (inclusive API e gatilho), e para quem integra por fora o agente pareceria sempre o mesmo. Sem essa lembrança (primeiro uso, ou o agente lembrado não existe mais na lista), cai no Oráculo da organização; sem Oráculo, no primeiro da lista.

Estado de execução

Decisão de design: uma conversa livre não vira "concluída" como acontece na leitura de uma execução isolada — porque a conversa não é a execução; ela sobrevive a várias.

Visibilidade

Cinco níveis, do mais fechado ao mais aberto:

O agente tem uma visibilidade padrão na configuração, que define com que nível as conversas novas nascem. Os dois níveis de link são o mecanismo de compartilhamento externo por link.

Canal de origem

A conversa registra por onde nasceu: painel, delegação de outro agente, ou um dos canais externos.

Título

A conversa nasce com um título "de máquina", e pode ganhar um de verdade em duas etapas:

1. Na hora, a conversa recebe como nome a sua primeira mensagem, cortada em 60 caracteres, com reticências quando passa disso. Começando pela home, o corte que aparece é ainda mais curto, de 40 caracteres, porque a lista já mostra o texto antes mesmo de a conversa existir.
2. Pouco depois, na conversa pela tela, o nome melhora sozinho: terminado o seu primeiro turno, um modelo escreve um título de três a seis palavras, no idioma em que você falou. Isso acontece em segundo plano — a resposta do agente não espera por ele —, e o título novo aparece na tela quando fica pronto, sem recarregar (25/09/2026). Mensagem que a plataforma manda sozinha (agendamento, retomada, aviso de CI ou de aplicação) não conta como o seu primeiro turno.

Um nome que você deu nunca é sobrescrito. O título automático só toma o lugar de um nome que a própria plataforma pôs: o vazio, o "Nova conversa", ou exatamente um dos dois cortes do item 1. Tem de ser idêntico, e não apenas parecido — se você batizou a conversa com um nome que por acaso começa igual à sua primeira mensagem, ele fica. E se você renomear enquanto o título automático ainda está sendo escrito, o seu vence: a plataforma confere o nome atual antes de gravar.

Quando não dá certo, nada se perde de vista: o nome automático demorar, falhar ou vir vazio deixa simplesmente o corte da primeira mensagem, que já é legível. Mensagem barrada por política de conteúdo não ganha título, porque o turno para antes disso. E se você só disse "oi", ou não deu assunto nenhum, o título fica neutro — "Conversa inicial", no idioma em que você falou — em vez de inventar um assunto que não existe.

Isso não muda quem manda: renomear continua manual e sempre vale por cima do que o modelo geraria.

Paginação do histórico

O histórico é paginado em ordem cronológica, com limite padrão de 100 mensagens por página — a mesma lógica serve a interface e a superfície de gestão, então o que se lê pela API é o que se vê na tela.

O que dá para fazer

Limites conhecidos

• Renomear ou fixar uma conversa podia só aparecer na tela depois de recarregar — falha de atualização da interface, não do dado em si.
• Uma mensagem grande (a partir de ~2KB) podia sumir da tela momentaneamente depois de concluída, e um recarregamento a trazia de volta — o dado salvo sempre esteve correto. A causa estava na atualização em tempo real: a notificação de que o turno terminou às vezes chegava sem o texto completo da mensagem, e a interface tratava essa ausência como se o texto tivesse sumido. Corrigido em 12/08/2026: a atualização em tempo real passa a mesclar sobre a mensagem já conhecida em vez de substituir por um valor incompleto.
• A conversa é serial por construção: uma execução por vez. Enviar uma mensagem durante uma execução ativa é recusado por padrão; enfileirar é uma escolha explícita de quem envia.
• Mensagem que chegou enquanto você estava fora deixou de sumir (04/09/2026). A conversa se atualiza sozinha, mas o que acontecia enquanto a sua janela estava desconectada — você trocou de conversa e voltou, ou saiu e voltou ao navegador no celular — simplesmente não aparecia, e só recarregando a página é que voltava. Agora, toda vez que a conexão se restabelece, a conversa se compara com o que de fato existe e completa o que faltou. Isso cobre inclusive o caso mais traiçoeiro: o agente terminou o trabalho enquanto você estava fora, e portanto não há nenhuma mensagem nova chegando para avisar que algo mudou.