Voltar para a documentaçãoConceitos principais

Chat

Como funciona uma única execução do Okou: isolamento, rastreabilidade, acompanhamentos.

Última atualização em 21 de agosto de 2026 · 5 min read

Um chat é um thread de conversa. Cada mensagem que pede ao Okou para agir inicia uma execução dentro desse thread. Responder no mesmo chat mantém as mensagens e os artefatos anteriores do thread disponíveis como contexto; abrir um novo chat inicia um contexto separado.

Um chat em andamento, mostrando o agente trabalhando em uma solicitação em tempo real

Por que os chats importam

  • O contexto é limitado ao thread. Uma execução pode usar as mensagens e os artefatos do seu próprio chat. Ela não lê automaticamente o histórico de outro chat.
  • As execuções são inspecionáveis. O thread mostra as mensagens, a atividade das ferramentas, os artefatos, o status e os erros produzidos pelas suas execuções.
  • O trabalho pode ser redirecionado enquanto roda. Você pode parar uma execução ativa, ou enviar uma correção enquanto o Okou ainda está trabalhando: a nova instrução é aproveitada dentro da execução ativa em vez de descartar o que já foi feito. Mensagens consecutivas ficam agrupadas como um único bloco no thread. Para responder a uma frase exata, selecione-a e escolha Citar para levar esse texto para a sua próxima mensagem.

Como chats e execuções começam

  • Abrir uma nova conversa no app web cria um novo thread de chat.
  • Enviar outra tarefa nessa conversa inicia outra execução no mesmo thread.
  • Uma conversa do Slack mantém o contexto dentro do seu thread do Slack associado.
  • Uma automação é executada no chat de automação associado ao seu fluxo de trabalho e proprietário. Disparos repetidos daquele fluxo de trabalho reutilizam aquele chat de automação.

Vários threads podem rodar ao mesmo tempo. Threads de chat diferentes avançam de forma independente: dispare um estudo de mercado num, rascunhe um post noutro, e os dois andam ao mesmo tempo. Quantos rodam em paralelo depende do seu plano; veja Créditos e faturamento. Quando todos os slots de execução estão ocupados, a próxima execução espera até um ficar livre.

Dentro de um mesmo thread, as execuções são sequenciais. Um thread faz uma execução por vez. Uma correção que você envia enquanto uma execução está trabalhando se junta a ela, em vez de abrir uma segunda ao lado.

Onde uma execução acontece

Cada execução ganha uma máquina só dela — uma máquina real, com terminal, sistema de arquivos e navegador. É isso que permite ao Okou de fato rodar a transformação da planilha, clonar o repositório ou renderizar o vídeo, em vez de descrever como você faria.

Esse ambiente é privado daquela execução e é desmontado quando ela termina. O código que roda ali dentro nunca recebe as suas credenciais de conector — elas são injetadas na fronteira de rede — e toda requisição feita pela execução fica registrada. Veja Segurança para como o isolamento é construído.

Trate a máquina como temporária. O que valer a pena guardar deve terminar em algum lugar durável: publicado como página, arquivado numa ferramenta conectada, ou baixado. Um caminho de arquivo na máquina da execução não é algo que você consiga compartilhar.

Continuar ou começar do zero

Continue no mesmo thread quando a próxima solicitação depender de mensagens, arquivos ou decisões anteriores. Abra um novo thread quando quiser um contexto independente.

Canais são pontos de entrada para o mesmo espaço de trabalho, mas não criam um histórico de conversa global único. Um novo thread web, do Slack, do Telegram ou do telefone não importa automaticamente as mensagens de outro thread. Ao mover trabalho para um novo thread, inclua o contexto ou artefato de que ele precisa.

Inspecionar uma execução

Use o controle de atividade ou log do thread para inspecionar a execução. Ele registra a sequência visível de mensagens, atividade das ferramentas, artefatos, mudanças de status e erros. É o primeiro lugar a verificar quando um resultado está incompleto ou uma ação de conector não aconteceu.

Solução de problemas

O que você vêO que verificar ou fazer
QueuedO espaço de trabalho não tem um slot de execução livre, então a execução ainda não começou. Aguarde um slot ficar livre; uma mensagem na fila pode ser removida antes de começar. Enviar uma correção para uma execução que já está trabalhando não é entrar na fila: essa mensagem se junta à execução ativa.
Um cartão Connect ou AuthorizeA conta necessária não está conectada, ou este agente não tem uma permissão de conector necessária. Complete o cartão e escolha apenas o acesso e a duração de que a tarefa precisa. Se a execução não retomar, tente a solicitação novamente no mesmo thread.
Selected model is not availableO modelo do thread não está utilizável no momento pela política de modelos do espaço de trabalho ou pela conexão do provedor. Escolha um modelo disponível no composer ou reconecte o provedor solicitado em Settings → Models.
Insufficient creditsO espaço de trabalho não pode iniciar mais trabalho de modelo com o saldo atual. Abra Billing para revisar o saldo, recarregar ou mudar de plano e tente novamente.
Um erro de upload de anexoO arquivo não terminou de carregar, então não está disponível para a execução. Tente o upload novamente antes de reenviar a mensagem.
Uma execução está FailedA execução terminou sem resultado. Abra o erro visível e o log de atividade, corrija o problema de conector, permissão, modelo, entrada ou serviço relatado e tente novamente.

Ao pedir ajuda ao suporte, compartilhe a URL do chat e o erro visível da execução com falha. Nunca cole segredos de conector nem chaves de provedor no chat.

Próximo

  • Veja Permissions para o que é aplicado na fronteira do chat.
  • Veja Credits & billing para como o custo do chat é calculado.
  • Veja Automations para o modelo de chat recorrente e orientado a eventos.