A v2.2 da Hora ganhou o teste e foi promovida. Uma semana depois, a logística mudou o dia de entrega de uma rota e a tabela do agente ficou velha. As conversas assumidas pela Juliana seguiram baixas, mas as promessas de prazo não cumpridas passaram do limite. Promover e reverter são etapas planejadas: nesta aula você escreve as duas antes de precisar delas.
1O que acompanha uma promoção: fases, vigia e gatilho de volta
2Calcular o gatilho para não reverter por acaso
3Reverter rápido, avisando antes e guardando a versão
4O histórico de versões e a alçada do próprio ciclo
Objetivo: tratar promoção e reversão como etapas planejadas: promover com gatilho de volta escrito e reverter pelo gatilho, sem caça ao culpado.
01 · Da promoção à próxima candidata
Promover não é o fim do ciclo. Clique em cada etapa.
Mantida ou revertida, a lição vai para o histórico e alimenta a próxima hipótese
Clique em cada bloco do diagrama para ver o que ele faz.
Área Gestão de IA, regra 3: promover e reverter são etapas, não acidentes. Números da Horizonte: fictícios de estudo, em semanas relativas.
02 · Quatro regras para promover e voltar
O G2 versionou o processo e o G3 promoveu ações de autonomia. Aqui a versão é a do pacote do agente (prompt, contexto, modelo, ferramentas) que saiu de um ciclo LOOP-R.
1. A promoção leva o plano de volta
O Carlos aprovou a v2.2 na semana 7 com o plano de volta já escrito: janela de vigia de duas semanas; gatilho de promessas de prazo não cumpridas acima de 3,4% numa semana, ou um erro crítico; quem decide, a Patrícia; como voltar, o Rafael aponta a Hora para a v2.1 em até 2 horas.
Decidir a volta depois do problema é decidir no susto, e quase sempre vira discussão sobre culpa.
RegraPromover pede aprovação de quem não propôs. Reverter pelo gatilho escrito é dever de quem opera e não espera reunião.
2. O gatilho considera o acaso
Promessas não cumpridas são evento raro: em 160 conversas de prazo por semana, a taxa varia sozinha. O gatilho soma à taxa do piloto (1,5%) dois erros-padrão da semana: 2 × √(0,015 × 0,985 ÷ 160) ≈ 1,9 ponto. Limite: 3,4%.
Assim, uma semana com 4 promessas não cumpridas (2,5%) não reverte; uma com 7 (4,4%) reverte. A conta é a mesma que o LOOP-R usa para a tolerância.
ContraexemploNo exemplo do LOOP-R, 6 reclamações contra 1, em 300 por versão, com tolerância zero, descartou uma boa ideia por acaso.
3. Reverter rápido, sem culpado
Na semana 8, a logística mudou o dia de entrega da rota de Sorocaba e a tabela não foi atualizada. Promessas não cumpridas: 7 de 158 (4,4%), acima de 3,4%. As conversas assumidas pela Juliana seguiam em 19,0%: a meta ia bem, o guarda-corpo caiu.
A Patrícia decidiu pelo gatilho; a Juliana foi avisada antes; o Rafael apontou para a v2.1 em 2 horas; a v2.2 ficou guardada. O Carlos foi informado com o número.
Causa, não culpadoA tabela não tinha validade nem aviso de mudança de rota. O conserto é no documento (dono, validade, aviso), não no Valdir.
4. Histórico e alçada do ciclo
Cada versão ganha uma linha no histórico: o que mudou, por quê, quem aprovou, a situação. A versão revertida não é apagada; vira memória do que não funcionou e por quê.
O próprio ciclo tem alçada. No LOOP-R, L0 só propõe; L1 promove com aprovação de uma pessoa a cada mudança; L2 promove sozinho, e só depois de pelo menos cinco promoções em L1 sem nenhuma reversão. A Horizonte está em L1.
Próximo passov2.3: a mesma tabela, com o Valdir como dono, validade semanal e aviso de mudança de rota. Volta aos 30 casos e a um piloto novo.
03 · Modelos para copiar
O registro de promoção, o de reversão e o histórico de versões. A aba ao lado mostra os da Horizonte.
Registro de promoção
PROMOÇÃO · agente <nome> · de v<atual> para v<candidata> · ciclo LOOP-R nº <...>
Proposta por: <nome> · Aprovada por (não quem propôs): <nome> em <data>
Cartão de decisão anexo: [ ] sim
FASES: <recorte primeiro, depois todos, ou todos de uma vez, e por quê>
JANELA DE VIGIA: <n semanas> · guarda-corpos olhados <com que frequência>, por <nome>
GATILHO DE REVERSÃO (escrito agora)
<guarda-corpo> acima de <limite> em <período>
conta do limite: <taxa do piloto> + 2 × raiz(p × (1 - p) ÷ <N do período>) = <...>
ou: 1 erro crítico
QUEM DECIDE A VOLTA: <nome> · sem esperar aprovação
COMO VOLTAR: <passos, quem faz cada um, em quanto tempo>
QUEM É AVISADO ANTES: <nomes> · VERSÃO ANTERIOR GUARDADA EM: <onde>
Registro de reversão
REVERSÃO · agente <nome> · de v<promovida> para v<anterior> · <data e hora>
Gatilho que disparou: <indicador> = <valor> (<n> de <N>) · limite escrito: <...>
Meta da mudança na mesma semana: <valor> (para o registro, não para decidir)
Decidido por: <nome> · avisados antes: <nomes> · executado por: <nome> em <tempo>
Versão revertida guardada em: <onde>
CAUSA PROVÁVEL: <o que mudou no mundo ou no agente>
CONSERTO PROPOSTO: <...> · nova candidata: v<...> · volta aos 30 casos e ao piloto: <datas>
APRENDIZADO PARA O HISTÓRICO: <uma frase>
Histórico de versões do agente
HISTÓRICO · agente <nome> · dono: <nome> · alçada do ciclo: [ ] L0 propõe [ ] L1 pessoa aprova cada mudança [ ] L2 promove sozinho
| Versão | O que mudou | Por quê (evidência) | Aprovado por | Situação | Data |
|---|---|---|---|---|---|
| <v> | <...> | <...> | <nome> | em uso / guardada / revertida / proposta | <...> |
Regra: nenhuma linha é apagada. Versão revertida fica com o motivo.
L2 só depois de 5 promoções em L1 sem reversão.
Prompt · revisar o plano de volta
Você é revisor de mudanças. Abaixo está o registro de promoção de uma
nova versão de um agente de IA. Não decida se a promoção é boa. Aponte:
1. Se o gatilho de reversão tem número, período e a conta do limite.
2. Se o limite é tão apertado que a variação normal o dispara, ou tão
largo que nunca dispara.
3. Se quem decide a volta, os passos e o tempo estão escritos.
4. Quem seria afetado pela volta e não está na lista de avisados.
Registro:
"""<cole>"""
Simulação: exemplo ilustrativo
Hora v2.1 → v2.2 → v2.1 · Horizonte, empresa fictícia de estudo · semanas relativas
Semana 7, promoção: proposta da Patrícia, aprovada pelo Carlos com o cartão do ciclo 0001. Todas as conversas na v2.2. Vigia de 2 semanas.
Gatilho: promessas de prazo não cumpridas acima de 3,4% numa semana (1,5% do piloto + 1,9 ponto), ou 1 erro crítico. Decide: Patrícia. Volta: Rafael aponta para a v2.1 em até 2 h. Avisada antes: Juliana.
Semana 8, reversão: 7 de 158 promessas não cumpridas (4,4%). Assumidas pela Juliana: 30 de 158 (19,0%). Revertido em 2 h, v2.2 guardada, Carlos informado.
Causa provável: a rota de Sorocaba mudou de dia e a tabela não tinha validade nem aviso.
Próxima candidata: v2.3, tabela com o Valdir como dono, validade semanal e aviso de mudança.
Versão
O que mudou
Situação
2.0
Dossiê do G3: cargo, constituição, matriz
guardada
2.1
Trava: soma do dia do mesmo cliente acima de R$ 5 mil vai para aprovação (caso T-27)
em uso
2.2
Tabela de rotas no pacote de contexto (ciclo 0001)
revertida na semana 8: promessas não cumpridas 4,4% > 3,4%
2.3
Tabela de rotas com dono, validade semanal e aviso de mudança
proposta
Alçada do ciclo: L1. Nenhuma linha apagada.
Promover sem gatilho. Na hora do problema, ninguém sabe se é para voltar.
Gatilho sem conta. Apertado demais, reverte por acaso; largo demais, nunca dispara.
Esperar reunião para voltar. Reverter pelo gatilho escrito não pede aprovação.
Apagar a versão que falhou. Ela é a memória do que não funcionou.
Procurar culpado. A pergunta é o que mudou e que proteção faltou.
04 · Simulação: o Carlos não quer voltar
Conversa simulada para treinar. O gatilho disparou e o dono gostou da versão nova. Responda com o que está escrito no registro de promoção.
Carlos · dono da Horizonte (simulação)Horizonte Distribuidora, empresa fictícia de estudo
Escolha a sua resposta. O comentário aparece logo depois e a conversa segue conforme a escolha.
05 · Prática
Os registros da Horizonte para treinar; a promoção e a volta ensaiada do seu agente para valer.
1 · Promoção, reversão e histórico da Hora
30 min
Com os números desta aula, preencha o registro de promoção da v2.2 (semana 7) e o de reversão (semana 8). Refaça a conta do gatilho. Monte o histórico da Hora com as versões 2.0 a 2.3 e marque a alçada do ciclo.
Pronto quando: a promoção tem aprovador diferente de quem propôs, janela de vigia, gatilho com número e a conta (1,5% + 1,9 = 3,4%), quem decide a volta, os passos com tempo e os avisados; a reversão tem o número que disparou (7 de 158), a causa provável e a próxima candidata; e o histórico tem 4 linhas, nenhuma apagada.
2 · A volta ensaiada do seu agente
45 min
Para a mudança do seu ciclo da aula 5 (ou para a próxima mudança do seu agente), escreva o registro de promoção com o gatilho calculado. Depois ensaie a volta num ambiente de teste ou fora do horário: aponte para a versão anterior, cronometre e confira se nada se perdeu.
Pronto quando: o registro de promoção está salvo com gatilho em número e a conta; a volta foi ensaiada uma vez com o tempo medido; o histórico de versões do seu agente existe; e quem decide a volta confirmou por escrito que sabe disso.
3 · A conversa com o Carlos
10 min
Faça a simulação acima até chegar ao placar máximo. Se errar, leia o comentário e recomece.
Pronto quando: a simulação terminou em "Voltar sem drama, melhorar com método" com 8 de 8 pontos.
06 · Teste rápido
4 perguntas. A explicação aparece depois da sua tentativa.
Pergunta 1 de 4
Depois da promoção, a meta da v2.2 seguia ótima, mas um guarda-corpo passou do limite escrito. O que vale?
Correto
Guarda-corpo existe para que uma meta bonita não esconda um estrago. Se ele cai além do limite, a versão volta.
Quem precisa aprovar a reversão feita pelo gatilho escrito?
Correto
Promover pede aprovação de quem não propôs; voltar à versão conhecida, pelo gatilho combinado, não espera reunião. O Carlos é informado com o número.
Não é essa
Promover pede aprovação de quem não propôs; voltar à versão conhecida, pelo gatilho combinado, não espera reunião. O Carlos é informado com o número.Rever: Quatro regras para promover e voltar
Pergunta 4 de 4
A partir de quando um ciclo LOOP-R pode promover sozinho (L2)?
Correto
O próprio ciclo ganha alçada como um agente: com evidência e um nível por vez. A Horizonte acabou de reverter uma promoção, então segue em L1.
Não é essa
O próprio ciclo ganha alçada como um agente: com evidência e um nível por vez. A Horizonte acabou de reverter uma promoção, então segue em L1.Rever: Quatro regras para promover e voltar
Teste concluído
Você acertou {a} de {n}. Acertando todas, a aula é marcada como concluída.
Escolha uma alternativa. A explicação aparece depois da sua tentativa.
07 · Resumo
Promoção com voltaVigia, gatilho em número, quem decide e como voltar, escritos antes.
Gatilho com contaTaxa do piloto mais dois erros-padrão da semana: nem reverte por acaso, nem nunca.
Voltar sem culpadoVersão conhecida, aviso antes, nada apagado; depois, causa e proteção.
Histórico e alçadaToda versão fica registrada; o ciclo sobe de L1 para L2 só com evidência.
