Amazon Echo × Claude — 技術解説編

1. はじめに #

この記事は 構築編 の続編で、システムの技術的な背景と設計上の判断をまとめている。環境構築の手順については構築編を参照してほしい。

扱う内容は以下のとおり。

• 2. 構成要素の解説 — 技術スタック・リクエストフロー・ファイル構成・主要な設計ポイント
• 3. 比較検討したこと — Cloudflare Workers を採用した理由・実装言語の選定・セキュリティ手法の比較
• 4. 参考 — 参考リンク

2. 構成要素の解説 #

2-1. 技術スタック #

2-2. リクエストフロー #

図中の TTS Conversion (Text-to-Speech) は、Alexa Skills Kit がテキスト形式のレスポンスを受け取り、Echo デバイスが再生できる音声データに変換するステップ。ユーザーが Echo から聞く読み上げ音声はここで生成される。

2-3. ファイル構成 #

alexa-claude/
└── worker/
    └── alexa-claude-worker/
        ├── src/
        │   └── index.ts        ← Worker のメインコード
        ├── wrangler.jsonc       ← Wrangler 設定(ALEXA_APP_ID を記入する)
        ├── tsconfig.json
        ├── worker-configuration.d.ts
        ├── package.json
        ├── .dev.vars           ← ローカル用シークレット(git 除外)
        └── .gitignore

2-4. 主要な設計ポイント #

Alexa の 8 秒タイムアウト対策

Alexa はエンドポイントから 8 秒以内にレスポンスが返らない場合、タイムアウトエラーをユーザーに返す。Anthropic API の応答は通常 2〜5 秒だが、余裕を持たせるために 6 秒でキャンセルし、残り 2 秒でエラーメッセージを返す設計にしている。

Cloudflare Workers 無料枠と CPU 時間

Workers の無料枠は 1 リクエストあたり CPU 時間 10ms という制限があるが、fetch() による外部 API 呼び出しの待機時間(I/O)は CPU 時間にカウントされない。このシステムの実質的な CPU 使用は JSON の解析と組み立てのみで、1 リクエストあたり約 1ms 以下に収まる。

セキュリティ

開発者モード(自分のみ利用)かつ URL を公開しない前提で、以下の 2 層を実装している。

会話履歴の保持

直近 5 往復(10 メッセージ)を Alexa セッションの属性(SessionAttributes)に保持し、Anthropic API へのリクエストに含めて渡す。セッションを終了すると履歴はリセットされる。

3. 比較検討したこと #

3-1. Alexa-hosted ではなく Cloudflare Workers を採用した理由 #

Alexa カスタムスキルのバックエンドは、Amazon が管理する Alexa-hosted (Node.js) と、自分で用意する カスタムエンドポイント(Lambda・Cloudflare Workers など)の2種類から選べる。Alexa Developer Console では Alexa-hosted の導入が手軽だが、今回はコールドスタートの問題から採用しなかった。以下に比較をまとめる。

3-2. Cloudflare Workers の実装言語の選定 #

Cloudflare Workers は複数の言語をサポートしているが、TypeScript(JavaScript)を採用した。

Python は Pyodide の初期化だけで 1 秒以上かかり、Alexa の 8 秒制限に対して現実的でない。Rust・Go などの WASM 言語は V8 環境とのメモリ空間が分離されているため、マーシャリングが発生し、今回のような I/O 中心のワークロードでは逆に遅くなる。

3-3. セキュリティ手法の比較 #

今回のスキルの実装では Cloudflare Workers の *.workers.dev ドメインにデプロイしている。

今回はドメイン取得・維持費用を発生させずに動作させることを目標としているため、独自ドメインの取得が前提となる手法は除外している。その条件のもとで適用できる追加のセキュリティ手法を検討した。

いずれも今回の環境・用途には合わず不採用とした。個人・非公開利用であれば、2-4 節で実装したアプリケーション ID ＋ タイムスタンプ検証の2層で十分な防御が得られる。

独自ドメインを Cloudflare で管理している場合は、WAF・Rate Limiting をダッシュボードから追加してセキュリティをさらに強化できる。

4. 参考 #

• Alexa Skills Kit 公式ドキュメント
• Cloudflare Workers ドキュメント
• Anthropic API ドキュメント
• github.com/yamk/alexa-claude(ソースコード)