View a markdown version of this page

Ausbreitung und Beobachtbarkeit des Konfigurationspakets - Amazon Grundgestein AgentCore
Wie sich Konfigurationspakete verbreitenVerhalten auf MCP-ZielenBeschränkungenBeobachtbarkeit bei der Lösung von Regeln

Ausbreitung und Beobachtbarkeit des Konfigurationspakets

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

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.

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

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

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

Verhalten auf MCP-Zielen

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

  • 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

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.