top of page

API de Pesquisa Web do Amazon Bedrock AgentCore elimina a exigência de Gateway

há 4 dias
13 min de leitura

A Amazon lançou a API de Pesquisa Web do AgentCore, permitindo que aplicações pesquisem seu índice web existente sem criar antes um AgentCore Gateway. A mudança oferece aos desenvolvedores um caminho direto para os resultados de pesquisa, enquanto deixa as políticas de fontes compartilhadas a cargo do gateway ou da aplicação. Essa distinção é importante: o acesso simplificado muda quem é responsável pelos controles ao redor dele.

A nova interface atende aplicações, loops de agentes personalizados e pipelines de dados por meio de credenciais AWS conhecidas. Um loop de agente é um código de aplicação que permite repetidamente que um modelo escolha ações e processe seus resultados. Antes, a rota de pesquisa web do AgentCore exigia um gateway e um destino de pesquisa configurado. Os desenvolvedores consumiam essa ferramenta por meio do Model Context Protocol, ou MCP, um padrão para conectar aplicações de IA a ferramentas externas.

A AWS ainda recomenda o AgentCore Gateway para a maioria das cargas de trabalho com agentes. Seu anúncio de 11 de novembro apresenta o acesso direto como uma opção complementar para softwares que já gerenciam sua própria execução. A escolha central é, portanto, arquitetural: as políticas de pesquisa devem ficar em um serviço compartilhado ou cada aplicação deve aplicá-las? O lançamento remove uma exigência de configuração sem eliminar essa decisão.

O que a API de Pesquisa Web do AgentCore realmente muda

O lançamento altera o acesso à infraestrutura de pesquisa da Amazon, em vez de introduzir a primeira capacidade de pesquisa web da Amazon.

O anúncio da API de Pesquisa Web da AWS descreve uma operação independente que retorna resultados diretamente ao código que faz a chamada. Os desenvolvedores podem usar kits de desenvolvimento de software da AWS, que fornecem clientes de serviço específicos para cada linguagem, ou a AWS Command Line Interface.

A operação se chama InvokeWebSearch. As aplicações autorizam solicitações por meio do AWS Identity and Access Management, ou IAM, o serviço que define permissões para identidades AWS. As credenciais AWS existentes assinam a solicitação. Os desenvolvedores não precisam provisionar um gateway ou destino de pesquisa antes de fazer essa chamada.

A AWS afirma que a interface direta pesquisa o mesmo índice operado pela Amazon usado pelo conector de gateway. O anúncio não estabelece uma nova vantagem de qualidade de pesquisa em relação a essa rota existente. Sua contribuição mais clara é remover o intermediário quando uma aplicação precisa de resultados, e não de uma ferramenta de agente detectável.

Isso torna o lançamento relevante além dos assistentes conversacionais. Considere uma aplicação existente que coleta periodicamente anúncios públicos de produtos. Seu agendador já determina quando o trabalho é executado, seu banco de dados armazena as descobertas e seu código decide o que os usuários veem. Adicionar um gateway de agentes apenas para recuperar resultados de pesquisa introduz outro componente para essa equipe operar.

A interface direta permite que essa aplicação mantenha sua estrutura atual. A pesquisa passa a ser uma chamada de serviço dentro de um processo estabelecido. A mesma lógica se aplica a uma tarefa de monitoramento ou a um sistema de enriquecimento de conteúdo. Nenhum deles precisa de tomada de decisão autônoma apenas porque suas entradas vêm da web.

Essa distinção também muda como os desenvolvedores devem interpretar a expressão “nenhum recurso a criar”. Ela descreve o acesso à operação de pesquisa. Uma aplicação de produção ainda precisa de um ambiente de execução, permissões, tratamento de erros e algum lugar para enviar sua saída. Configurações opcionais de rede e registro também continuam sendo escolhas separadas.

A comparação relevante é, portanto, entre caminhos de integração. Um gateway organiza o acesso a ferramentas entre clientes. Uma API direta, uma interface que o software chama programaticamente, retorna dados dentro do fluxo existente de uma aplicação. A escolha entre eles deve começar pelo software que consome o resultado, e não pelo entusiasmo por qualquer uma das arquiteturas.

Para equipes que já usam o Gateway com sucesso, esse anúncio por si só não oferece motivo para migrar. O backend de pesquisa continua compartilhado. Uma migração precisaria de outra justificativa, como simplificar uma aplicação que não precisa mais de MCP ou transferir os controles de execução para o código existente.

