Workflows

Um workflow é um procedimento nomeado e reutilizável salvo em um agente. Ele ensina ao Okou como o seu time faz um tipo específico de trabalho, para que a próxima pessoa que precisar não tenha que reescrever o prompt.

Na primeira vez que você pede algo ao Okou, você escreve um prompt. Na segunda, cola o mesmo prompt com pequenos ajustes. Na terceira, já está copiando um prompt enorme de um documento do Notion que alguém chamou de "biblioteca de prompts do time". É aí que se salva um workflow.

O problema que os workflows resolvem

Um chat avulso serve para uma tarefa avulsa. Mas quase todo time tem uma fila de trabalho que se repete — entradas diferentes, mesmo formato:

Um cliente escreve → consultar o histórico dele → rascunhar uma resposta no idioma dele → registrar o ticket
Aparece um relato de bug → extrair os passos de reprodução → classificar a severidade → abrir uma issue estruturada
Segunda de manhã → puxar os números da semana passada → comparar com a anterior → publicar um resumo

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

Um workflow sozinho não tem agendamento nem gatilho — ele é o procedimento. Para que rode sozinho, anexe uma automação.

O que tem dentro de um workflow

Campo	O que faz
Nome	Um slug de 2 a 64 caracteres em minúsculas, com letras, números e hifens internos — `triage-bug-report`. Use `/triage-bug-report` para invocá-lo explicitamente no chat do agente dono.
Nome de exibição	O rótulo legível mostrado no espaço de trabalho.
Descrição	Uma linha dizendo ao Okou quando este workflow se aplica. O Okou compara os pedidos que chegam com as descrições, então a redação importa.
Instrução	O procedimento em si. Texto comum já basta — cite as ferramentas a usar, o formato da saída e as restrições.
Arquivos	Arquivos complementares opcionais — modelos, checklists, guias de marca, dados de referência — empacotados com o workflow.
Visibilidade	`private` (só você) ou `public` (todo mundo no espaço de trabalho).

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

Uma boa descrição é a diferença entre um workflow que dispara quando deveria e um que nunca dispara: "triar um relato de bug voltado ao cliente e abrir no GitHub com a severidade" é melhor que "mexer com bugs".

Workflows pertencem a agentes

Todo workflow pertence a exatamente um agente. É isso que torna o comportamento previsível: o workflow roda com o tom, os padrões e as concessões de conector daquele agente.

Workflow privado — visível só para você. Serve para automações pessoais ligadas a um Gmail ou a um assento de CRM pessoal.
Workflow público — visível para todo o espaço de trabalho, em um agente que seu time alcança.

O mesmo procedimento pode morar em dois agentes e produzir resultados diferentes, porque cada agente traz a própria voz e as próprias permissões. Para passar um workflow a outro agente, copie-o — isso o bifurca, e a partir daí os dois podem divergir.

Veja Agents para como a posse pelo agente molda o que um workflow pode tocar.

Criando um workflow

Começar pela página Workflows

Abra Workflows e escolha New workflow.
Selecione o agente que deve ser dono do workflow.
O Okou abre um chat com um prompt guiado de criação. 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 de o Okou criar.

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

O que colocar na instrução

Parte	Inclua
Objetivo	O resultado que o workflow precisa produzir.
Entradas	O que quem chama ou a automação fornece, e quais entradas são obrigatórias.
Procedimento	Passos em ordem, incluindo quais serviços conectados ler ou atualizar.
Saída	O formato exigido, o destino e as regras de nomenclatura.
Limites	Ações a evitar, casos que pedem esclarecimento e quando parar.
Referências	Modelos, checklists ou exemplos opcionais anexados como arquivos do workflow.

Mantenha credenciais fora da instrução e dos arquivos. Conecte o serviço por Connectors e conceda ao agente dono apenas as permissões de que o workflow precisa.

Teste antes de automatizar

