Guida introduttiva ai pacchetti di configurazione

Questa procedura dettagliata consente di passare da zero a un pacchetto di configurazione con versioni diverse che l'agente legge in fase di esecuzione. Creerai un pacchetto, lo aggiornerai per produrre una nuova versione, leggerai la configurazione e visualizzerai la cronologia delle versioni.

Prima di iniziare

Assicurati di:

Le seguenti costanti vengono utilizzate negli esempi di boto3. Sostituiscili con i tuoi valori:

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

Fase 1: Creare un pacchetto di configurazione

Crea un pacchetto con la configurazione iniziale del tuo agente. Il pacchetto memorizza le coppie chiave-valore (prompt di sistema, ID modello, temperatura, descrizioni degli strumenti) codificate dall'ARN del componente.

Passaggio 2: aggiorna il pacchetto

Dopo aver eseguito una valutazione in batch e aver rilevato che le risposte dell'agente sono troppo dettagliate, aggiorna il prompt di sistema. Ogni aggiornamento crea una nuova versione immutabile.

Fase 3: Leggi il pacchetto

Recupera la configurazione corrente per verificare che l'aggiornamento abbia avuto effetto.

Fase 4: Confronta le versioni

Differenzia due versioni per vedere esattamente cosa è cambiato:

Fasi successive

Appendice: Codice dell'agente con integrazione del pacchetto di configurazione

Il seguente codice dell'agente legge il pacchetto di configurazione attivo in fase di esecuzione utilizzando lo schema hook. BeforeModelCallEvent L'agente viene creato una sola volta a livello di modulo e l'hook aggiorna dinamicamente il prompt di sistema prima di ogni chiamata al modello. Le modifiche al pacchetto di configurazione hanno effetto immediato senza riavvio.

Salva questo file come quello del tuo agente: main.py

"""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()