Primeiro agente

Este documento leva um processo real até um agente publicado, em uma sessão. A parte que costuma levar semanas, que é decidir como o processo deve funcionar, continua levando o tempo que levar; a parte de construí-lo deixa de ser um projeto.

Ele pressupõe o ambiente montado, com a Skill instalada, o MCP conectado e a chave do seu provedor de modelo registrada, que é o que permite ao agente rodar qualquer inferência.

Escolha um processo pequeno e verdadeiro, um que você consiga descrever em cinco frases e que aconteça pelo menos algumas vezes por semana. Processos grandes não são mais difíceis de construir, são mais difíceis de julgar, e você ainda está aprendendo a julgar.

1 · Descreva o processo

Diga ao seu Assistant o que o negócio faz e o que incomoda, sem vocabulário técnico.

Somos uma distribuidora de peças. Cadastrar um fornecedor novo leva duas semanas: comercial recebe os documentos, financeiro confere, e acima de R$ 50 mil o diretor aprova. Quero automatizar isso.

Ele vai perguntar sobre casos concretos, ou seja, o que aconteceu nas últimas vezes, principalmente nas que deram errado. Responda com o que aconteceu de fato e não com o que deveria acontecer, porque a diferença entre os dois é exatamente onde o processo falha hoje.

2 · Decida o processo

Antes de construir, ele devolve o que descobriu e aponta onde o processo pode mudar, seja um passo redundante, uma verificação no lugar errado ou uma decisão que não precisa de gente.

Essa decisão é sua. Ele traz a consequência de cada opção, e quem escolhe é quem responde pelo processo.

É a etapa que mais economiza tempo e a que mais se tenta pular. Automatizar um processo ruim não o conserta, apenas torna os erros dele sistemáticos e rápidos.

3 · Deixe construir

A partir daqui ele trabalha, montando a base de conhecimento com os fatos que o agente vai precisar afirmar, desenhando o procedimento como um grafo de etapas e compondo o agente que vincula os dois.

Tudo isso nasce em preview, então nada alcança produção, nada é irreversível e você pode pedir para refazer qualquer parte.

Vale acompanhar duas coisas enquanto ele constrói. Os nomes, porque a árvore do conhecimento e os nomes das etapas são o que você vai ler daqui a três meses. E onde entra gente, conferindo se as decisões que devem ser humanas continuam humanas.

4 · Converse com ele

Peça para conversar com o agente em preview, fingindo ser quem vai usar o processo:

Converse com o agente fingindo ser um fornecedor que mandou o CNPJ errado.

É aqui que o comportamento aparece. Uma ressalva importante: em preview as ações não disparam, então o caminho é percorrido de verdade mas a API não é chamada e nenhum valor volta dela. O que se prova aqui é o caminho, não o dado.

Cada coisa que ele faz certo e que você quer garantir que continue certa vira um cenário:

Isso que ele acabou de fazer é o que eu quero. Transforme em cenário, com três formas diferentes de dizer a mesma coisa.

Cenários nascem melhores assim, de um comportamento observado, do que imaginados antes de existir agente.

5 · Meça

Meça o agente e me mostre onde falhou, com a evidência.

Espere falhas na primeira rodada. Uma rodada que passa inteira de primeira normalmente significa que os cenários são fáceis demais, e não que o agente é bom.

Ao corrigir, faça uma alteração por rodada. Três alterações juntas que melhoram o resultado não dizem qual funcionou, e uma delas pode ter piorado, escondida pelas outras.

6 · Publique

Marque como portão os cenários que não podem regredir e submeta:

Rode os cenários de portão e submeta a publicação.

O Assistant submete e você confirma dentro da plataforma. O portão roda os cenários contra a versão congelada e só então o agente entra em produção, ou volta bloqueado dizendo qual cenário falhou e o que apareceu no lugar do esperado.

7 · Coloque em produção devagar

Um agente aprovado não precisa receber a operação inteira no primeiro dia, e há duas formas de entrar com margem. Em somente primeira mensagem ele acolhe e uma pessoa assume dali, e em responder com tags ele só age onde alguém marcou.

As duas estão em Limites de resposta, e as duas são reversíveis sem republicar nada.

Onde aprofundar

O segundo agente é mais rápido que o primeiro, porque procedimentos e bases pertencem à equipe e ele reaproveita o que já existe e já foi provado. O terceiro é mais rápido que o segundo, pelo mesmo motivo.

É assim que uma operação cresce sem que cada processo novo custe uma pessoa nova: o que você construiu uma vez continua executando, e o esforço vai para o processo seguinte em vez de voltar para o anterior.