Fluxos de trabalho

Um fluxo de trabalho é um procedimento nomeado e reutilizável. Ele ensina ao Okou como sua equipe faz um tipo específico de trabalho, para que a próxima pessoa que precisar dele não tenha que reescrever o prompt.

Na primeira vez em que você pede ao Okou para fazer algo, você escreve um prompt. Na segunda vez, você cola o mesmo prompt com pequenos ajustes. Na terceira vez, você está copiando um prompt longo de um doc do Notion que alguém chamou de "biblioteca de prompts da equipe". Esse é o momento de salvar um fluxo de trabalho.

O problema que os fluxos de trabalho resolvem

Um chat avulso serve bem para uma tarefa avulsa. Mas quase toda equipe tem uma fila de trabalho que se repete — entradas diferentes, mesma estrutura:

Um cliente escreve → consulte o histórico dele → redija uma resposta no idioma dele → registre o ticket
Surge um relatório de bug → extraia os passos para reproduzir → classifique a severidade → abra um issue estruturado
Segunda-feira de manhã → puxe os números da semana passada → compare com a semana anterior → publique um resumo

Sem fluxos de trabalho, cada um desses itens é um prompt de 200 palavras que todo mundo precisa lembrar. Com fluxos de trabalho, cada um vira um nome: triage-bug-report, weekly-metrics, customer-reply.

Um fluxo de trabalho, por si só, não tem agenda nem gatilho — ele é o procedimento. Para fazê-lo rodar sozinho, adicione uma automação.

O que há em um fluxo de trabalho

Campo	O que ele faz
Name	Um slug em minúsculas de 2–64 caracteres, usando letras, números e hífens internos — `triage-bug-report`. Use `/triage-bug-report` para invocá-lo explicitamente em um chat em que o fluxo de trabalho esteja disponível.
Display name	O rótulo legível para humanos exibido no espaço de trabalho.
Description	Uma linha dizendo ao Okou quando este fluxo de trabalho se aplica. O Okou corresponde as solicitações recebidas às descrições, então a redação importa.
Instruction	O próprio procedimento. Prosa simples funciona — mencione as ferramentas a usar, a forma da saída e quaisquer restrições.
Files	Arquivos suplementares opcionais — modelos, checklists, diretrizes da marca, dados de referência — incluídos com o fluxo de trabalho.
Visibility	`private` (só você) ou `public` (todos no espaço de trabalho).

Sem grafo de nós, sem configuração YAML, sem seção de gatilhos. A instrução geralmente se parece bastante com o prompt de chat que funcionou da primeira vez.

Uma boa descrição é a diferença entre um fluxo de trabalho que dispara quando deveria e um que nunca dispara: "triage a customer-facing bug report and file it to GitHub with severity" é melhor do que "do bug stuff."

Propriedade e visibilidade

My Okou: os fluxos de trabalho vivem no espaço de trabalho atual. Um Private Workflow pertence ao usuário atual. Um Public Workflow é compartilhado com os membros do espaço de trabalho; Public não significa publicado na internet. Cada execução usa as instruções pessoais (Instructions), a memória, as contas conectadas e as permissões do usuário que está executando. Compartilhar o procedimento não compartilha esses recursos pessoais nem os resultados privados.

Seu Private Workflow com o mesmo nome tem precedência sobre um Public Workflow. Use o Workflow ID explícito quando precisar identificar uma definição compartilhada específica. Make private copy cria uma versão separada para você adaptar; edições posteriores não são sincronizadas com o original. As Automations de outro membro não são copiadas. Criar um Private Workflow não concede permissão para publicar ou manter Public Workflows; as regras de publicação existentes do espaço de trabalho continuam valendo.

Legacy Agents: cada fluxo de trabalho pertence a um agente. Os colegas de equipe também precisam ter acesso ao agente proprietário. Copy workflow seleciona um agente de destino e cria uma bifurcação privada. O agente fornece seu perfil e instruções, enquanto a execução ainda usa o acesso autorizado à conta do membro que estiver executando.

Veja My Okou e Agents legados para instruções permanentes.

Qual experiência você está usando?

Esta documentação cobre ambas as experiências. Se Settings → Personal → My Okou estiver disponível, siga as etapas de My Okou. Se você usa 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 sua experiência.

Em qualquer uma 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.

Criando um fluxo de trabalho

Comece pela página Workflows

Abra Workflows. My Okou: escolha Create in chat. Legacy Agents: escolha New workflow onde isso aparecer.
My Okou: continue no seu próprio chat; nenhuma seleção de agente é necessária. Legacy Agents: selecione o agente que deve ser o proprietário do fluxo de trabalho.
O Okou abre um chat com um prompt guiado de criação de fluxo de trabalho. Descreva o resultado, as entradas esperadas, as ferramentas, a saída e qualquer limite de aprovação.
Revise o nome, a descrição, a instrução, os arquivos e a visibilidade propostos antes que o Okou o crie.

Você também pode começar em um chat existente e pedir ao Okou para transformar em um fluxo de trabalho uma tarefa que já funcionou. Manter a primeira execução bem-sucedida no mesmo chat dá ao Okou entradas concretas, correções e saída para capturar.

Exemplo de My Okou: as instruções do Workflow descrevem o trabalho repetível.

Instruções do Workflow no My Okou, separadas das instruções pessoais

O que colocar na instrução

Parte	Incluir
Goal	O resultado que o fluxo de trabalho deve produzir.
Inputs	O que o solicitante ou a automação fornece, e quais entradas são obrigatórias.
Procedure	Etapas em ordem, incluindo quais serviços conectados ler ou atualizar.
Output	O formato, o destino e as regras de nomenclatura exigidos.
Boundaries	Ações a evitar, casos que precisam de esclarecimento e quando parar.
References	Modelos, checklists ou exemplos opcionais anexados como arquivos do fluxo de trabalho.

