Voltar
Como automatizar revisões Well-Architected de IA agêntica com o AWS Agentic AI Lens

Smarsh automatiza revisões Well-Architected de IA agêntica com o AWS Agentic AI Lens

Aprofundamento CEVIU

Aprofundamento

O ponto de partida da Smarsh foi uma lacuna prática. O Agentic AI Lens existe como orientação prescritiva (150 boas práticas, 41 perguntas, seis pilares, cada uma com nível de risco e resultado desejado), mas ainda não pode ser selecionado como lens no AWS Well-Architected Framework. Outros lenses, como o Serverless Applications Lens, entram direto na AWS Well-Architected Tool. Para esse, a revisão nativa no console não existia.

A solução foi tratar o lens como dado. A skill do Claude tem três peças: o lens_data.json (as 150 práticas, com 90 de risco alto, 59 médio e 1 baixo), o assessment-guide.md (rubrica de cinco status e regras de honestidade, como citar evidência e marcar Not Reviewed em vez de chutar) e o build_report.py, script determinístico em Python (openpyxl) que valida IDs e status e aborta o build se algo for inventado. A planilha final usa fórmulas COUNTIF no resumo. A skill foi testada com dois repositórios sintéticos: com ela, 16 de 16 expectativas passaram; sem ela, 8 de 16. Na carga real, construída sobre Amazon Bedrock AgentCore, os gaps de alto risco incluíram ausência de screening contra prompt injection, rate limiting registrado como TODO, falta de controles automáticos de custo e o authorizer de ingresso do gateway rodando sem autenticação, sob risco aceito e documentado.

Por que isso importa

Para quem desenvolve agentes, o recado é de método: checklist em formato estruturado, script que rejeita saída inválida e suíte de avaliação para a própria ferramenta deixam a revisão com IA auditável. A revisão automatizada também gera uma pauta objetiva para conversar com arquitetos da AWS, em vez de uma reunião genérica. Como a própria Smarsh mantém humanos validando os achados, a leitura aqui é que a IA produz o rascunho e o time decide.

Perguntas frequentes

O AWS Agentic AI Lens já aparece na AWS Well-Architected Tool?

Não. Segundo a fonte, ele está disponível como orientação prescritiva, mas ainda não pode ser selecionado como lens no AWS Well-Architected Framework. Por isso a Smarsh criou uma forma própria de executar a revisão.

Como a skill evita que o Claude invente itens ou resultados?

O lens_data.json é a fonte única de verdade e a skill não pode criar nem renumerar itens. O script build_report.py valida IDs e status e aborta o build se encontrar algo inválido. Além disso, todo status definitivo precisa citar evidência do repositório.

Quanto tempo a revisão leva e o que ela entrega?

A skill avalia as 150 boas práticas em horas, em vez dos vários dias de um esforço manual. A saída é uma planilha com status por item, evidências citadas, lacunas, remediação e uma aba de resumo com fórmulas COUNTIF.

Que lacunas a primeira revisão encontrou?

Entre as de alto risco estão a falta de screening contra prompt injection, rate limiting como TODO e ausência de controles automáticos de custo. O time de engenharia também ajustou resultados, como a varredura de dependências que já rodava em cada pull request.

Fontes

Avalie este artigo:
Categoria
CEVIU Web Dev
Publicado
03 de novembro de 2026
Editoria
CEVIU Web Dev

Quer receber mais sobre CEVIU Web Dev?

Conteúdo curado diariamente, direto no seu e-mail.

Conteúdo curado diariamenteDiversas categoriasCancele quando quiser