# Ausbreitung und Beobachtbarkeit des Konfigurationspakets
<a name="gateway-rules-propagation"></a>

Wenn das Gateway ein Konfigurationspaket mithilfe von Regeln auflöst, leitet es das Paket über OpenTelemetry (oTEL) Baggage-Header an nachgelagerte Dienste weiter. Dies ermöglicht ein durchgängiges Konfigurationsmanagement für Ihre gesamte Gateway- und Agentenarchitektur.

## Wie sich Konfigurationspakete verbreiten
<a name="gateway-rules-propagation-how"></a>

Das Gateway legt den ARN und die Version des aufgelösten Pakets im oTEL-Baggage mithilfe der folgenden Schlüssel fest:


| Gepäckschlüssel | Description | 
| --- | --- | 
|  `aws.agentcore.configbundle_arn`  | Der ARN des aufgelösten Konfigurationspakets. | 
|  `aws.agentcore.configbundle_version`  | Die Version des aufgelösten Konfigurationspakets. | 

Der Ausbreitungsfluss funktioniert wie folgt:

1. Das Gateway wertet Regeln aus und löst ein Konfigurationspaket auf.

1. Das Gateway legt den Paket-ARN und die Version in den oTEL-Gepäckkopfzeilen der ausgehenden Anfrage fest.

1. Die Runtime des Agenten empfängt die Anfrage zusammen mit den Baggage-Headern. Die Laufzeit wird von Ihnen gesteuert. Ihr Agentencode kann den ARN und die Version des Konfigurationspakets bei Bedarf aus dem oTEL-Gepäck lesen.

1. Wenn der Agent ein Gateway mit MCP-Zielen aufruft, liest das Gateway das Paket aus dem oTEL-Backage und wendet Überschreibungen der Tool-Beschreibung auf Antworten an. `tools/list` Details hierzu finden Sie unter [Verhalten auf MCP-Zielen](#gateway-rules-propagation-mcp).

## Verhalten auf MCP-Zielen
<a name="gateway-rules-propagation-mcp"></a>

Das Gateway wendet Überschreibungen des Konfigurationspakets auf MCP-Ziele nur für den Pfad an. `tools/list` Die `search_tool` Pfade `invoke_tool` und unterstützen keine Überschreibungen von Konfigurationspaketen.

Wenn beispielsweise ein Konfigurationspaket die Toolbeschreibung eines Ziels überschreibt, erscheint die aktualisierte Beschreibung in den Antworten, aber nicht in `search_tool` den `tools/list` Antworten.

Um diese Überschreibungen anzuwenden, ruft das Gateway auf, `GetConfigurationBundleVersion` um den Inhalt des Pakets zu lesen. Fügen Sie der Ausführungsrolle des Gateways diese Berechtigung hinzu:

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

**Anmerkung**  
Diese Berechtigung ist nur für die Gateway-Ausführungsrolle für `tools/list` MCP-Operationen erforderlich. Die Agenten-Runtime leitet das Paket weiter, ohne darauf zuzugreifen, und benötigt diese Berechtigung nicht.

## Beschränkungen
<a name="gateway-rules-propagation-constraints"></a>
+ Das Konfigurationspaket muss sich in demselben Konto wie das Gateway befinden. Cross-account Der Paketzugriff wird nicht unterstützt.
+ Gateways mit HTTP-Zielen lesen keine Konfigurationspakete aus oTEL-Gepäck. Sie lösen Bündel nur nach ihren eigenen Regeln auf. Wenn Sie ein Paket als Otel-Backage an ein Gateway mit HTTP-Zielen weiterleiten, ignoriert das Gateway es.
+ Gateways mit MCP-Zielen lesen Konfigurationspakete aus oTEL-Backage und wenden Überschreibungen nur auf den Pfad an. `tools/list`

## Beobachtbarkeit bei der Lösung von Regeln
<a name="gateway-rules-propagation-observability"></a>

Wenn das Gateway Regeln für eine Anfrage auflöst, gibt es Span-Attribute für den Span des Gateway-Servers aus. Sie können diese Attribute verwenden, um zu beobachten, welche Version des Konfigurationspakets und welche Routing-Entscheidungen angewendet wurden.

 **Attribute des Konfigurationspakets überschreiben** 


| Span-Attribut | Description | 
| --- | --- | 
|  `aws.agentcore.configbundle_arn`  | Der ARN des aufgelösten Konfigurationspakets. | 
|  `aws.agentcore.configbundle_version`  | Die Version des aufgelösten Konfigurationspakets. | 

 **Ziel-Routing-Attribute** 


| Span-Attribut | Description | 
| --- | --- | 
|  `aws.agentcore.gateway.resolved_target_name`  | Der Name des aufgelösten Ziels. | 

Verwenden Sie diese Attribute, um zu überprüfen, ob die Regeln wie erwartet gelöst werden, und um Fehler beim Routing-Verhalten zu beheben.