MakionDocs ← makion.dev

Modo autónomo

O modo autónomo permite que o agente trabalhe sem supervisão. Você entrega-lhe uma tarefa ou uma especificação existente, ele trabalha por conta própria sobre o seu sistema SAP totalmente em apenas leitura, e só consegue propor alterações — nunca escrevê-las. Cada proposta chega a uma fila de envio, onde um humano a aprova e, num passo deliberado separado, a aplica ao SAP.

Esta é a barreira de segurança mais forte do Makion. No Chat interativo uma função com escrita altera o SAP conforme você a dirige; no modo autónomo não existe esse atalho — o acesso do agente ao SAP é de apenas leitura durante toda a execução, e o único caminho para uma escrita é um humano clicar em Aplicar ao SAP. Consulte o Modelo de segurança para saber como isto é imposto.

Quem o pode usar e como o ativar#

O separador Autónomo é visível apenas a um administrador do projeto, e tem de ser ativado por projeto por um administrador.

Se o separador estiver desativado, verá:

O modo autónomo não está ativado para este projeto — um administrador pode ativá-lo no painel de Admin

Um administrador ativa-o para um projeto no painel Configurar projetos. Está desativado por predefinição e aplica-se apenas ao projeto para o qual está ativado.

O pipeline de aplicação numa imagem#

O modelo completo tem três fases, e cada fase a partir da primeira é uma ação humana:

  1. Propor (agente, apenas leitura) — o agente executa sem supervisão e escreve as suas alterações pretendidas na fila de envio como propostas. Nada toca no SAP.
  2. Aprovar (humano) — uma pessoa revê uma proposta e aprova-a ou rejeita-a. Aprovar apenas regista a sua decisão — não escreve nada.
  3. Aplicar (humano) — uma pessoa clica em Aplicar ao SAP. Este é o único passo que escreve. Aplicar uma única proposta escreve um objeto; aplicar todas as propostas aprovadas escreve-as todas e depois ativa-as (consulte Aplicar todas — o processo de duas fases).

Aprovar não é aplicar. Uma proposta pode ficar Aprovada indefinidamente com zero efeito no SAP. O sistema em produção só muda quando um humano clica em Aplicar ao SAP e confirma.

O iniciador#

O iniciador arranca e controla uma execução autónoma.

Controlo O que faz Quando aparece
Projeto: {name} Uma linha a nomear o projeto que esta execução tem como alvo. Sempre
Descreva a tarefa para o agente Uma área de texto para uma tarefa em linguagem comum. Mutuamente exclusiva com o seletor de especificação — use um ou outro. Sempre
…ou execute uma especificação existente Um seletor para executar uma especificação guardada em vez de uma tarefa escrita. Mutuamente exclusivo com o texto da tarefa. Sempre
Executar Arranca a execução. Mostra Running… enquanto está em curso. Sempre
Parar Larga o fluxo em direto mas deixa a execução retomável — o trabalho não é terminado, apenas destacado da sua vista. Enquanto uma execução está em curso
Cancelar execução Termina a execução do lado do servidor. Mostra Cancelling… enquanto termina. Enquanto uma execução está em curso

Forneça ou uma descrição de tarefa ou uma especificação, nunca ambas — as duas entradas são mutuamente exclusivas.

Falha e retoma#

Uma execução autónoma pode parar antes de terminar. Quando uma execução falhou ou foi interrompida, um aviso mostra um motivo tipificado e uma forma de continuar:

O aviso inclui um botão Retomar, que continua a partir do primeiro passo não concluído em vez de recomeçar do início.

Acompanhar uma execução#

Durante e após uma execução, o separador mostra o seu progresso:

A fila de envio#

A fila de envio — Alterações propostas (fila de envio) — é a lista de alterações que o agente pretende fazer. Nada nela tocou no SAP.

Aprovar apenas regista a sua decisão — nada toca no SAP até que aplique explicitamente um item aprovado.

Cada proposta passa por um conjunto fixo de estados:

Pendente → Aprovar → Aplicar (escreve no SAP).

Controlos por proposta#

Cada proposta mostra um Requisito (que alteração é proposta) e uma Justificação (porque é que o agente a propõe), um estado, e as suas próprias ações.

Campo / controlo O que faz
Requisito A alteração que o agente propõe.
Justificação Porque é que o agente a propõe.
Estado Um de Pendente, Aprovada, Rejeitada, Aplicada.
Aprovar Regista a aprovação. Não escreve no SAP.
Rejeitar Regista a rejeição. Não escreve no SAP.
Eliminar esta proposta Remove a proposta da fila.
Aplicar ao SAP Escreve esta alteração no SAP. Mostra Applying… enquanto está a correr.

Aplicar ao SAP é a única ação por proposta que escreve. Inclui um aviso ⚠ — Aplicar ESCREVE esta alteração no sistema SAP em produção — e uma caixa de diálogo de confirmação:

Escrever esta alteração em {object}… não pode ser anulado. Tem de clicar em Sim, escrever no SAP para prosseguir, ou em Cancelar para recuar.

Ações em massa#

A fila também oferece ações sobre muitas propostas de uma só vez:

Ação O que faz
Aprovar todas as pendentes Aprova todas as propostas pendentes de uma só vez (pede-lhe para confirmar). Ainda assim não escreve no SAP.
Aplicar todas as aprovadas ao SAP Escreve e ativa todas as propostas aprovadas num processo de duas fases (ver abaixo).
Limpar rejeitadas Remove todas as propostas rejeitadas da fila.
Limpar todas as não aplicadas Remove todas as propostas que não foram aplicadas.

Aplicar todas — o processo de duas fases#

Aplicar todas as aprovadas ao SAP não escreve os objetos um de cada vez. Corre em duas fases sobre exatamente o conjunto de propostas aprovadas — a mesma forma que ativar um transporte:

  1. Fase 1/2 — a escrever… — todos os objetos são escritos inativos.
  2. Fase 2/2 — a ativar… — corre uma única ativação em massa sobre exatamente esse conjunto de objetos.

Escrever tudo inativo primeiro e depois ativar todo o conjunto em conjunto evita os estados intermédios corrompidos que obteria ao ativar os objetos um a um quando estes dependem uns dos outros.