View a markdown version of this page

Ferramenta de pesquisa na web - Amazon Bedrock AgentCore
Capacidades geraisPurpose-built índice da webPrivado por designComo funcionaCasos de usoConfigurar a ferramenta de pesquisa na WebUse com um arnêsConfigurar a filtragem de domínioConfigurar a função do serviço de gatewayEsquema de entradaFormato de respostaDisponibilidadeUso aceitável

Ferramenta de pesquisa na web

Os agentes de IA estão transformando a forma como as organizações interagem com as informações, mas enfrentam uma limitação fundamental: seu conhecimento é congelado no momento do treinamento. Quando um usuário pergunta sobre os preços atuais das ações ou sobre uma versão de software lançada há uma hora, um agente que depende apenas de seus dados de treinamento não pode fornecer respostas precisas.

Criar integrações personalizadas de pesquisa na web para resolver isso é caro: adquirir APIs de pesquisa de terceiros, gerenciar chaves, cotas e limites de taxas, analisar formatos de resultados inconsistentes entre fornecedores, criar uma lógica de extração de trechos para que os modelos obtenham passagens relevantes em vez de HTML bruto, raciocinar sobre para onde as consultas dos clientes chegam e como os dados podem ser retidos e manter a atualização e a cobertura ao longo do tempo. Cada um deles é um projeto em si.

A ferramenta de pesquisa na Web no Amazon Bedrock AgentCore elimina essa complexidade. É um recurso de pesquisa MCP-compliant na web totalmente gerenciado que permite que seus agentes recuperem informações da web sem nenhuma sobrecarga de infraestrutura. Ele está disponível como um conector gerenciado que você conecta ao seu AgentCore Gateway. Os agentes o descobrem com uma tools/list chamada padrão e o invocam como qualquer outra ferramenta do Model Context Protocol. Não há APIs de pesquisa para provisionar, nem credenciais de saída para gerenciar e nenhuma cola de análise de resultados para manter.

As seções a seguir abordam os principais recursos, a arquitetura do índice da Web criado especificamente, as garantias de privacidade, os casos de uso e como configurar a Ferramenta de Pesquisa na Web.

Capacidades gerais

  • Up-to-date acesso às informações — recupere os resultados atuais da web com títulos, URLs, trechos e datas de publicação para basear as respostas dos agentes em informações atualizadas.

  • Gerenciamento de infraestrutura zero — Sem APIs de pesquisa de terceiros para provisionar ou escalar para configurar. O Gateway expõe automaticamente a pesquisa na web como uma ferramenta MCP padrão.

  • Independente de estrutura — Funciona com Strands Agents, LangChain LangGraph, CrewAI ou qualquer MCP-compatible cliente por meio do Model Context Protocol padrão.

  • Purpose-built índice da web — apoiado por um índice Amazon-operated da web que abrange dezenas de bilhões de documentos.

  • Gráfico de conhecimento para fatos de alta confiança — fundamenta entidades e seus relacionamentos para fornecer respostas factuais, em vez de deixar que o modelo as deduza do texto extraído da página.

  • Extração de trechos semânticos — extrai passagens semanticamente relevantes de cada página da web, otimizadas para a janela de contexto de um modelo, em vez de retornar HTML bruto ou páginas inteiras.

Purpose-built índice da web

Muitas soluções que adicionam a pesquisa na web a um agente são mais do que um mecanismo de pesquisa terceirizado. A ferramenta de pesquisa na Web no Amazon Bedrock AgentCore é diferente — ela é apoiada por um índice da web que a Amazon cria e opera diretamente.

Ampla cobertura

O índice abrange dezenas de bilhões de documentos. Essa escala é importante para a cobertura — perguntas longas sobre bibliotecas de nicho ou especificações obscuras de produtos podem ser respondidas com mais eficácia quando o índice é amplo, em vez de limitado às páginas mais populares.

Atualizado continuamente

