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.

Les bases de connaissances gérées par Amazon Bedrock en tant que cible du connecteur

Les bases de connaissances gérées d'Amazon Bedrock fournissent une génération augmentée (RAG) entièrement gérée : Amazon Bedrock gère le stockage vectoriel, l'ingestion des données et l'optimisation de la récupération. Il n'existe donc aucune infrastructure de récupération à mettre en place ou à exploiter. Amazon Bedrock AgentCore propose une base de connaissances gérée sous la forme d'un connecteur Gateway natif : vous l'associez à votre AgentCore passerelle et vos agents la découvrent et l'interrogent à l'aide d'appels MCP (Model Context Protocol) standard, sans aucune intégration de récupération personnalisée à créer. Pour plus d'informations sur la création et la gestion d'une base de connaissances gérée, consultez la section Bases de connaissances pour Amazon Bedrock dans le guide de l'utilisateur d'Amazon Bedrock.

Le connecteur expose deux outils. Le premier estAgenticRetrieveStream. Au lieu d'effectuer une recherche unique, il planifie une stratégie de récupération, exécute plusieurs étapes de récupération dans vos bases de connaissances gérées, s'étend éventuellement à des documents complets et diffuse à la fois les résultats à l'appui et une réponse synthétisée, étayée par des citations. Retrieveeffectue une recherche hybride unique et renvoie les passages les plus pertinents.

Les sections suivantes présentent le fonctionnement du connecteur, la recherche agentique en profondeur, les cas d'utilisation courants, la configuration d'une cible et les schémas d'entrée et de réponse des deux outils.

Comment ça marche

Amazon Bedrock AgentCore fournit un connecteur intégré aux bases de connaissances gérées par Amazon Bedrock. La passerelle gère la gestion des schémas, la résolution des terminaux et l'authentification des services. Le connecteur propose deux outils que votre agent découvre à l'aide tools/list de :

Une seule Retrieve invocation suit ce flux :

Pour le flux de récupération agentique, voir Retrait agentic.

Extraction agentique

AgenticRetrieveStreamtraite une question comme une tâche : au lieu d'une recherche hybride unique exécutée pour une seule requête, il planifie une stratégie de recherche, exécute plusieurs étapes de récupération dans vos bases de connaissances gérées et diffuse les résultats correspondants ainsi qu'une réponse synthétisée et étayée par des citations, le tout en un seul outil. Retrieve La réponse synthétisée est renvoyée par défaut ; paramétrée sur generateResponse pour false renvoyer uniquement les résultats.

Votre agent l'invoque par le biais d'une conversation (messages). Les outils de recherche qu'il interroge, chacun pointant vers une base de connaissances gérée, sont configurés par l'administrateur de la cible et ne sont pas fournis par l'agent. La planification et la récupération progressent sur MCP au fur et à mesurenotifications/message, et les résultats et la réponse sont renvoyés dans le résultat de l'outil.

Pour en savoir plus sur le fonctionnement de la récupération agentique, consultez les bases de connaissances d'Amazon Bedrock dans le guide de l'utilisateur d'Amazon Bedrock.

Pour le schéma de demande et d'événement, voir schéma AgenticRetrieveStream d'entrée et format de AgenticRetrieveStream réponse.

Cas d’utilisation

Mettre en place une base de connaissances gérée

Pour obtenir des instructions sur la création d'une cible de passerelle avec la configuration du connecteur Amazon Bedrock Managed Knowledge Bases, y compris des exemples de configuration à l'aide du SDK Python et de l'interface de ligne de commande, voir Configurer une base de connaissances gérée dans le guide de configuration de la 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 de récupération sur la base de connaissances gérée 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.

Invoquer les outils

Une fois que vous avez créé la cible, votre agent découvre les outils avec tools/list lesquels il les appelletools/call. Chaque nom d'outil est précédé du nom de la cible, dans le formulaire managed-kb___Retrieve (<target-name>_<tool-name>_AgenticRetrieveStreamou).

En AgenticRetrieveStream effet, votre agent transmet uniquement la conversation. Les récupérateurs sont configurés sur la cible par l'administrateur, de sorte que l'agent n'envoie pas d'ID de base de connaissances :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "managed-kb___AgenticRetrieveStream",
    "arguments": {
      "messages": [
        { "role": "user", "content": { "text": "How do I configure a knowledge base target?" } }
      ]
    }
  }
}

PourRetrieve, l'identifiant de la base de connaissances gérée est lié à la cible, de sorte que votre agent transmet uniquement la requête :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "managed-kb___Retrieve",
    "arguments": {
      "retrievalQuery": { "text": "What is Amazon Bedrock AgentCore?" }
    }
  }
}

Si vous avez exposé les paramètres de récupération à l'agent (voir Contrôler les paramètres que l'agent peut définir), l'agent peut remplacer les paramètres par défaut configurés par l'administrateur au moment de l'appel :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "managed-kb___Retrieve",
    "arguments": {
      "retrievalQuery": { "text": "insurance benefits" },
      "retrievalConfiguration": {
        "managedSearchConfiguration": { "numberOfResults": 2 }
      }
    }
  }
}

AgenticRetrieveStream schéma d'entrée