Para equipes que antes consideravam a pesquisa do AgentCore dependente demais da infraestrutura de agentes, o lançamento muda esse cálculo. Agora elas podem avaliar o serviço de pesquisa separadamente da arquitetura de gateway.

Os responsáveis pelas aplicações ganham controle e assumem as decisões

A pesquisa direta dá aos desenvolvedores de aplicações mais controle sobre a execução, enquanto torna mais explícita sua responsabilidade sobre a política de fontes.

A pressão prática recai sobre as equipes que decidem onde colocar as regras. Um grupo de plataforma que atende muitos agentes tem requisitos diferentes dos de um desenvolvedor que adiciona pesquisa a uma aplicação estabelecida. O primeiro precisa de consistência entre clientes. O segundo geralmente precisa de uma dependência previsível dentro do código que já mantém.

As orientações da AWS sobre API e Gateway tornam esse limite concreto. Solicitações diretas carregam seus próprios filtros de domínio. O conector de gateway também pode aplicar listas de fontes configuradas em seu destino, fora da visualização do agente que faz a chamada. A API direta autoriza chamadores com IAM; o Gateway também oferece autorização de chamador baseada em token.

Essas diferenças separam a permissão para pesquisar da permissão para escolher fontes. Uma identidade de aplicação pode ser autorizada a invocar a pesquisa sem que isso estabeleça uma lista de domínios aceitáveis para toda a organização. As restrições de fontes ainda precisam de um ponto de aplicação.

Um assistente de engenharia ilustrativo torna a distinção mais fácil de enxergar. Seus desenvolvedores podem permitir pesquisas em documentação de fornecedores, enquanto excluem fóruns de discussão dos resumos de lançamentos. Se essas regras estiverem no código da aplicação, essa equipe deverá mantê-las à medida que o assistente mudar. Se vários assistentes compartilharem a política, a administração centralizada se torna mais atraente.

Nenhuma das duas abordagens é inerentemente superior. Regras locais podem se adequar a uma aplicação cujos requisitos diferem dos de todos os demais. Regras compartilhadas podem reduzir divergências quando muitas equipes precisam das mesmas restrições. A troca envolve responsabilidade e consistência, e não uma simples disputa entre flexibilidade e segurança.

O mesmo raciocínio se aplica a novas tentativas, que repetem solicitações que falharam, e ao armazenamento em cache, que reutiliza resultados anteriores. As equipes de aplicação podem posicionar essas decisões ao lado de seus controles de confiabilidade existentes. Elas também passam a ser responsáveis por garantir que esses controles reflitam como a pesquisa se comporta no fluxo de trabalho mais amplo.

Por exemplo, reutilizar a resposta de ontem pode servir para um arquivo de pesquisa em segundo plano. Seria menos adequado para uma tela que pergunta o que mudou nesta manhã. Um cache pode reduzir trabalho repetido, ao mesmo tempo em que compromete a atualização se sua duração ignorar a pergunta do usuário.

API do AgentCore vs Gateway torna-se, portanto, uma questão de limites operacionais. Onde as restrições de fontes devem mudar? Quem aprova essas mudanças? Qual componente controla a frequência das pesquisas? Qual equipe investiga uma resposta que cita um site inesperado?

Essas perguntas importam antes que uma aplicação alcance grande escala. Um protótipo geralmente tem um responsável óbvio e uma finalidade restrita. À medida que outras equipes o adotam, pressupostos sobre fontes confiáveis e reutilização aceitável podem divergir. Uma conexão direta torna esses pressupostos mais fáceis de implementar localmente, mas não mais fáceis de conciliar entre organizações.

A decisão da AWS oferece aos desenvolvedores outro lugar para traçar esse limite. Ela não elimina a necessidade de traçá-lo deliberadamente.

Os resultados de pesquisa oferecem evidências para os desenvolvedores examinarem

O valor da recuperação direta é que as aplicações podem examinar evidências antes de pedir a um modelo que as transforme em uma resposta.

A documentação de solicitação e resposta descreve resultados classificados que contêm extratos de texto. Títulos, URLs e carimbos de data e hora de publicação são opcionais. As solicitações aceitam consultas de até 200 caracteres e retornam até 25 resultados, com filtros de domínio e de horário de publicação disponíveis.

Esses detalhes descrevem uma operação de recuperação limitada. A aplicação recebe material candidato, em vez de uma garantia de que uma pergunta foi respondida integralmente. Retornar uma lista classificada também deixa ao chamador a responsabilidade de decidir quais evidências são suficientes.