Mantenha credenciais fora da instrução e dos arquivos. Conecte o serviço por meio de Connectors, depois revise a conta conectada e conceda apenas as permissões de que o Workflow precisa; em Legacy Agents, autorize também o agente proprietário.

Teste antes de automatizar

Execute o fluxo de trabalho manualmente com uma entrada representativa.
Confirme que o membro que está executando tem o acesso à conta e as permissões necessárias; em Legacy Agents, verifique também a autorização do Agent proprietário.
Inspecione o chat resultante quanto a contexto ausente, gravações inesperadas e a forma da saída final.
Edite as Instructions ou os arquivos anexos e execute novamente até o resultado ser reproduzível.
Adicione uma automação somente depois que a execução manual estiver correta. Comece com filtros de evento restritos ou um agendamento de baixa frequência e, então, inspecione os primeiros disparos.

A verificação manual separa os problemas do fluxo de trabalho dos problemas do gatilho: se Run now falhar, corrija primeiro o fluxo de trabalho ou seu acesso; se Run now tiver sucesso, mas um evento nunca disparar, inspecione a configuração da automação.

Como o Okou escolhe um fluxo de trabalho

Você não precisa invocar um fluxo de trabalho pelo nome. O Okou carrega um automaticamente quando uma solicitação recebida corresponde à descrição dele. Um fluxo de trabalho chamado customer-reply-draft, descrito como "redigir uma resposta para um e-mail de cliente usando nossa voz e nossos documentos", dispara quando você encaminha um e-mail de cliente — sem precisar do nome.

Para forçar um específico, diga isso: "Use o fluxo de trabalho customer-reply-draft neste e-mail."

Fluxos de trabalho integrados

O Okou inclui uma lista de fluxos de trabalho multifuncionais mantidos pelo Okou — pesquisa e análise, finanças e contabilidade, jurídico e conformidade, produto, marketing, suporte ao cliente e comunicação da equipe. São procedimentos de domínio, não infraestrutura de conectores: cada um ensina ao Okou como lidar com um tipo recorrente de trabalho.

Uma amostra:

deep-dive — pesquisa estruturada e desenho de solução; reúna fatos e depois explore opções
prd-writing — requisitos de produto com enquadramento estruturado do problema e critérios de aceitação
copywriting — texto de marketing em vários canais (blogs, e-mails, social, landing pages)
competitor-matrix — matrizes de comparação de recursos, desmontagens de posicionamento, análise de vitórias e derrotas
customer-reply — respostas empáticas, alinhadas à marca, adaptadas ao canal e à urgência
nda-screening — classifique NDAs recebidos como GREEN / YELLOW / RED e encaminhe-os
status-updates — relatórios de progresso e atualizações para stakeholders adaptados a qualquer público

Seus próprios fluxos de trabalho ficam ao lado desses e têm precedência quando suas descrições correspondem mais de perto.

Quando criar um

A regra honesta: se você escreveu substancialmente o mesmo prompt mais de duas vezes — ou consegue imaginar um colega escrevendo — salve-o.

Sinais concretos:

O trabalho tem um nome que sua equipe já usa ("briefing da manhã", "varredura de concorrentes")
O prompt nomeia ferramentas, canais ou modelos específicos que não deveriam mudar a cada execução
A saída tem uma forma fixa (um resumo, um rascunho, um issue aberto)
Mais de uma pessoa precisa dispará-lo
Você quer que ele rode em um agendamento ou por um evento — veja Automações

Padrões comuns

O formulário de triagem. Recebe uma entrada (um e-mail, um relatório de bug, uma thread) e produz um artefato estruturado (um issue, um rascunho, uma linha).
O briefing de cadência. Um fluxo de trabalho combinado com uma automação agendada que roda diariamente ou semanalmente e publica em algum lugar visível.
O auxiliar de meio de conversa. Disparado por @Okou em um canal para fazer uma subtarefa focada — consultar, resumir, classificar.
O compositor. Produz um pacote em vários formatos — rascunho de blog mais posts sociais mais cards — em uma única execução.
O respondedor de eventos. Combinado com uma automação de evento: um novo e-mail, um PR mesclado ou uma nova página do Notion inicia a execução. Veja Automações.

Armadilhas a evitar

Muito restrito. Um fluxo de trabalho que só se encaixa em uma entrada muito específica é frágil. Mire na estrutura do trabalho, não nos detalhes de um único exemplo.
Muito vago. "Ajude com marketing" é amplo demais, e o Okou não saberá quando aplicá-lo. Seja específico na descrição.
Credenciais codificadas. Nunca cole chaves de API em uma instrução. Use custom connectors em vez disso — a credencial fica na plataforma, fora do alcance do modelo.
Formato de saída escondido. Diga como o artefato deve ficar: "uma lista numerada de três itens" ou "uma resposta em rascunho com menos de 150 palavras."
Esquecer o acesso. Um fluxo de trabalho compartilhado não concede acesso ao conector. Verifique sua conta conectada, as permissões solicitadas e quaisquer controles de conta de Chat disponíveis para você. Em Legacy Agents, verifique também as configurações de autorização do agente proprietário.

O que vem a seguir

Anexe um gatilho com Automações para que um fluxo de trabalho rode sem você.
Veja Agents para saber quem executa um fluxo de trabalho e com quais permissões.
Veja Permissões para restringir o que um fluxo de trabalho pode acessar.
Veja Fluxos de trabalho de exemplo para cinco exemplos escritos de ponta a ponta.