A Amazon atualiza o índice continuamente, refletindo conteúdos novos e alterados em minutos. Para agentes que respondem perguntas sobre movimentos de preços ou anúncios recém-publicados, essa janela de recência é a diferença entre uma resposta fundamentada e uma resposta confiantemente errada. Quando seu agente pesquisa “o que aconteceu hoje”, os resultados refletem o que realmente aconteceu hoje.

Gráfico de conhecimento para fatos de alta confiança

A Ferramenta de Pesquisa na Web inclui um gráfico de conhecimento integrado que fundamenta entidades e seus relacionamentos. Para questões factuais, como quem ocupa uma função ou quando algo foi fundado, o gráfico de conhecimento fornece respostas de alta confiança, em vez de deixar que o modelo as deduza do texto extraído da página. Isso reduz o tipo de desvio factual sutil que pode ocorrer quando um agente reúne uma resposta apenas com trechos.

Extração de trechos semânticos otimizada para o contexto do modelo

Em vez de entregar ao modelo um despejo de HTML bruto ou uma página inteira, a ferramenta realiza a extração de trechos semanticamente relevantes. Ele extrai as passagens de cada página da web que realmente contêm a consulta e as retorna em um formato otimizado para a janela de contexto de um modelo. O resultado é um contexto mais denso e relevante por token — o modelo vê as partes que importam e gasta menos tokens no clichê e no cromo de navegação, o que ajuda a melhorar a precisão das respostas citadas.

Privado por design

Para muitas empresas, a pergunta que impede o lançamento de uma pesquisa na web não é “funciona”, é “para onde vão as consultas dos meus usuários e o que acontece com elas?” A Ferramenta de Pesquisa na Web foi criada para que essas respostas sejam diretas.

As consultas nunca saem AWS

Quando seu agente emite uma pesquisa, a consulta é atendida inteiramente na AWS infraestrutura. As consultas dos clientes não são enviadas para um mecanismo de pesquisa terceirizado nem encaminhadas para fora. AWS O Gateway se autentica no conector AWS de propriedade e encaminha a solicitação internamente, para que o caminho dos dados permaneça dentro de ponta a AWS ponta. Para equipes com problemas de saída de dados, isso remove toda uma categoria de revisão.

Como funciona

A Ferramenta de Pesquisa na Web é um conector embutido. O Gateway lida com gerenciamento de esquemas, governança de parâmetros, resolução de endpoints e autenticação de serviços.

  1. Configuração do gateway — Crie um gateway e adicione um alvo da Ferramenta de Pesquisa na Web usandoconnectorId: "web-search". O Gateway captura um instantâneo do esquema da ferramenta e provisiona a integração.

  2. Descoberta de ferramentas — Seu agente tools/list liga para o endpoint do Gateway e descobre a WebSearch ferramenta com seu esquema de entrada.

  3. Invocação de pesquisa — Seu agente liga tools/call com uma consulta em linguagem natural (até 200 caracteres). O Gateway se autentica no back-end e encaminha a solicitação internamente. AWS

  4. Resultados estruturados — A ferramenta retorna resultados com trechos de texto, URLs, títulos e datas de publicação semanticamente relevantes nos formatos de texto e JSON estruturado.

  5. Resposta fundamentada — Seu agente usa os resultados para compor uma resposta com fontes citadas.

Casos de uso

  • Up-to-date pesquisa — Responda a perguntas sobre eventos atuais, preços de ações ou anúncios recentes pesquisando na web e sintetizando resultados com citações de fontes.

  • Fact-checking— verifique as reivindicações em documentos pesquisando fontes primárias e confirmando ou corrigindo números usando respostas factuais baseadas em gráficos de conhecimento.

  • Inteligência competitiva — monitore anúncios de concorrentes, lançamentos de produtos ou mudanças de preços a partir de fontes públicas da web.

  • Eliminação de conhecimento obsoleto — dê aos agentes acesso às informações publicadas após o término do treinamento, como novos lançamentos de software, mudanças de políticas ou desenvolvimentos recentes.

