Amazon Bedrock Agents + Knowledge Bases + GuardrailsでECサイトのAIアシスタントを構築してみる

商品ID,商品名,カテゴリ,価格（円）,在庫状況,保証期間,商品説明
CM-001,{架空の企業名} スマートスピーカー Lite,スマートホーム,4980,あり,1年,音声操作対応のコンパクトなスマートスピーカー。照明・エアコンなどの家電をハンズフリーで操作できる。Wi-Fi / Bluetooth 対応。
CM-002,{架空の企業名} スマート電球 3個セット,スマートホーム,2480,あり,1年,スマートフォンアプリで色温度・明るさを調整できるLED電球。スケジュール設定・音声アシスタント連携対応。E26口金。
CM-003,{架空の企業名} スマートプラグ,スマートホーム,1980,あり,1年,既存のコンセントをスマート化するWi-Fiプラグ。電力消費量のモニタリング・タイマー設定が可能。
CM-004,{架空の企業名} ワイヤレスキーボード,PC・周辺機器,6800,あり,1年,Bluetooth 5.0対応の薄型キーボード。最大3台のデバイスとペアリング可能。単4電池2本で最大12ヶ月使用できる。
CM-005,{架空の企業名} ワイヤレスマウス,PC・周辺機器,3480,あり,1年,2.4GHz無線接続の静音マウス。DPI切替（800/1200/1600）対応。USB-Cで充電しフル充電で約60日使用可能。
CM-006,{架空の企業名} USBハブ 7ポート,PC・周辺機器,4280,あり,1年,USB-A×4・USB-C×2・SDカードスロット×1の7ポートハブ。最大100W PD充電対応。アルミ合金製で放熱性に優れる。
CM-007,{架空の企業名} モバイルモニター 15.6インチ,PC・周辺機器,24800,残りわずか,1年,フルHD（1920×1080）対応の軽量モバイルモニター。USB-C1本で映像出力・給電が可能。折りたたみスタンド付属。
CM-008,{架空の企業名} ワイヤレスイヤホン Pro,イヤホン・オーディオ,12800,あり,1年,アクティブノイズキャンセリング搭載の完全ワイヤレスイヤホン。イヤホン単体で8時間ケース込みで32時間使用可能。IPX4防水対応。
CM-009,{架空の企業名} Bluetoothスピーカー,イヤホン・オーディオ,8980,あり,1年,360度サウンド対応のポータブルスピーカー。IP67防水・防塵。最大20時間再生。USB-C充電対応。
CM-010,{架空の企業名} 空気清浄機 コンパクト,生活家電,18000,あり,2年,6畳〜10畳向けのコンパクト空気清浄機。HEPAフィルター搭載で花粉・PM2.5・ペットの毛を除去。稼働音25dBの静音設計。
CM-011,{架空の企業名} 電動歯ブラシ,生活家電,5480,あり,2年,音波振動式電動歯ブラシ。3種のブラッシングモード搭載。USB充電式で1回の充電で約30日使用可能。替えブラシ2本付属。
CM-012,{架空の企業名} コードレス掃除機,生活家電,28000,残りわずか,2年,最大65分連続使用できるコードレス掃除機。吸引力22kPa。床・カーペット・布団に対応するアタッチメント3種付属。
CM-013,{架空の企業名} スマートウォッチ,健康・フィットネス,19800,あり,1年,心拍数・血中酸素・睡眠・ストレスをモニタリングできるスマートウォッチ。GPS内蔵。バッテリー最大14日間。5ATM防水対応。
CM-014,{架空の企業名} 体組成計,健康・フィットネス,6800,あり,1年,体重・体脂肪率・筋肉量・骨量など13項目を計測できるスマート体組成計。アプリと連携してデータを自動記録。最大8ユーザー登録可能。
CM-015,{架空の企業名} ヨガマット,健康・フィットネス,3980,あり,なし,厚さ8mmの高密度NBRフォーム製ヨガマット。滑り止め加工・吸汗素材。183cm×61cmのスタンダードサイズ。収納用ストラップ付属。

# {架空の企業名} よくある質問（FAQ）

## 配送について

**Q. 配送にかかる日数はどのくらいですか？**
A. ご注文確定後、通常2〜3営業日以内にお届けします。離島・一部地域は追加で2〜3日かかる場合があります。

