A integração que a AWS descreveu em um guia publicado em 19 de novembro de 2026 usa um interceptor Skyflow no Amazon Bedrock AgentCore Gateway para tratar dados em três fluxos: argumentos enviados a ferramentas, chamadas ao modelo e documentos acessados por URL assinada. Uma função AWS Lambda intercepta solicitações e respostas, mas cada modo atua em uma parte diferente do percurso dos dados. AWS explica a arquitetura e os três modos.

Onde o interceptor entra no fluxo?

No desenho da AWS, uma função AWS Lambda se conecta a dois pontos do AgentCore Gateway: REQUEST, antes da chamada à ferramenta, e RESPONSE, depois que a ferramenta responde, mas antes de o agente receber o resultado. Em cada etapa, o interceptor pode inspecionar, reescrever ou bloquear o tráfego.

A diferença prática é o momento em que os dados são tratados. No modo de proteção da ferramenta, valores sensíveis podem ser substituídos antes que os argumentos cheguem a ela. No caminho de resposta, valores devolvidos pela ferramenta podem ser restaurados antes de o agente ler o resultado.

O que cada modo protege?

Os três modos atendem a fluxos diferentes. O modo para ferramentas mascara argumentos; o modo para o modelo encaminha as chamadas pelo endpoint de inferência do gateway; e o modo para documentos troca uma URL assinada por um link para uma cópia desidentificada.

ModoFluxo de dadosComo funciona ou requisitoLimite relevante
Shield the toolArgumentos enviados a uma ferramenta e valores que ela devolveSubstitui dados sensíveis nos argumentos por tokens reversíveis do Vault; valores repetidos na resposta podem ser restaurados antes de chegar ao agenteNos exemplos da AWS, é adequado quando a ferramenta não precisa receber a identidade real do cliente
Shield the modelPrompts, histórico, arquivos e resultados de ferramentas enviados ao modeloDesidentifica os dados e encaminha as chamadas pelo endpoint de inferência do AgentCore Gateway; restaura apenas tokens criados para aquela chamadaO cliente do modelo do agente precisa usar o endpoint de inferência do gateway
Shield the documentDocumentos acessados por URL assinadaSubstitui a URL original por um link para uma cópia desidentificada; o Skyflow Detect busca o arquivo sem passar seu conteúdo pela função LambdaA AWS descreve o processamento de URLs assinadas com Detect v2 como prévia; tamanho e tempo de processamento são limitados pela configuração e pela janela de conexão do gateway

No modo de proteção do modelo, a AWS descreve um registro temporário no Amazon DynamoDB para associar tokens a cada chamada. Segundo a empresa, esse registro não contém os valores originais. Assim, o modelo recebe os dados desidentificados, enquanto o fluxo pode restaurar somente os tokens gerados naquela chamada.

A AWS lista nomes, e-mails, telefones, documentos de identificação governamentais, números de cartão, datas de nascimento e localizações como exemplos de dados que o Skyflow Detect pode identificar. A política do interceptor fica no AWS Systems Manager Parameter Store; a chave de API do Skyflow, no AWS Secrets Manager; e decisões e métricas vão para o Amazon CloudWatch. A AWS diz que alterações na política não exigem uma nova implantação do interceptor.

O que muda para documentos e tokens?

A animação técnica da AWS sobre o fluxo de proteção de documentos, com rótulos em inglês

A reversibilidade depende do formato. Segundo a AWS, arquivos TXT, JSON, CSV, XML, JSONL, DOCX, XLSX e PPTX usam tokens reversíveis do Vault. PDFs e imagens recebem tokens de mão única: os valores originais não podem ser restaurados a partir desses arquivos.

A empresa também descreve uma política de falha fechada: se a desidentificação não puder ser concluída, a chamada é retida, e arquivos fora dos locais permitidos são recusados. No caso de documentos, a configuração de tamanho e a janela de conexão do gateway delimitam o processamento.

O que as mudanças no repositório acrescentam?

Pull requests do projeto SkyflowFoundry descrevem ajustes de implementação que ajudam a entender o que acontece além da descrição geral de uma lista de URLs permitidas.

A PR #14 relata problemas anteriores na validação de URLs de arquivos: em determinadas configurações, regras de URL podiam ser ignoradas; a correspondência de padrões sobre a URL inteira podia ser contornada; e a verificação de tamanho aceitava esquemas inseguros e seguia redirecionamentos. A PR descreve uma correção com validação de HTTPS, análise de host e caminho e restrições à verificação de tamanho. A página da PR marca a alteração como mesclada.

A PR #15 relata que eventos no formato HTTP, sem o enquadramento de ferramenta MCP, podiam passar sem inspeção. O projeto dizia que os alvos então usados eram MCP ou Lambda e descreveu a inclusão de um bloqueio padrão para eventos que não pudessem ser inspecionados. A PR marca essa alteração como mesclada.

Já a PR #18 relata que uma atualização posterior com agentcore deploy podia remover a configuração do interceptor do gateway. A alteração de persistência aparece como mesclada; a PR orienta implantar a pilha do interceptor antes de executar agentcore deploy.

Ao avaliar uma implantação, acompanhe o dado pelo caminho real: argumentos da ferramenta, chamada do modelo ou documento por URL assinada. Cada fluxo tem um requisito diferente.