Erste Schritte mit Konfigurationspaketen

Diese exemplarische Vorgehensweise führt Sie von Null zu einem versionierten Konfigurationspaket, das Ihr Agent zur Laufzeit liest. Sie erstellen ein Paket, aktualisieren es, um eine neue Version zu erstellen, lesen die Konfiguration und sehen sich den Versionsverlauf an.

Bevor Sie beginnen

Stellen Sie Folgendes sicher:

Die folgenden Konstanten werden in den boto3-Beispielen verwendet. Ersetze sie durch deine eigenen Werte:

REGION        = "us-west-2"
BUNDLE_ID     = "myAgentConfig-a1b2c3d4e5"  # from create response
COMPONENT_ARN = "arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/MyAgent-abc123"

Schritt 1: Erstellen Sie ein Konfigurationspaket

Erstellen Sie ein Paket mit der Erstkonfiguration Ihres Agenten. Das Bundle speichert Schlüssel-Wert-Paare (Systemaufforderung, Modell-ID, Temperatur, Werkzeugbeschreibungen), die durch den Komponenten-ARN eingegeben werden.

Schritt 2: Aktualisieren Sie das Bundle

Nachdem Sie eine Batch-Auswertung durchgeführt und festgestellt haben, dass die Antworten Ihres Agenten zu ausführlich sind, aktualisieren Sie die Systemaufforderung. Bei jedem Update wird eine neue unveränderliche Version erstellt.

Schritt 3: Lesen Sie das Bundle

Rufen Sie die aktuelle Konfiguration ab, um zu überprüfen, ob das Update wirksam wurde.

Schritt 4: Versionen vergleichen

Vergleichen Sie zwei Versionen, um genau zu sehen, was sich geändert hat:

Nächste Schritte

Anhang: Agentencode mit Integration des Konfigurationspakets

Der folgende Agentencode liest das aktive Konfigurationspaket zur Laufzeit mithilfe des BeforeModelCallEvent Hook-Musters. Der Agent wird einmal auf Modulebene erstellt, und der Hook aktualisiert die Systemaufforderung vor jedem Modellaufruf dynamisch. Änderungen am Konfigurationspaket werden sofort wirksam, ohne dass ein Neustart erforderlich ist.

Speichern Sie dies unter dem Namen Ihres main.py Agenten:

"""Agent with Configuration Bundle integration — hooks pattern."""
from strands import Agent, tool
from strands.models.bedrock import BedrockModel
from strands.hooks.events import BeforeModelCallEvent
from bedrock_agentcore.runtime import BedrockAgentCoreApp, BedrockAgentCoreContext

app = BedrockAgentCoreApp()
DEFAULT_MODEL_ID = "global.anthropic.claude-sonnet-4-5-20250929-v1:0"
DEFAULT_SYSTEM_PROMPT = (
    "You are a helpful customer support assistant for Acme Store. "
    "Help customers with their orders, returns, and shipping questions."
)


@tool
def lookup_order(order_id: str) -> str:
    """Look up an order by ID."""
    orders = {
        "ORD-1001": {"status": "delivered", "item": "Blue T-Shirt (L)", "total": "$29.99"},
        "ORD-1002": {"status": "in_transit", "item": "Running Shoes (10)", "total": "$89.99"},
        "ORD-1003": {"status": "delayed", "item": "Wireless Headphones", "days_late": 5, "total": "$59.99"},
    }
    return str(orders.get(order_id, {"error": f"Order {order_id} not found"}))


@tool
def check_shipping_status(order_id: str) -> str:
    """Check detailed shipping status for an order."""
    statuses = {
        "ORD-1002": "Package is with carrier, on schedule for April 5.",
        "ORD-1003": "Package delayed 5 days. Policy: 3+ days late qualifies for 15% discount.",
    }
    return statuses.get(order_id, f"No active shipment found for {order_id}.")


TOOLS = [lookup_order, check_shipping_status]


def dynamic_config_hook(event: BeforeModelCallEvent):
    """Read config bundle and apply system prompt before every model call."""
    config_bundle = BedrockAgentCoreContext.get_config_bundle()
    event.agent.system_prompt = config_bundle.get("system_prompt", DEFAULT_SYSTEM_PROMPT)


agent = Agent(
    model=BedrockModel(model_id=DEFAULT_MODEL_ID),
    tools=TOOLS,
    system_prompt=DEFAULT_SYSTEM_PROMPT,
)
agent.hooks.add_callback(BeforeModelCallEvent, dynamic_config_hook)


@app.entrypoint
def invoke(payload, context):
    result = agent(payload.get("prompt", "Hello"))
    return {"response": str(result)}


if __name__ == "__main__":
    app.run()