As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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 exclusivamente 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 taxa, 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, raciocinando sobre para onde as consultas dos clientes vão e como os dados podem ser retidos e mantendo 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, 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

Purpose-built índice da web

Muitas soluções que adicionam pesquisa na web a um agente são incorporadas a 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.

Privado por design

Para muitas empresas, a pergunta que impede a implantação 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.

Como funciona

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

Casos de uso

Configurar a ferramenta de pesquisa na Web

Para obter instruções sobre como criar um destino de gateway com a configuração do conector da Ferramenta de Pesquisa na Web, 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 do destino.

Use com um arnês

Para oferecer um recurso AgentCore de pesquisa na Web, conecte o gateway que você criou em Configurar a Ferramenta de Pesquisa na Web ao equipamento 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 chicote.

Configurar a filtragem de domínio

A Ferramenta de Pesquisa na Web suporta 2 camadas de filtragem que compõem cada solicitação:

Request-level os filtros são compostos com a lista de exclusão de nível de destino e a lista de inclusão:

Request-level os filtros não podem substituir a lista de exclusão no nível do alvo nem expandir os resultados além da lista de inclusão no nível do alvo.

Para obter exemplos e detalhes de configuração, consulte Configurar filtragem de domínio no guia de configuração de destino.

Configurar a função de 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 de IAM e a configuração de políticas necessárias, 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 por meio de. tools/call O filters campo está disponível somente quando o alvo está fixado na versão do conector 1.2.0 ou posterior. Nas versões anteriores, o esquema expõe somente e. query maxResults

{
  "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"
      },
      "filters": {
        "description": "Optional request-level filters (connector version 1.2.0+). Applied on top of the target-level exclude list and include list.",
        "type": "object",
        "properties": {
          "domainFilter": {
            "description": "Per-call domain filter. Include and exclude lists each hold up to 100 domains. Root domain matches subdomains.",
            "type": "object",
            "properties": {
              "include": {
                "description": "Restrict results to these domains.",
                "type": "array",
                "items": {"type": "string"}
              },
              "exclude": {
                "description": "Drop results from these domains.",
                "type": "array",
                "items": {"type": "string"}
              }
            }
          },
          "publishedDateFilter": {
            "description": "Per-call published-date filter. Bounds inclusive, ISO-8601 UTC. Applies to web results only.",
            "type": "object",
            "properties": {
              "from": {
                "description": "Earliest publication date (ISO-8601 UTC).",
                "type": "string"
              },
              "to": {
                "description": "Latest publication date (ISO-8601 UTC).",
                "type": "string"
              }
            }
          }
        }
      }
    },
    "required": ["query"]
  }
}

Formato de resposta

A Ferramenta de Pesquisa na Web retorna 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\"}]}"
    }
  ]
}

Disponibilidade

O conector da Ferramenta de Pesquisa na Web está disponível nas seguintes AWS regiões:

Como a Amazon opera toda a pilha de pesquisa, as melhorias na atualização, na cobertura, na relevância e na qualidade dos trechos fluem automaticamente para seus agentes por meio do mesmo conector gerenciado. Não são necessários upgrades ou migrações de versão da 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 de origem e os links fornecidos com cada Resultado da Pesquisa em qualquer saída exibida aos usuários finais que usa 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.