Rode o workflow manualmente com uma entrada representativa.
Confirme que o agente dono alcança todo conector e permissão necessários.
Inspecione o chat resultante em busca de contexto faltando, escritas inesperadas e o formato da saída final.
Edite as Instructions ou os arquivos anexos e rode de novo até o resultado ser repetível.
Só adicione uma automação depois que a execução manual estiver correta. Comece com filtros de evento estreitos ou um agendamento pouco frequente, e inspecione os primeiros disparos.

A verificação manual separa problemas de workflow de problemas de gatilho: se Run now falha, corrija primeiro o workflow ou o acesso dele; se Run now funciona mas o evento nunca dispara, inspecione a configuração da automação.

Como o Okou escolhe um workflow

Você não precisa invocar um workflow pelo nome. O Okou carrega um automaticamente quando um pedido que chega bate com a descrição dele. Um workflow chamado customer-reply-draft, descrito como "rascunhar uma resposta a um e-mail de cliente usando nossa voz e nossa documentação", dispara quando você encaminha um e-mail de cliente — sem citar o nome.

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

Workflows que já vêm prontos

Todo agente do Okou vem com um conjunto de workflows multifuncionais mantidos pelo Okou — pesquisa e análise, finanças e contabilidade, jurídico e compliance, produto, marketing, suporte ao cliente e comunicação de time. São procedimentos de domínio, não encanamento 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; reunir fatos e então explorar opções
prd-writing — requisitos de produto com enquadramento estruturado do problema e critérios de aceite
copywriting — textos de marketing em vários canais (blogs, e-mails, redes, landing pages)
competitor-matrix — matrizes comparativas de recursos, desmontagens de posicionamento, análise de ganhos/perdas
customer-reply — respostas empáticas e alinhadas à marca, ajustadas ao canal e à urgência
nda-screening — classificar NDAs recebidos como GREEN / YELLOW / RED e encaminhá-los
status-updates — relatórios de progresso e atualizações a stakeholders para qualquer público

Seus próprios workflows ficam ao lado desses e têm precedência quando as descrições encaixam melhor.

Quando criar um

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

Sinais concretos:

O trabalho tem um nome que seu time já usa ("resumo da manhã", "varredura de concorrentes")
O prompt cita ferramentas, canais ou modelos específicos que não deveriam mudar a cada execução
A saída tem formato fixo (um resumo, um rascunho, uma issue aberta)
Mais de uma pessoa precisa acioná-lo
Você quer que rode em um horário ou diante de um evento — veja Automations

Padrões comuns

A porta de entrada. Recebe uma entrada (um e-mail, um relato de bug, uma thread) e produz um artefato estruturado (uma issue, um rascunho, uma linha).
O informe de cadência. Um workflow emparelhado com uma automação agendada que roda diária ou semanalmente e publica em algum lugar visível.
O ajudante no meio da conversa. Acionado por @Okou em um canal para uma subtarefa focada — consultar, resumir, classificar.
O compositor. Produz em uma execução um pacote multiformato — rascunho de blog mais posts sociais mais cards.
O respondedor de eventos. Emparelhado com uma automação de evento: um e-mail novo, um PR mesclado ou uma página nova no Notion inicia a execução. Veja Automations.

Armadilhas a evitar

Estreito demais. Um workflow que só serve para uma entrada bem específica é frágil. Mire no formato do trabalho, não nos detalhes de um exemplo.
Vago demais. "Ajudar com marketing" é tão amplo que o Okou não saberá quando aplicar. Seja específico na descrição.
Credenciais fixas no texto. Nunca cole chaves de API em uma instrução. Use conectores personalizados — a credencial fica na plataforma, fora do alcance do modelo.
Formato de saída escondido. Diga como o artefato deve ser: "uma lista numerada de três itens" ou "um rascunho de resposta com menos de 150 palavras".
Esquecer o agente. Um workflow só consegue usar os conectores para os quais o agente hospedeiro está autorizado. Se um workflow não alcança o Gmail, olhe a aba Authorization do agente, não a instrução.

O que vem a seguir

Anexe um gatilho com Automations para um workflow rodar sem você.
Veja Agents para quem executa um workflow e com quais permissões.
Veja Permissions para restringir o que um workflow pode tocar.
Veja Example workflows para cinco escritos de ponta a ponta.