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
- aws.amazon.comfonte original
- Categoria
- CEVIU Web Dev
- Publicado
- 03 de novembro de 2026
- Editoria
- CEVIU Web Dev