Metadados opcionais criam uma decisão imediata de produto. Um resultado sem carimbo de data e hora de publicação ainda pode conter informações de contexto úteis. Por si só, ele não pode estabelecer que um anúncio pertence a uma janela de cobertura estritamente definida. A aplicação precisa de uma regra para essa incerteza.

Da mesma forma, um extrato sem URL apresenta um problema diferente de um extrato com uma fonte rastreável. Se os usuários esperam examinar as evidências de apoio, a aplicação deve decidir se uma atribuição incompleta desqualifica um resultado. Tratar silenciosamente todos os resultados como igualmente utilizáveis ocultaria essa distinção.

A filtragem por data também exige cuidado. A documentação define limites inclusivos de carimbo de data e hora e alerta que uma data sem horário significa meia-noite em seu início. Uma aplicação que traduz a seleção de calendário de um usuário deve preservar o intervalo pretendido.

Esse é um pequeno detalhe de interface com consequências potencialmente visíveis. Um usuário que seleciona um dia de cobertura espera o dia inteiro. Um ponto final traduzido incorretamente pode excluir material enquanto deixa a solicitação tecnicamente válida. O resumo resultante pode parecer bem elaborado apesar de usar uma janela de evidências não intencional.

Os filtros de domínio respondem a outra pergunta específica: de onde os resultados podem se originar. Eles não estabelecem se uma página específica sustenta a conclusão do modelo. Um editor confiável pode hospedar material de contexto que seja irrelevante para o evento solicitado.

A mesma distinção separa um extrato de pesquisa de uma verificação de fatos concluída. Um extrato pode identificar evidências promissoras. Uma conclusão importante pode exigir examinar a fonte subjacente, verificar seu contexto ou compará-la com outro registro autorizado.

A Microsoft oferece uma comparação útil por meio de suas ferramentas de grounding do Bing. Grounding significa fornecer evidências externas a um modelo antes que ele responda. A Microsoft documenta um caminho em que os desenvolvedores recebem respostas geradas com citações, em vez de acesso ao conteúdo bruto retornado.

Essa comparação destaca uma diferença arquitetural, sem estabelecer uma classificação de qualidade. Alguns produtos priorizam uma resposta citada dentro de um serviço de agentes. Outros precisam de material de pesquisa que possam examinar e processar de forma independente. A interface direta da Amazon atende ao segundo requisito.

Para compradores, a questão de avaliação deve corresponder a essa distinção. Avaliar apenas a fluência da resposta deixaria de fora o motivo para escolher uma interface de recuperação inspecionável. A questão mais relevante é se o material retornado sustenta as próprias regras de evidência da aplicação.

Um monitor de dependências mostra onde a pesquisa termina

O exemplo prático da AWS coloca a verificação no código da aplicação, ilustrando por que recuperação e cobertura validada continuam sendo tarefas separadas.

Em seu monitor diário de dependências, a AWS descreve um fluxo de trabalho de segurança criado com LangGraph, um framework para coordenar a execução de agentes. O exemplo pesquisa dependências de software, aplica regras fixas de busca, verifica as descobertas em relação às fontes retornadas e suprime itens já reportados.

A escolha de design relevante é a separação de responsabilidades. O modelo escolhe as buscas e propõe descobertas. O código controla as restrições e verifica se as evidências atendem a condições específicas. O acesso à busca fornece o material para esse processo.

A AWS também declara os limites do exemplo. Suas verificações não determinam severidade, status de exploração, versões afetadas ou ação recomendada. Portanto, associar uma descoberta à evidência recuperada é mais restrito do que verificar cada afirmação em um relatório de segurança.

Essa admissão torna o exemplo mais útil do que uma demonstração genérica de uma resposta com citações. Ela identifica o trabalho restante em vez de tratar a recuperação bem-sucedida como uma análise bem-sucedida. Uma equipe de segurança ainda precisa de informações autoritativas sobre vulnerabilidades e de revisão antes de agir.

A lição mais ampla se aplica a fluxos de trabalho menos especializados. Imagine um gerente de produto acompanhando os anúncios de um fornecedor. Encontrar uma página que menciona o produto não estabelece que um recurso está amplamente disponível. A página pode tratar de uma prévia, de um lançamento regional ou de um compromisso futuro.

Uma aplicação de relatórios deve preservar essas distinções ao transformar evidências em texto. Caso contrário, adicionar busca apenas dá às conclusões sem suporte uma apresentação mais convincente. Uma citação ajuda os leitores a examinar uma afirmação, mas sua presença, por si só, não estabelece respaldo.

