Para equipas de engenharia · IA na prática

Medir uma tarefa com IA até à aceitação

Registe a utilização do modelo, as correções e a revisão para comparar fluxos com agentes de programação e identificar lacunas nos custos.

DevmojosCerca de 4 min de leituraEscrito com assistência de IA

Ilustração conceptual, gerada com IA: uma tarefa passa por uma etapa de testes e por um arco de revisão, regressa para correção e chega à aceitação. Não é um registo de execução medido.

Uma tarefa de programação pode exigir chamadas ao modelo durante a implementação, numa nova tentativa após uma verificação falhada e em trabalho adicional durante a revisão. A primeira mensagem de conclusão regista apenas um momento desse percurso. Uma comparação útil acompanha o trabalho até se conhecer o resultado.

Comece por uma tarefa cujo resultado alguém possa avaliar. Numa alteração ilustrativa de uma API, torne obrigatório um campo de entrada e teste valores válidos e em falta. Acorde as respostas esperadas antes de comparar abordagens, mantendo fixos os limites da tarefa e as verificações de aceitação. O exemplo abaixo não contém resultados comparativos.

Percurso ilustrativo de uma tarefa de programação: testes, revisão, correção e aceitação humana.
Percurso ilustrativo de uma tarefa. A utilização do modelo, os testes, a revisão independente e as correções integram o mesmo registo. A aceitação continua a ser uma decisão humana.
Figura 1 em texto

A alteração ilustrativa exige um campo numa API e verifica as respostas acordadas para valores válidos e em falta. Registe a utilização do modelo na implementação, nas correções e nas chamadas de revisão. Os testes fornecem evidência; a revisão pode pedir alterações e devolver o trabalho para correção. Uma pessoa decide a aceitação. Inclua também trabalho rejeitado ou abandonado no âmbito da comparação. Não são apresentados resultados medidos.

Acompanhar o trabalho, incluindo as correções

Na prática interna de desenvolvimento da Devmojos, um operador prepara instruções com âmbito definido, contexto relevante e verificações de aceitação. Verificações automáticas analisam essas instruções antes de um agente de execução começar. O agente implementa a alteração atribuída numa cópia isolada do projeto e relata o que alterou e verificou.

A revisão independente e a verificação pelo operador informam a aceitação. Se uma verificação ou revisão detetar um problema, a correção continua a fazer parte do registo da mesma tarefa. Registe o problema encontrado, a tentativa seguinte e o resultado final. Uma tarefa rejeitada, interrompida ou abandonada também pertence ao âmbito declarado da comparação.

Esta estrutura em torno de um agente é um harness: as instruções da tarefa, as ferramentas, o contexto, as passagens de trabalho e a revisão que apoiam a sua execução. Um teste bem-sucedido fornece evidência sobre o comportamento que verificou. Continua a caber às pessoas decidir se o trabalho acordado é aceitável e se deve ser lançado.

Seis fases ligam a definição da tarefa à aceitação humana, com percursos de regresso para correção ou redefinição da tarefa.
Ilustração simplificada do método interno de desenvolvimento da Devmojos. A revisão pode devolver trabalho para correção; um resultado não aceite pode exigir repensar a tarefa. É evidência do método, não um caso de poupança medida.
Figura 2 em texto

O percurso começa por acordar a tarefa, reunir contexto e escolher um modelo adequado ao trabalho. A implementação segue instruções escritas numa cópia isolada, com testes e revisão independente. Uma pessoa aceita o resultado ou devolve-o. As correções regressam ao trabalho (passo 4); um resultado não aceite pode regressar à definição da tarefa (passo 1). Cada passagem fica registada. Este método interno é ilustrativo e não apresenta poupanças medidas.

Criar um registo com medições distintas

O que se segue é uma proposta de ficha de registo para a alteração ilustrativa da API. Não é um painel de medições já recolhidas pela Devmojos. Assinale como desconhecido qualquer valor cuja fonte não esteja disponível.