**Q. 送料はいくらですか？**
A. 1回の注文金額が5,000円（税込）以上の場合、送料無料です。5,000円未満の場合は全国一律550円（税込）の送料がかかります。

**Q. 配送状況を確認できますか？**
A. はい。注文確定メールに記載されている注文IDを使って、{架空の企業名}のマイページ「注文履歴」から配送状況をリアルタイムで確認できます。

**Q. 時間指定はできますか？**
A. はい。午前中・14〜16時・16〜18時・18〜20時・19〜21時の5つの時間帯から選択できます。注文時にご指定ください。

**Q. 置き配は対応していますか？**
A. はい。注文時に「置き配を希望する」を選択し、置き場所（玄関前・宅配ボックス等）を指定することができます。

## 支払いについて

**Q. 使えるクレジットカードは？**
A. VISA・Mastercard・JCB・American Express・Diners Clubに対応しています。

**Q. 後払い（コンビニ払い）はできますか？**
A. はい。コンビニ払い（セブン-イレブン・ローソン・ファミリーマート）と銀行振込が利用できます。いずれも注文確定から5日以内にお支払いください。

**Q. 分割払いはできますか？**
A. クレジットカードの分割払いはカード会社の規定に従いご利用いただけます。{架空の企業名}独自の分割サービスは現在提供しておりません。

**Q. 領収書は発行できますか？**
A. はい。マイページ「注文履歴」から PDF 形式の領収書をダウンロードできます。宛名・但し書きの変更は発行後にはできかねますのでご注意ください。

## 注文・キャンセルについて

**Q. 注文後にキャンセルできますか？**
A. 発送準備に入る前であればキャンセル可能です。マイページ「注文履歴」からキャンセル手続きを行ってください。発送後のキャンセルは返品対応となります。

**Q. 注文内容（数量・配送先）を変更できますか？**
A. 発送準備前であれば、カスタマーサポートへご連絡いただくことで対応できる場合があります。発送後の変更はできかねます。

**Q. 在庫がない商品はいつ入荷しますか？**
A. 入荷時期は商品ページの「入荷お知らせを受け取る」ボタンから登録いただくと、入荷次第メールでご連絡します。具体的な入荷日のお答えは難しい場合があります。

## アカウントについて

**Q. パスワードを忘れました。**
A. ログイン画面の「パスワードをお忘れの方」からメールアドレスを入力してください。パスワードリセット用のメールをお送りします。

**Q. メールアドレスを変更したい。**
A. マイページ「アカウント設定」→「メールアドレス変更」から手続きできます。新しいメールアドレスに確認メールが届きますので、リンクをクリックして変更を完了してください。

**Q. 退会したい。**
A. マイページ「アカウント設定」→「退会手続き」から申請できます。未配送の注文がある場合や、未払いの残高がある場合は退会できません。退会後のデータ復元はできませんのでご注意ください。

## その他

**Q. ギフト包装はできますか？**
A. はい。注文時に「ギフト包装を希望する」を選択してください。ギフトメッセージカードの同封も可能です（無料）。

**Q. 領収書の宛名を会社名にできますか？**
A. はい。注文時または領収書ダウンロード時に宛名を入力してください。

**Q. 問い合わせ方法を教えてください。**
A. カスタマーサポートはチャット（平日10〜18時）またはメール（24時間受付、返答は翌営業日以内）で対応しています。

import json
import random
from datetime import datetime, timedelta

# Mock order data
MOCK_ORDERS = {
    "CM-2026-000001": {
        "order_id": "CM-2026-000001",
        "status": "配送中",
        "product": "{架空の企業名} スマートスピーカー Pro",
        "quantity": 1,
        "price": 12800,
        "order_date": "2026-04-05",
        "estimated_delivery": "2026-04-08",
        "tracking_number": "1234-5678-9012",
        "cancellable": False,
    },
    "CM-2026-000002": {
        "order_id": "CM-2026-000002",
        "status": "処理中",
        "product": "{架空の企業名} ワイヤレスイヤホン Z1",
        "quantity": 2,
        "price": 19600,
        "order_date": "2026-04-07",
        "estimated_delivery": "2026-04-10",
        "tracking_number": None,
        "cancellable": True,
    },
    "CM-2026-000003": {
        "order_id": "CM-2026-000003",
        "status": "配達完了",
        "product": "{架空の企業名} 4Kウェブカメラ Ultra",
        "quantity": 1,
        "price": 15800,
        "order_date": "2026-04-01",
        "estimated_delivery": "2026-04-04",
        "tracking_number": "9876-5432-1098",
        "cancellable": False,
    },
}


