Qual experiência você está usando?
Esta documentação cobre as duas experiências. Se Settings → Personal → My Okou estiver disponível, siga as etapas de My Okou. Se você usar uma página de Agents com New agent, siga as etapas de Legacy Agents. A disponibilidade pode variar entre membros; esta documentação não altera a sua experiência.
Em qualquer das experiências, você pode executar vários chats ou tarefas ao mesmo tempo, reutilizar fluxos de trabalho e compartilhar com sua equipe o trabalho revisado. Um subagente em tempo de execução é uma ferramenta de execução, não um perfil de produto separado que você precise criar.
Diferenças de configuração: o My Okou usa instruções pessoais (Instructions) em Settings → Personal → My Okou e fluxos de trabalho do espaço de trabalho. Qualquer etapa abaixo que peça para você escolher, criar ou autorizar um Agente nomeado se aplica apenas a Legacy Agents. No My Okou, use o seu próprio Chat e siga a solicitação de conta e permissão nomeada exibida. Fluxos de trabalho compartilhados não compartilham credenciais; as Automations usam o contexto e o acesso do proprietário.
Um chat é um fio de conversa. Cada mensagem que pede ao Okou para agir inicia uma run dentro desse fio. Responder no mesmo chat mantém disponíveis como contexto as mensagens e os artefatos anteriores do fio; abrir um novo chat inicia um contexto separado.
Por que os chats importam
- O contexto é delimitado ao fio. Uma run pode usar as mensagens e os artefatos do próprio chat. Ela não lê automaticamente o histórico de outro chat.
- As runs podem ser inspecionadas. O fio mostra as mensagens, a atividade das ferramentas, os artefatos, o status e os erros produzidos pelas runs.
- O trabalho pode ser redirecionado enquanto está em execução. Você pode interromper uma run ativa ou enviar uma correção enquanto o Okou ainda está trabalhando — a nova instrução é recebida dentro da run ativa em vez de descartar o trabalho já em andamento. Mensagens consecutivas permanecem agrupadas como um único bloco no fio. Para responder a uma frase exata, selecione-a e escolha Quote para inserir esse texto na sua próxima mensagem.
Como os chats e as runs começam
- Abrir uma nova conversa no app web cria um novo fio de chat.
- Enviar outra tarefa nessa conversa inicia outra run no mesmo fio.
- Uma conversa do Slack mantém o contexto dentro do fio do Slack mapeado.
- Uma automação é executada no chat da automação associado ao seu fluxo de trabalho e ao seu proprietário. Execuções repetidas desse fluxo de trabalho reutilizam esse chat da automação.
Vários fios podem executar ao mesmo tempo. Fios de chat diferentes avançam de forma independente — inicie um estudo de mercado em um, redija um post em outro, e ambos avançam ao mesmo tempo. Quantos executam em paralelo depende do seu plano; consulte Créditos e faturamento. Quando todas as vagas de execução estiverem ocupadas, a próxima run aguardará uma vaga ficar livre.
Dentro de um fio, as runs são sequenciais. Um fio executa uma run por vez. Uma correção que você enviar enquanto uma run estiver trabalhando se junta a essa run em vez de iniciar uma segunda ao lado dela.
Onde uma run é executada
Cada run recebe sua própria máquina — uma real, com terminal, sistema de arquivos e navegador. É isso que permite ao Okou de fato executar a transformação da planilha, clonar o repositório ou renderizar a apresentação, em vez de descrever como você faria isso.
Esse ambiente é privado para a run e é encerrado quando a run termina. O código executado dentro dele nunca recebe as credenciais do seu conector — elas são injetadas na fronteira da rede — e cada solicitação feita pela run é registrada. Veja Security para entender como o isolamento é construído.
Considere a máquina temporária. Tudo o que vale a pena manter deve ir para um lugar durável: publicado como uma página, arquivado em uma ferramenta conectada ou baixado. Um caminho de arquivo na máquina da run não é algo que você possa compartilhar.
Continuar ou começar do zero
Continue no mesmo fio quando a próxima solicitação depender de mensagens, arquivos ou decisões anteriores. Abra um novo fio quando quiser um contexto independente.
Os canais são pontos de entrada para o mesmo espaço de trabalho, mas não criam um histórico global único de conversa. Um novo fio no web, Slack, Telegram ou telefone não importa automaticamente as mensagens de outro fio. Ao mover o trabalho para um novo fio, inclua o contexto ou o artefato de que ele precisa.
Inspecionando uma run
Use a atividade do fio ou o controle de log para inspecionar a run. Ele registra a sequência visível de mensagens, a atividade das ferramentas, os artefatos, as mudanças de status e os erros. Este é 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 |
|---|---|
| Queued | O espaço de trabalho não tem nenhuma vaga livre de execução, então a run ainda não começou. Aguarde uma vaga ficar livre; uma mensagem enfileirada pode ser removida antes de começar. Enviar uma correção para uma run que já está trabalhando não é enfileiramento — essa mensagem se junta à run ativa. |
| Um cartão Connect ou Authorize | A conta necessária não está conectada, ou este agente não tem uma permissão de conector exigida. Conclua o cartão e escolha apenas o acesso e a duração de que a tarefa precisa. Se a run não for retomada, tente novamente a solicitação no mesmo fio. |
| Selected model is not available | O modelo do fio não pode ser usado no momento sob a política de modelos do espaço de trabalho ou a conexão do provedor. Escolha um modelo disponível no compositor ou reconecte o provedor solicitado em Settings → Models. |
| Insufficient credits | O espaço de trabalho não pode iniciar mais trabalho de modelo com o saldo atual. Abra Billing para revisar o saldo, adicionar créditos ou mudar de plano e, então, tente novamente. |
| Um erro no upload de anexo | O arquivo não terminou de enviar, então não está disponível para a run. Tente enviar novamente o arquivo antes de mandar a mensagem outra vez. |
| Uma run está Failed | A run terminou sem um resultado. Abra o erro visível e o log de atividade, corrija o problema relatado de conector, permissão, modelo, entrada ou serviço e, então, tente novamente. |
Ao pedir ajuda ao suporte, compartilhe a URL do chat e o erro visível da run que falhou. Nunca cole segredos de conector ou chaves do provedor no chat.
O que vem a seguir
- Veja Permissões para saber o que é aplicado na fronteira do chat.
- Veja Créditos e faturamento para entender como o custo do chat é calculado.
- Veja Automações para o modelo de chat recorrente e orientado por eventos.