Uma tarefa é analisada em cinco dimensões: utilização do modelo, ferramentas e infraestrutura, tempo decorrido, revisão e correções e resultado aceite.
Quadro ilustrativo de medição, sem resultados apresentados. Utilização, infraestrutura, tempo, revisão e resultado têm unidades diferentes. Um total monetário exige preços ou critérios de imputação definidos, sem dupla contagem.
Figura 3 em texto

Para cada tarefa, registe tokens de entrada e saída, incluindo novas tentativas e contexto reenviado; ferramentas, computação e armazenamento; tempo até ao resultado, incluindo esperas; tempo de revisão humana e rondas de correções; e o estado final de aceitação. São dimensões distintas, com as respetivas unidades. Um total monetário exige preços ou critérios de imputação explícitos, sem contar o mesmo encargo duas vezes. A ficha proposta no artigo é um registo mais completo a preencher; não demonstra que todas estas medições já são recolhidas.

Registo da tarefaUnidade ou formatoIncluir
Resultado e verificações de aceitaçãoEstado e conclusões registadosAceite, rejeitado ou abandonado; as verificações e a revisão que fundamentam esse estado
Utilização do modeloCategorias de utilização comunicadas pelo fornecedorChamadas de implementação, correção e revisão; identificar categorias de cache quando comunicadas
Custo monetárioMoeda, com base de faturação ou imputaçãoEncargos conhecidos de fornecedores e ferramentas e custos de infraestrutura atribuíveis; assinalar exclusões
Tempo decorridoTempo desde a atribuição até ao resultado declaradoEsperas, tentativas e revisão, com definições consistentes de início e fim
Trabalho humanoTempo e atividade registadosPreparação, revisão, verificação e apoio às correções
Trabalho de correçãoTentativas e motivosVerificações falhadas, problemas encontrados na revisão, continuações e trabalho reaberto
Proposta de registo para a alteração ilustrativa da API. Preencha os campos a partir de fontes identificadas, explicite o que é desconhecido e inclua trabalho sem sucesso ou abandonado no âmbito declarado da comparação.

Tokens, minutos e estados de aceitação descrevem aspetos diferentes. Converta as componentes monetárias com uma base explícita de preços ou de imputação antes de as somar e evite contar o mesmo encargo duas vezes. Subscrições de planos ou hardware local exigem uma decisão de imputação; a falta de dados de custo não é evidência de custo zero.

Alterar uma parte de uma tarefa comparável

O contexto deve dar ao agente os requisitos, o código relevante e as verificações de que precisa. Instruções que omitam uma restrição podem gerar trabalho de correção. Material adicional deve justificar a sua presença por ajudar a tarefa. As orientações da Anthropic sobre engenharia de contexto discutem este problema de seleção.

A escolha do modelo também faz parte da tarefa. A capacidade, o tempo de resposta, as restrições operacionais e a dificuldade do trabalho são relevantes. Compare as tentativas e os problemas encontrados na revisão juntamente com a utilização. A cache deve constar do registo de utilização quando essa informação estiver disponível; uma percentagem de acertos na cache, por si só, não demonstra a alteração numa fatura.

Para uma comparação, declare que tarefas concluídas e sem sucesso estão incluídas, o que se manteve comparável e o que mudou. Registe custos excluídos ou desconhecidos. Se uma abordagem produzir um resultado utilizável mas exigir mais revisão, o registo deve tornar essa relação visível em vez de a reduzir a um total de tokens.

O que a nossa prática interna demonstra

A nossa análise interna do encaminhamento inclui tempos de aceitação verificados, verificações falhadas e trabalho de correção. Não demonstra o custo monetário completo por funcionalidade aceite nem poupanças repetíveis para clientes. A ficha mais completa acima é uma recomendação de medição. A investigação da Anthropic sobre harnesses é uma leitura relacionada útil; não comprova resultados da Devmojos.

Traga uma tarefa de engenharia recorrente, as ferramentas e verificações de aceitação atuais e o ponto em que a revisão ou a correção se torna difícil. A oferta AI Engineering da Devmojos pode começar por uma avaliação do processo e uma experiência de adoção com âmbito definido, ajudando a sua equipa a decidir o que manter.

O próximo passo

Conheça a engenharia com IA

Fontes

← Voltar aos guias