# Propagation et observabilité des ensembles de configuration
<a name="gateway-rules-propagation"></a>

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
<a name="gateway-rules-propagation-how"></a>

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.

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

1. 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.

1. 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](#gateway-rules-propagation-mcp).

## Comportement sur les cibles MCP
<a name="gateway-rules-propagation-mcp"></a>

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
<a name="gateway-rules-propagation-constraints"></a>
+ 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
<a name="gateway-rules-propagation-observability"></a>

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.