Configurar a ferramenta de pesquisa na Web

Para obter instruções sobre como criar um Gateway Target com a configuração do conector da Web Search Tool, incluindo exemplos de configuração usando o SDK e a CLI do Python, consulte Configurar a Ferramenta de Pesquisa na Web no guia de configuração de destino.

Use com um arnês

Para oferecer um AgentCore recurso de pesquisa na Web, conecte o gateway que você criou em Configurar a Ferramenta de Pesquisa na Web ao arnês como uma agentcore_gateway ferramenta. A função de execução do harness requer a bedrock-agentcore:InvokeGateway permissão no ARN do gateway. Para ver o passo a passo de ponta a ponta, consulte Ferramentas na documentação do arnês.

Configurar a filtragem de domínio

Você pode restringir quais domínios a Ferramenta de Pesquisa na Web pode consultar configurando uma lista de negação de domínio. Para obter exemplos e detalhes de configuração, consulte Configurar a filtragem de domínio no guia de configuração de destino.

Configurar a função do serviço de gateway

O Gateway precisa de uma função de AgentCore serviço que permita que o serviço execute ações em seu nome. Para obter as permissões e a configuração de políticas necessárias do IAM, consulte Configurar a função de serviço do Gateway no guia de configuração de destino.

Esquema de entrada

A Ferramenta de Pesquisa na Web aceita o seguinte esquema de entrada quando invocada via: tools/call

{
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "description": "The search query string",
        "type": "string"
      },
      "maxResults": {
        "description": "Maximum number of results to return. Valid range: 1-25. Defaults to 10.",
        "type": "integer"
      }
    },
    "required": ["query"]
  }
}
Campo Tipo Obrigatório Descrição

query

string

Sim

A sequência de consulta da pesquisa. Deve ter 200 caracteres ou menos.

maxResults

integer

Não

O número máximo de resultados a serem retornados. Intervalo válido: 1-25. Padronizado como dez.

Formato de resposta

A Ferramenta de Pesquisa na Web retorna os resultados no seguinte MCP-compliant formato:

{
  "isError": false,
  "content": [
    {
      "type": "text",
      "text": "{\"id\":\"824f89d0\",\"results\":[{\"text\":\"Python 3.13 was released on October 7, 2024, featuring improvements to the interactive interpreter, experimental free-threaded mode, and a preliminary JIT compiler...\",\"publishedDate\":\"2024-10-07\",\"url\":\"https://example.com/python/releases/3.13\",\"title\":\"Python 3.13 Release Highlights\"}]}"
    }
  ]
}
Campo Tipo Obrigatório Descrição

text

string

Sim

Conteúdo de texto ou trecho do resultado da pesquisa

url

string

Não

URL da página da web de origem

title

string

Não

Título da página da web de origem

publishedDate

string

Não

Data de publicação do resultado

Disponibilidade

O conector da Ferramenta de Pesquisa na Web está disponível na us-east-1 região Leste dos EUA (Norte da Virgínia).

Como a Amazon opera a pilha de pesquisa completa, as melhorias na atualização, na cobertura, na relevância e na qualidade do trecho fluem automaticamente para seus agentes por meio do mesmo conector gerenciado. Nenhuma atualização ou migração de versão é necessária por sua parte.

Uso aceitável

Se você usa a Ferramenta de Pesquisa na Web, você é responsável pelo uso e por qualquer uso por seus usuários finais do conteúdo recuperado da Ferramenta de Pesquisa na Web (“Resultados da Pesquisa”). Você deve reter e exibir as citações e os links da fonte fornecidos com cada resultado da pesquisa em qualquer saída exibida aos usuários finais que use o resultado da pesquisa. Você não pode usar a Ferramenta de Pesquisa na Web para (a) extrair, armazenar ou reproduzir conteúdo dos resultados da pesquisa em massa, ou (b) criar ou preencher um índice ou banco de dados concorrente.