O exemplo também ilustra por que regras fixas devem permanecer fora do modelo quando representam requisitos da aplicação. Uma janela de reporte não deve se ampliar apenas porque resultados mais abrangentes facilitam a redação de um resumo. Uma restrição de fontes não deve desaparecer porque o agente quer fazer outra consulta.

Essas são implicações de design de aplicação, e não evidências de que toda integração direta as implementa. As equipes podem impor regras cuidadosamente por meio de código. Também podem criar um wrapper fino que deixa escolhas importantes sem restrições. A API não determina qual abordagem elas adotam.

É nesse ponto que explicar a busca do AgentCore como uma conveniência de chamada única se torna incompleto. A chamada simplifica a obtenção de evidências. O fluxo de trabalho ao redor decide se essas evidências são apropriadas, novas, relevantes e suficientes para a saída pretendida.

A gestão do conhecimento acrescenta outra distinção. Recuperar informações públicas atuais é diferente de organizar os documentos e decisões acumulados de uma organização. Uma base de conhecimento pesquisável atende a uma necessidade relacionada: disponibilizar o conhecimento técnico existente para uso posterior.

Uma aplicação que combina ambas as fontes deve preservar suas origens. Um anúncio público, uma interpretação interna e um resumo gerado por modelo têm pesos probatórios diferentes. Uni-los em um parágrafo fluente não deve apagar essas diferenças.

O acesso IAM não resolve auditoria nem qualidade das respostas

A autenticação estabelece quem pode chamar a busca; ela não estabelece o que uma resposta prova nem se toda decisão relevante é registrada.

A API AgentCore Web Search se encaixa nos controles conhecidos de identidade da AWS, mas a cobertura de auditoria exige uma configuração separada. As equipes que avaliam o lançamento devem distinguir entre acesso ao serviço, atividade registrada, política de fontes aplicada e qualidade das evidências.

A documentação de eventos de dados do CloudTrail da AWS afirma que o registro de buscas não é ativado por padrão. O CloudTrail, serviço de registro de atividades da AWS, exige um seletor de eventos para esse tipo de recurso. Os parâmetros de solicitações registrados omitem o texto da busca e os filtros.

Isso cria uma distinção importante entre um registro de acesso e um registro de evidências. Saber que uma identidade invocou a busca não revela qual pergunta ela fez nem quais restrições de fontes forneceu. Uma investigação de incidente pode precisar dos dois tipos de informação.

Os proprietários de aplicações enfrentam, portanto, uma decisão de observabilidade. Observabilidade significa reter informações operacionais suficientes para entender o comportamento do sistema. Para uma aplicação baseada em busca, isso pode incluir fontes selecionadas, versões de política aplicadas, descobertas rejeitadas ou links exibidos aos usuários.

Mais registros não são automaticamente melhores. Consultas de busca podem revelar interesses internos, e extratos retidos podem criar obrigações adicionais de gestão de dados. O registro adequado depende do propósito da aplicação e das perguntas que seus operadores precisam responder.

O ponto importante é a especificidade. Uma equipe deve conseguir explicar o que seus registros estabelecem. Um log que mostra autorização bem-sucedida sustenta uma conclusão diferente de um registro que mostra por que uma aplicação aceitou uma afirmação.

A qualidade das respostas exige uma separação igualmente cuidadosa. O anúncio da Amazon estabelece o comportamento do produto e o uso pretendido. Ele não fornece uma comparação controlada de forma independente que prove que o índice recupera evidências melhores do que serviços concorrentes.

Sem uma avaliação comparável, afirmações de superioridade excederiam as evidências disponíveis. A relevância da busca depende das consultas, da cobertura das fontes, dos requisitos de atualização e do método de pontuação. Uma interface mais fácil de integrar ainda pode exigir testes substanciais para uma carga de trabalho específica.

Também não há motivo para supor que mudar os caminhos de acesso melhora o índice subjacente. Segundo a AWS, ambas as rotas usam a mesma infraestrutura de busca. Uma conexão direta pode simplificar a arquitetura da aplicação sem melhorar o que o backend de busca encontra.

A leitura cética é, portanto, delimitada. O lançamento sustenta uma afirmação sobre escolha de integração. Ele deixa a qualidade das evidências específica da aplicação e a eficácia dos controles implementados localmente a serem demonstradas.

