Skip to main content
As ordens permanentes concedem ao seu agente autoridade operacional contínua para programas definidos. Em vez de instruir o agente a cada tarefa, você define programas com escopo, gatilhos e regras de escalonamento claros, e o agente executa de forma autônoma dentro desses limites: “Você é responsável pelo relatório semanal. Compile-o toda sexta-feira, envie-o e só escale se algo parecer errado.”

Por que usar ordens permanentes

Sem ordens permanentes: você instrui o agente para cada tarefa, o trabalho rotineiro é esquecido ou atrasado, e você se torna o gargalo. Com ordens permanentes: o agente executa de forma autônoma dentro de limites definidos, o trabalho rotineiro ocorre conforme o cronograma, e você só precisa se envolver em exceções e aprovações.

Como funcionam

As ordens permanentes são definidas nos arquivos do seu espaço de trabalho do agente. A abordagem recomendada é incluí-las diretamente no AGENTS.md (que é injetado automaticamente em todas as sessões), para que o agente sempre as tenha em contexto. Para configurações maiores, você também pode colocá-las em um arquivo dedicado, como standing-orders.md, e referenciá-lo no AGENTS.md. Cada programa especifica:
  1. Escopo — o que o agente está autorizado a fazer
  2. Gatilhos — quando executar (cronograma, evento ou condição)
  3. Pontos de aprovação — o que exige autorização humana antes da execução
  4. Regras de escalonamento — quando parar e pedir ajuda
O agente carrega essas instruções em todas as sessões por meio dos arquivos de inicialização do espaço de trabalho (consulte Espaço de trabalho do agente para ver a lista completa de arquivos injetados automaticamente) e as executa em conjunto com trabalhos Cron para garantir o cumprimento de horários.
Coloque as ordens permanentes no AGENTS.md para garantir que sejam carregadas em todas as sessões. A inicialização do espaço de trabalho injeta automaticamente AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, BOOTSTRAP.md e MEMORY.md, mas não arquivos arbitrários em subdiretórios.

Anatomia de uma ordem permanente

Ordens permanentes combinadas com trabalhos Cron

As ordens permanentes definem o que o agente está autorizado a fazer. Os trabalhos Cron definem quando isso acontece. Eles funcionam em conjunto:
A instrução do trabalho Cron deve fazer referência à ordem permanente em vez de duplicá-la:

Exemplos

Exemplo 1: conteúdo e redes sociais (ciclo semanal)

Exemplo 2: operações financeiras (acionadas por evento)

Exemplo 3: monitoramento e alertas (contínuo)

Padrão executar-verificar-relatar

As ordens permanentes funcionam melhor quando combinadas com uma disciplina rigorosa de execução. Toda tarefa de uma ordem permanente deve seguir este ciclo:
  1. Executar — faça o trabalho de fato (não apenas confirme que recebeu a instrução)
  2. Verificar — confirme que o resultado está correto (o arquivo existe, a mensagem foi entregue, os dados foram analisados)
  3. Relatar — informe ao responsável o que foi feito e o que foi verificado
Esse padrão evita o modo de falha mais comum dos agentes: confirmar uma tarefa sem concluí-la.

Arquitetura com vários programas

Para agentes que gerenciam várias áreas, organize as ordens permanentes como programas separados, com limites claros:
Cada programa deve ter:
  • Sua própria cadência de acionamento (semanal, mensal, orientada por eventos ou contínua)
  • Seus próprios pontos de aprovação (alguns programas precisam de mais supervisão do que outros)
  • Limites claros (o agente deve saber onde um programa termina e outro começa)

Práticas recomendadas

Faça

  • Comece com autoridade restrita e amplie-a à medida que a confiança aumentar
  • Defina pontos de aprovação explícitos para ações de alto risco
  • Inclua seções “O que NÃO fazer” — os limites são tão importantes quanto as permissões
  • Combine com trabalhos Cron para uma execução confiável baseada em horários
  • Revise semanalmente os registros do agente para verificar se as ordens permanentes estão sendo seguidas
  • Atualize as ordens permanentes à medida que suas necessidades evoluírem — elas são documentos vivos

Evite

  • Conceder autoridade ampla logo no primeiro dia (“faça o que você achar melhor”)
  • Omitir regras de escalonamento — todo programa precisa de uma cláusula que defina “quando parar e perguntar”
  • Presumir que o agente lembrará de instruções verbais — coloque tudo no arquivo
  • Misturar áreas em um único programa — use programas separados para áreas distintas
  • Esquecer de aplicar os gatilhos com trabalhos Cron — ordens permanentes sem gatilhos se tornam apenas sugestões

Conteúdo relacionado

  • Automação: visão geral de todos os mecanismos de automação.
  • Trabalhos Cron: aplicação de cronogramas para ordens permanentes.
  • Hooks: scripts orientados por eventos do ciclo de vida do agente.
  • Webhooks: gatilhos de eventos HTTP recebidos.
  • Espaço de trabalho do agente: onde ficam as ordens permanentes, incluindo a lista completa de arquivos de inicialização injetados automaticamente (AGENTS.md, SOUL.md etc.).