View a markdown version of this page

Propagation et observabilité des ensembles de configuration - Amazon Bedrock AgentCore
Comment se propagent les ensembles de configurationComportement sur les cibles MCPConstaintesObservabilité pour la résolution des règles

Propagation et observabilité des ensembles de configuration

Lorsque la passerelle résout un bundle de configuration par le biais de règles, elle propage le bundle aux services en aval via les en-têtes de bagages OpenTelemetry (OTel). Cela permet une gestion de la configuration de bout en bout sur l'architecture de votre passerelle et de votre agent.

Comment se propagent les ensembles de configuration

La passerelle définit l'ARN et la version du bundle résolus dans le bagage OTel à l'aide des clés suivantes :

Clé de bagage Description

aws.agentcore.configbundle_arn

L'ARN du bundle de configuration résolu.

aws.agentcore.configbundle_version

Version du bundle de configuration résolu.

Le flux de propagation fonctionne comme suit :

  1. La passerelle évalue les règles et résout un ensemble de configuration.

  2. La passerelle définit l'ARN et la version du bundle dans les en-têtes de bagages OTel lors de la demande sortante.

  3. Le moteur d'exécution de l'agent reçoit la demande avec les en-têtes des bagages. Le temps d'exécution est contrôlé par vous. Votre code d'agent peut lire l'ARN et la version du bundle de configuration dans le bagage OTel si nécessaire.

  4. Si l'agent invoque une passerelle avec des cibles MCP, la passerelle lit le bundle dans le bagage OTel et applique des dérogations à la description de l'outil sur les réponses. tools/list Pour en savoir plus, consultez Comportement sur les cibles MCP.

Comportement sur les cibles MCP

La passerelle applique des remplacements de bundle de configuration sur les cibles MCP uniquement pour le tools/list chemin. Les search_tool chemins invoke_tool et ne prennent pas en charge les remplacements par bundle de configuration.

Par exemple, si un ensemble de configuration remplace la description de l'outil d'une cible, la description mise à jour apparaît dans tools/list les réponses mais pas dans search_tool les réponses.

Pour appliquer ces dérogations, la passerelle appelle GetConfigurationBundleVersion pour lire le contenu du bundle. Ajoutez cette autorisation au rôle d'exécution de la passerelle :

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "bedrock-agentcore:GetConfigurationBundleVersion",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:123456789012:configuration-bundle/*"
        }
    ]
}
Note

Cette autorisation n'est requise que sur le rôle d'exécution de la passerelle pour les tools/list opérations MCP. L'environnement d'exécution de l'agent transmet le bundle sans y accéder et n'a pas besoin de cette autorisation.

Constaintes

  • Le bundle de configuration doit se trouver sur le même compte que la passerelle. Cross-account l'accès au bundle n'est pas pris en charge.

  • Les passerelles dotées de cibles HTTP ne lisent pas les ensembles de configuration contenus dans les bagages OTel. Ils résolvent les bundles uniquement selon leurs propres règles. Si vous transmettez un paquet de bagages OTel à une passerelle avec des cibles HTTP, la passerelle l'ignore.

  • Les passerelles dotées de cibles MCP lisent les ensembles de configuration à partir des bagages de l'OTel et appliquent des dérogations uniquement sur le trajet. tools/list

Observabilité pour la résolution des règles

Lorsque la passerelle résout les règles d'une demande, elle émet des attributs span sur le span du serveur de passerelle. Vous pouvez utiliser ces attributs pour observer la version du bundle de configuration et les décisions de routage qui ont été appliquées.

Attributs de remplacement du bundle de configuration

Attribut Span Description

aws.agentcore.configbundle_arn

L'ARN du bundle de configuration résolu.

aws.agentcore.configbundle_version

Version du bundle de configuration résolu.

Attributs de routage cibles

Attribut Span Description

aws.agentcore.gateway.resolved_target_name

Nom de la cible résolue.

Utilisez ces attributs pour vérifier que les règles sont résolues comme prévu et pour résoudre les problèmes de comportement de routage.