def get_order(order_id: str) -> dict:
    """注文状況を照会する"""
    order = MOCK_ORDERS.get(order_id)
    if not order:
        return {
            "success": False,
            "message": f"注文番号 {order_id} が見つかりません。正しい注文番号をご確認ください。",
        }
    return {
        "success": True,
        "order": order,
        "message": f"注文番号 {order_id} の状況をお伝えします。",
    }


def cancel_order(order_id: str) -> dict:
    """注文をキャンセルする"""
    order = MOCK_ORDERS.get(order_id)
    if not order:
        return {
            "success": False,
            "message": f"注文番号 {order_id} が見つかりません。",
        }
    if not order["cancellable"]:
        return {
            "success": False,
            "message": f"注文番号 {order_id} はすでに{order['status']}のためキャンセルできません。返品をご希望の場合はお問い合わせください。",
        }
    # Mock cancellation
    MOCK_ORDERS[order_id]["status"] = "キャンセル済み"
    MOCK_ORDERS[order_id]["cancellable"] = False
    return {
        "success": True,
        "order_id": order_id,
        "message": f"注文番号 {order_id} をキャンセルしました。返金は3〜5営業日以内に処理されます。",
    }


def build_response(action_group: str, api_path: str, http_method: str, body: dict) -> dict:
    """Bedrock Agent用のレスポンスを構築する"""
    return {
        "messageVersion": "1.0",
        "response": {
            "actionGroup": action_group,
            "apiPath": api_path,
            "httpMethod": http_method,
            "httpStatusCode": 200,
            "responseBody": {
                "application/json": {
                    "body": json.dumps(body, ensure_ascii=False)
                }
            },
        },
    }


def lambda_handler(event, context):
    action_group = event.get("actionGroup", "")
    api_path = event.get("apiPath", "")
    http_method = event.get("httpMethod", "GET")
    parameters = event.get("parameters", [])
    request_body = event.get("requestBody", {})

    # パラメータをdictに変換
    params = {p["name"]: p["value"] for p in parameters}

    # リクエストボディからパラメータ取得（POSTの場合）
    if request_body:
        content = request_body.get("content", {})
        json_body = content.get("application/json", {})
        properties = json_body.get("properties", [])
        for prop in properties:
            params[prop["name"]] = prop["value"]

    if api_path == "/get-order":
        order_id = params.get("order_id", "")
        result = get_order(order_id)

    elif api_path == "/cancel-order":
        order_id = params.get("order_id", "")
        result = cancel_order(order_id)

    else:
        result = {"success": False, "message": f"不明なAPIパス: {api_path}"}

    return build_response(action_group, api_path, http_method, result)

{
  "openapi": "3.0.0",
  "info": {
    "title": "{架空の企業名} Order Management API",
    "description": "API for managing {架空の企業名} customer orders",
    "version": "1.0.0"
  },
  "paths": {
    "/get-order": {
      "get": {
        "summary": "注文状況の照会",
        "description": "注文番号を指定して注文の現在のステータス・配送状況・商品情報を取得する",
        "operationId": "getOrder",
        "parameters": [
          {
            "name": "order_id",
            "in": "query",
            "description": "照会する注文番号（例: CM-2026-000001）",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "注文情報",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": { "type": "boolean" },
                    "message": { "type": "string" },
                    "order": {
                      "type": "object",
                      "properties": {
                        "order_id": { "type": "string" },
                        "status": { "type": "string" },
                        "product": { "type": "string" },
                        "quantity": { "type": "integer" },
                        "price": { "type": "integer" },
                        "order_date": { "type": "string" },
                        "estimated_delivery": { "type": "string" },
                        "tracking_number": { "type": "string" }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/cancel-order": {
      "post": {
        "summary": "注文のキャンセル",
        "description": "注文番号を指定して注文をキャンセルする。配送中・配達完了の注文はキャンセル不可",
        "operationId": "cancelOrder",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["order_id"],
                "properties": {
                  "order_id": {
                    "type": "string",
                    "description": "キャンセルする注文番号（例: CM-2026-000002）"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "キャンセル結果",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": { "type": "boolean" },
                    "message": { "type": "string" },
                    "order_id": { "type": "string" }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}