Fluxos de trabalho

Um fluxo de trabalho é um procedimento nomeado e reutilizável salvo em um agente. Ele ensina ao Okou como 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, está copiando um prompt longo de um doc do Notion que alguém chamou de «biblioteca de prompts do time». Esse é o momento de salvar um fluxo de trabalho.

O problema que os fluxos de trabalho resolvem

Um chat pontual serve para uma tarefa pontual. Mas quase todo time tem um backlog de trabalho que se repete — entradas diferentes, mesma forma:

Um cliente escreve → veja o histórico dele → redija uma resposta no idioma dele → registre o ticket
Um relatório de bug aparece → extraia os passos de reprodução → classifique a gravidade → registre uma issue estruturada
Segunda de manhã → pegue os números da semana passada → compare com a anterior → publique um resumo

Sem fluxos de trabalho, cada um é um prompt de 200 palavras que todos precisam lembrar. Com fluxos de trabalho, cada um é um nome: triage-bug-report, weekly-metrics, customer-reply.

Um fluxo de trabalho sozinho não tem programação nem gatilho — ele é o procedimento. Para fazê-lo rodar sozinho, anexe uma Automation.

O que há em um fluxo de trabalho

Campo	O que faz
Name	Um slug minúsculo de 2 a 64 caracteres usando letras, números e hífens internos — `triage-bug-report`. Use `/triage-bug-report` para invocá-lo explicitamente no chat do agente proprietário.
Display name	O rótulo legível mostrado no espaço de trabalho.
Description	Uma linha dizendo ao Okou quando este fluxo de trabalho se aplica. O Okou compara solicitações recebidas com descrições, então a redação importa.
Instruction	O procedimento em si. Prosa simples serve — mencione as ferramentas a usar, o formato de saída e quaisquer restrições.
Files	Arquivos complementares opcionais — modelos, checklists, diretrizes de marca, dados de referência — agrupados 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 muito com o prompt de chat que funcionou na primeira vez.

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

Fluxos de trabalho pertencem a agentes

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

Fluxo de trabalho privado — visível apenas para você. Certo para automações pessoais ligadas a um Gmail ou assento de CRM pessoal.
Fluxo de trabalho público — visível para todos no espaço de trabalho, em um agente que seu time pode alcançar.

O mesmo procedimento pode viver em dois agentes e produzir resultados diferentes, porque cada agente traz sua própria voz e suas próprias permissões. Para entregar um fluxo de trabalho a outro agente, copie-o — isso o bifurca, para que os dois possam divergir depois.

Veja Agents para como a propriedade do agente molda o que um fluxo de trabalho pode tocar.

Criar um fluxo de trabalho

Começar pela página Workflows

Abra Workflows e escolha New workflow.
Selecione o agente que deve possuir o fluxo de trabalho.
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 fronteira de aprovação.
Revise o nome, a descrição, a instrução, os arquivos e a visibilidade propostos antes de o Okou criá-lo.

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

O que colocar na instrução

Parte	Incluir
Goal	O resultado que o fluxo de trabalho deve produzir.
Inputs	O que o chamador ou a automação fornece, e quais entradas são obrigatórias.
Procedure	Passos ordenados, incluindo quais serviços conectados ler ou atualizar.
Output	O formato exigido, o destino e as regras de nomeação.
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 e conceda ao agente proprietário apenas as permissões de que o fluxo de trabalho precisa.

Teste antes de automatizar

Execute o fluxo de trabalho manualmente com uma entrada representativa.
Confirme que o agente proprietário pode acessar todos os conectores e permissões necessários.
Inspecione o chat resultante em busca de contexto ausente, escritas inesperadas e o formato final da saída.
Edite as Instructions ou os arquivos anexados e execute novamente até o resultado ser repetível.
Adicione uma automação somente depois que a execução manual estiver correta. Comece com filtros de evento estreitos ou uma programação de baixa frequência e então inspecione os primeiros disparos.

A verificação manual separa problemas de fluxo de trabalho de problemas de gatilho: se Run now falhar, corrija primeiro o fluxo de trabalho ou o acesso dele; 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 «draft a reply to a customer email using our voice and docs», dispara quando você encaminha um e-mail de cliente — sem precisar de nome.

Para forçar um específico, diga: "Use the customer-reply-draft workflow on this email."

Fluxos de trabalho integrados

Todo agente Okou vem com um conjunto de fluxos de trabalho multifuncionais mantidos pela Okou — pesquisa e análise, finanças e contabilidade, jurídico e conformidade, produto, marketing, suporte ao cliente e comunicação do time. São procedimentos de domínio, não fiação de conectores: cada um ensina ao Okou a lidar com um tipo recorrente de trabalho.

Uma amostra:

deep-dive — pesquisa estruturada e design de solução; reúna fatos e então explore opções
prd-writing — requisitos de produto com enquadramento estruturado do problema e critérios de aceite
copywriting — textos de marketing entre canais (blogs, e-mails, redes, landing pages)
competitor-matrix — matrizes de comparação de recursos, análises de posicionamento, análises de vitórias/perdas
customer-reply — respostas empáticas e alinhadas à marca, adaptadas ao canal e à urgência
nda-screening — classifica NDAs recebidos como GREEN / YELLOW / RED e os encaminha
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 as 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 seu time já usa («morning brief», «competitor scan»)
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, uma issue registrada)
Mais de uma pessoa precisa acioná-lo
Você quer que ele rode por programação ou evento — veja Automations

Padrões comuns

O formulário de entrada. Pega uma entrada (um e-mail, um relatório de bug, um thread) e produz um artefato estruturado (uma issue, um rascunho, uma linha).
O briefing de cadência. Um fluxo de trabalho pareado com uma automação programada que roda diariamente ou semanalmente e publica em algum lugar visível.
O ajudante de meio de conversa. Acionado por Okou em um canal para fazer uma subtarefa focada — pesquisar, resumir, classificar.
O compositor. Produz um pacote multiformato — rascunho de blog mais posts sociais mais cartões — em uma execução.
O respondedor de eventos. Pareado 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 Automations.

Armadilhas a evitar

Estreito demais. Um fluxo de trabalho que só se encaixa em uma entrada específica é frágil. Mire na forma do trabalho, não nos detalhes de um exemplo.
Vago demais. «Help with marketing» é tão amplo que o Okou não saberá quando aplicá-lo. Seja específico na descrição.
Credenciais fixas. Nunca cole chaves de API em uma instrução. Use Custom connectors — a credencial fica na plataforma, fora do alcance do modelo.
Formato de saída enterrado. Diga como o artefato deve ser: «a numbered list of three items» ou «a draft reply under 150 words.»
Esquecer o agente. Um fluxo de trabalho só pode usar os conectores para os quais o agente anfitrião está autorizado. Se um fluxo de trabalho não alcança o Gmail, verifique a aba Authorization do agente, não a instrução.

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