Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Outil de recherche sur le Web

Les agents d'IA transforment la façon dont les organisations interagissent avec les informations, mais ils sont confrontés à une limitation fondamentale : leurs connaissances sont figées au moment de la formation. Lorsqu'un utilisateur pose des questions sur les cours boursiers actuels ou sur une version logicielle publiée il y a une heure, un agent qui se fie uniquement à ses données de formation ne peut pas fournir de réponses précises.

La création d'intégrations de recherche Web personnalisées pour résoudre ce problème est coûteuse : achat d'API de recherche tierces, gestion des clés, des quotas et des limites de débit, analyse des formats de résultats incohérents entre les fournisseurs, création d'une logique d'extraction d'extraits de code permettant aux modèles d'obtenir des passages pertinents au lieu du code HTML brut, raisonner sur la destination des requêtes des clients et la manière dont les données peuvent être conservées, et maintenir la fraîcheur et la couverture au fil du temps. Chacun d'entre eux constitue un projet en soi.

L'outil de recherche Web sur Amazon Bedrock AgentCore élimine cette complexité. Il s'agit d'une fonction de recherche MCP-compliant Web entièrement gérée qui permet à vos agents de récupérer des informations sur le Web sans aucune surcharge d'infrastructure. Il est disponible en tant que connecteur géré que vous connectez à votre AgentCore passerelle. Les agents le découvrent à l'aide d'un tools/list appel standard et l'invoquent comme n'importe quel autre outil du Model Context Protocol. Il n'y a aucune API de recherche à provisionner, aucune information d'identification sortante à gérer et aucun lien d'analyse des résultats à gérer.

Les sections suivantes présentent les fonctionnalités clés, l'architecture de l'index Web spécialement conçu, les garanties de confidentialité, les cas d'utilisation et la configuration de l'outil de recherche Web.

Capacités clés

Purpose-built index Web

De nombreuses solutions qui ajoutent la recherche sur le Web à un agent sont intégrées à un moteur de recherche tiers. L'outil de recherche Web d'Amazon Bedrock AgentCore est différent : il est soutenu par un index Web qu'Amazon crée et gère directement.

Privé de par sa conception

Pour de nombreuses entreprises, la question qui bloque le déploiement d'une recherche sur le Web n'est pas « est-ce que cela fonctionne », mais « où vont les requêtes de mes utilisateurs et que leur arrive-t-il ? » L'outil de recherche Web est conçu pour que ces réponses soient simples.

Comment ça marche

L'outil de recherche sur le Web est un connecteur intégré. La passerelle gère la gestion des schémas, la gouvernance des paramètres, la résolution des terminaux et l'authentification des services.

Cas d’utilisation

Configurer l'outil de recherche sur le Web

Pour obtenir des instructions sur la création d'une cible de passerelle avec la configuration du connecteur de l'outil de recherche Web, y compris des exemples de configuration à l'aide du SDK Python et de l'interface de ligne de commande, voir Configurer l'outil de recherche Web dans le guide de configuration de la cible.

À utiliser avec un harnais

Pour doter un AgentCore harnais d'une fonctionnalité de recherche sur le Web, associez la passerelle que vous avez créée dans Configurer l'outil de recherche Web au harnais en tant qu'agentcore_gatewayoutil. Le rôle d'exécution du harnais nécessite l'bedrock-agentcore:InvokeGatewayautorisation sur l'ARN de la passerelle. Pour la procédure pas à pas de bout en bout, consultez la section Outils de la documentation du harnais.

Configurer le filtrage des domaines

L'outil de recherche Web prend en charge 2 couches de filtrage qui se composent à chaque demande :

Request-level les filtres sont composés avec la liste d'exclusion et la liste d'inclusion au niveau de la cible :

Request-level les filtres ne peuvent pas remplacer la liste d'exclusion au niveau cible ni étendre les résultats au-delà de la liste d'inclusion au niveau cible.

Pour des exemples de configuration et des détails, voir Configurer le filtrage de domaine dans le guide de configuration cible.

Configurer le rôle de service de passerelle

La passerelle a besoin d'un rôle de service qui permet au AgentCore service d'effectuer des actions en votre nom. Pour les autorisations IAM requises et la configuration des politiques, voir Configurer le rôle de service de passerelle dans le guide de configuration cible.

Schéma d'entrée

L'outil de recherche Web accepte le schéma d'entrée suivant lorsqu'il est invoqué viatools/call. Le filters champ n'est disponible que lorsque la cible est épinglée à une version du connecteur 1.2.0 ou à une version ultérieure. Dans les versions précédentes, le schéma exposait uniquement query etmaxResults.

{
  "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"]
  }
}

Format de la réponse

L'outil de recherche sur le Web renvoie les résultats MCP-compliant au format suivant :

{
  "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\"}]}"
    }
  ]
}

Disponibilité

Le connecteur de l'outil de recherche Web est disponible dans les AWS régions suivantes :

Comme Amazon gère la pile de recherche complète, les améliorations apportées à la fraîcheur, à la couverture, à la pertinence et à la qualité des extraits sont automatiquement transmises à vos agents via le même connecteur géré. Aucune mise à niveau ou migration de version n'est nécessaire de votre part.

Utilisation acceptable

Si vous utilisez l'outil de recherche Web, vous êtes responsable de votre utilisation et de toute utilisation par vos utilisateurs finaux du contenu extrait de l'outil de recherche Web (« Résultats de recherche »). Vous devez conserver et afficher les citations sources et les liens fournis avec chaque résultat de recherche dans tout résultat que vous présentez à vos utilisateurs finaux et qui utilise le résultat de recherche. Vous ne pouvez pas utiliser l'outil de recherche Web pour (a) extraire, stocker ou reproduire du contenu des résultats de recherche en masse, ou (b) créer ou remplir un index ou une base de données concurrents.