Le schéma renvoyé par tools/list est l'ensemble de champs que votre agent peut définir lorsqu'il appelleAgenticRetrieveStream. Par défaut, le seul champ visible par l'agent est. messages Les extracteurs à interroger et toutes les configurations de récupération sont définis par l'administrateur sur la cible — voir Configuration d'une base de connaissances gérée. Pour exposer davantage de champs à l'agent, configurez-le parameterOverrides sur la cible — voir Contrôler les paramètres que l'agent peut définir.

{
  "type": "object",
  "properties": {
    "messages": {
      "description": "The messages for the agentic retrieval conversation. Contains the user query and conversation history.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "description": "The role of the message sender (user or assistant).",
            "type": "string",
            "enum": ["user", "assistant"]
          },
          "content": {
            "description": "The content of the message.",
            "type": "object",
            "properties": {
              "text": {
                "description": "The text content of the message.",
                "type": "string"
              }
            }
          }
        },
        "required": ["content", "role"]
      }
    }
  },
  "required": ["messages"]
}

Pour les champs définis par l'administrateur —retrievers, agenticRetrieveConfiguration (modèle de base, reclassement et garde-fouspolicyConfiguration)maxAgentIteration, et generateResponse — voir Configurer une base de connaissances gérée et une référence de configuration. Référence de configuration

AgenticRetrieveStream format de réponse

AgenticRetrieveStreamdiffuse une séquence d'événements. Sur MCP, les événements de trace sont fournis en fonction notifications/message de la progression en temps réel, et les résultats de récupération et la réponse synthétisée sont fournis dans le résultat de l'outil. Le flux émet les types d'événements suivants :

La structure d'un result événement est la suivante :

{
  "result": {
    "results": [
      {
        "content": {
          "text": "Amazon Bedrock AgentCore manages the storage, indexing, and retrieval infrastructure for a managed knowledge base...",
          "mimeType": "text/plain"
        },
        "sourceRetriever": { "identifier": "kb-retriever-1" },
        "metadata": { "x-amz-bedrock-kb-source-uri": "s3://example-bucket/docs/overview.pdf" }
      }
    ],
    "generatedResponse": {
      "answer": "A managed knowledge base lets Amazon Bedrock AgentCore handle the vector store, ingestion, and retrieval for you.",
      "citations": [
        {
          "startIndex": 0,
          "endIndex": 98,
          "references": [ { "..." : "references to supporting results" } ]
        }
      ]
    }
  }
}

Récupérer le schéma d'entrée

Le schéma renvoyé par tools/list est l'ensemble de champs que votre agent peut définir lorsqu'il appelleRetrieve. Par défaut, le seul champ visible par l'agent est. retrievalQuery.text L'identifiant de la base de connaissances gérée et tous les paramètres de récupération sont définis par l'administrateur sur la cible. Pour exposer les paramètres de récupération tels que numberOfResults les métadonnées filter de l'agent, configurez-les parameterOverrides sur la cible. Consultez la section Contrôler les paramètres que l'agent peut définir.

{
  "type": "object",
  "properties": {
    "retrievalQuery": {
      "description": "Contains the query to send the managed knowledge base.",
      "type": "object",
      "properties": {
        "text": {
          "description": "The text of the query made to the managed knowledge base.",
          "type": "string"
        }
      }
    }
  },
  "required": ["retrievalQuery"]
}

Pour les champs définis par l'administrateur et pouvant être remplacés (métadonnéesnumberOfResults, reclassement et requêtes d'images multimodales) filteroverrideSearchType, reportez-vous à la section Référence de configuration. Référence de configuration

Récupérer le format de réponse

L'Retrieveoutil renvoie un tools/call résultat MCP enveloppé dans une JSON-RPC enveloppe. Les content champs isError et se trouvent à l'intérieur result et le text champ contient la retrievalResults charge utile sérialisée :

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": false,
    "content": [
      {
        "type": "text",
        "text": "{\"retrievalResults\":[{\"content\":{\"type\":\"TEXT\",\"text\":\"Amazon Bedrock AgentCore manages the storage, indexing, and retrieval infrastructure for a managed knowledge base...\"},\"location\":{\"type\":\"S3\",\"s3Location\":{\"uri\":\"s3://example-bucket/docs/overview.pdf\"}},\"score\":0.87,\"metadata\":{\"x-amz-bedrock-kb-source-uri\":\"s3://example-bucket/docs/overview.pdf\"}}]}"
      }
    ]
  }
}

La structure de chaque élément retrievalResults est la suivante :

Référence de configuration

Les champs suivants sont définis par l'parameterValuesadministrateur ou exposés à l'agent lorsque vous créez la cible. parameterOverrides Pour savoir où les définir, voir Configurer une base de connaissances gérée et Contrôler les paramètres que l'agent peut définir.

AgenticRetrieveStream — agenticRetrieveConfiguration

Retrieve — managedSearchConfiguration

Filtrage du contrôle d'accès

Si votre base de connaissances gérée utilise le contrôle d'accès pour filtrer les résultats par utilisateur ou par groupe, l'application appelante doit transmettre la demande. userContext La passerelle userContext passe à la base de connaissances, qui applique un filtrage de contrôle d'accès en fonction de celle-ci. La passerelle n'est pas renseignée à userContext partir de l'identité IAM de l'appelant ; votre application doit la fournir explicitement.

Pour l'utiliser :

{
  "arguments": {
    "retrievalQuery": { "text": "insurance benefits" },
    "userContext": {
      "userId": "user@example.com"
    }
  }
}