Managed Abstraction With Bedrock Agents Part 1

import json
import urllib.request
import urllib.error
import os

API_BASE = "https://api.example.com"  # or use an environment variable

def lambda_handler(event, context):
    # Basic validation
    params = event.get("parameters", {})
    order_id = params.get("orderId")
    if not order_id:
        return {"error": "Missing required parameter: orderId"}

    url = f"{API_BASE}/orders/{order_id}"
    req = urllib.request.Request(url, headers={
        # Example: use an API key stored in an environment variable
        "Authorization": f"Bearer {os.environ.get('EXTERNAL_API_TOKEN', '')}",
        "Accept": "application/json"
    })

    try:
        with urllib.request.urlopen(req, timeout=10) as resp:
            payload = json.loads(resp.read().decode())
    except urllib.error.HTTPError as e:
        # Map HTTP errors into structured responses the agent can reason about
        return {"orderId": order_id, "error": f"HTTP {e.code}: {e.reason}"}
    except Exception as e:
        # Catch network/timeout/parse issues
        return {"orderId": order_id, "error": f"Request failed: {str(e)}"}

    # Shape and return only the data the agent needs
    return {
        "orderId": order_id,
        "status": payload.get("status"),
        "summary": {
            "total": payload.get("total"),
            "currency": payload.get("currency")
        }
    }