Isso não diminui o valor prático do lançamento. Remover um componente desnecessário pode ajudar desenvolvedores a adotar um serviço. O valor fica mais claro quando as equipes distinguem o trabalho que a AWS removeu daquele que sua aplicação ainda possui.

Para compradores corporativos, AgentCore API vs Gateway deve, consequentemente, continuar sendo uma avaliação operacional. Uma demonstração bem-sucedida precisa mostrar os controles pretendidos funcionando sob uso normal e em condições de falha, em vez de apenas produzir uma resposta atraente.

Acompanhe a adoção, a consistência de políticas e a qualidade das evidências

Os próximos sinais úteis mostrarão se um acesso mais simples produz aplicações sustentáveis com evidências confiáveis.

O primeiro sinal é a adoção fora de interfaces centradas em agentes. Observe usos documentados em aplicações existentes, tarefas programadas de enriquecimento e pipelines de monitoramento. Essas implantações sustentariam o argumento da AWS de que a busca merece um ponto de integração independente do Gateway.

Os exemplos mais fortes explicarão qual complexidade desapareceu. Um relato confiável identificará o componente removido e descreverá a responsabilidade operacional resultante. Uma demonstração que apenas substitui uma chamada por outra estabeleceria muito menos.

Se a maioria dos exemplos publicados continuar sendo demonstrações de agentes, o caso de uso mais amplo para aplicações permanecerá menos desenvolvido. Isso não invalidaria o acesso direto, mas enfraqueceria o argumento de que cargas de trabalho sem agentes são uma razão importante para o lançamento.

O segundo sinal é como as equipes mantêm políticas de fontes à medida que o uso se expande. Observe se as integrações diretas desenvolvem componentes de política reutilizáveis ou permanecem coleções de regras locais. O resultado esclarecerá quão gerenciável se torna a governança controlada pela aplicação entre as equipes.

Uma aplicação consistente de políticas fortaleceria o argumento pela integração direta em organizações com plataformas de aplicações maduras. Desvios repetidos fortaleceriam o argumento pela administração compartilhada do Gateway. Qualquer um dos resultados refinaria a escolha arquitetural sem tornar qualquer rota universalmente preferível.

Evidências úteis incluiriam como as organizações aprovam mudanças de fontes e impedem modelos de alterar restrições obrigatórias. Também deveriam mostrar como os operadores identificam a política aplicada a uma saída contestada. Uma captura de tela da configuração, por si só, não estabeleceria esse comportamento.

O terceiro sinal é a avaliação de recuperação específica da carga de trabalho. Observe testes que medem se os resultados sustentam as afirmações solicitadas, preservam citações utilizáveis e atendem aos requisitos de atualização. Essas medidas falam mais diretamente sobre a utilidade da aplicação do que a fluência das respostas.

Uma avaliação significativa deve expor falhas e sucessos. Datas de publicação ausentes, evidências insuficientes, extratos irrelevantes e conclusões sem suporte ajudam a definir onde uma aplicação precisa de verificações adicionais. Reportar apenas respostas bem-sucedidas ocultaria esses limites.

Melhor qualidade das evidências sob condições comparáveis fortaleceria o caso do produto. Lacunas persistentes restringiriam as cargas de trabalho nas quais sua conveniência de integração supera o trabalho adicional de verificação. Nenhum dos resultados deve ser inferido apenas do anúncio de disponibilidade.

Para leitores que avaliam a API AgentCore Web Search, comece com um fluxo de trabalho cujos requisitos de evidência possam ser declarados claramente. Decida quais fontes se qualificam, como a atualização será avaliada e o que deve ocorrer quando metadados estiverem ausentes. Identifique quem é responsável por essas regras e como um operador inspecionará uma saída questionável. Em seguida, compare o acesso direto com o Gateway usando esse mesmo fluxo de trabalho. Preserve os links das fontes durante todo o processo e diferencie o texto recuperado das conclusões que sua aplicação acrescenta. O resultado mais informativo é um registro claro do que o sistema encontrou, do que aceitou e do motivo. Qual rota torna essas decisões mais fáceis de manter para sua equipe?

 
 

Comece grátis

Um assistente de IA local-first com gestão de conhecimento pessoal

Para oferecer uma experiência de IA melhor,

atualmente, o remio é compatível apenas com Windows 10+ (x64) e M-Chip Macs.

Seu parceiro de IA no trabalho
Faça mais com o remio

Planeje. Crie. Entregue.
Tudo em um só lugar.

bottom of page