チュートリアル

Alpenglowデモショップを使った、最初のリクエストからエージェントやCIまでの、ステップごとのレッスン。

各チュートリアルでは、1つの作業を最初から最後まで進めます。すべて、架空のアウトドア用品店Alpenglowを使います。https://demo.echolot.devのデモAPIと、あらゆる種類のリクエストがすでに入っているサンプルワークスペースです。必要なものは、macOS 15以降のAppleシリコンを搭載したMacで動くEcholotです。デモに送信した内容は保存されません。

Alpenglowワークスペース

ほとんどのチュートリアルは、自分でワークスペースを作るか、Alpenglowから始めます。入手方法は次のとおりです。

Alpenglow.echolot.zipをダウンロードします。
Finderでzipをダブルクリックして展開します。Alpenglow.echolotができます。
Alpenglow.echolotをダブルクリックします。Echolotがワークスペースのウインドウで開きます。ファイル › ワークスペースを開く…（⌘O）で選んで開くこともできます。

Alpenglowは環境なしを選んだ状態で動作します。ワークスペースの変数がデモAPIを指しているためです。内容は次のとおりです。

フォルダ	内容
Auth	アクセストークンをシークレット変数`{{token}}`に保存するSign in、Who am I、Orders with OAuth 2
Catalog	List products、Search、Get product、Categories、GraphQLリクエストのSearch products、Export the catalog（14 MB）
Orders	List orders、Create order、Get order、Cancel order。すべて、フォルダのBearer認証でトークンを送信します
Realtime	Order updates（WebSocket）、Order events（Server-Sent Events）、Support chat（Socket.IO）、Warehouse sensors（MQTT）
Inventory	gRPC呼び出し3つ：List warehouses、Watch stock、Reserve stock
Agent tools	Alpenglow MCPサーバへのMCPリクエスト2つ：search_catalogとorder_status
Echo	`/echo`エンドポイントへのリクエスト：送信した内容、ステータス、リダイレクト、Basic認証、Cookie、XML、HTML

ほかに、3つの環境（Local、Staging、保護されたProduction。StagingとProductionは架空のアドレスです）、3つのフロー（Place a test order、Morning stock check、Order status on webhook）、MCPサーバAlpenglow MCP、仕様のalpenglow.yaml、shop.graphql、inventory.protoがあります。

サイドバーにフォルダが並んだAlpenglowワークスペースと、開いているCatalog › List products

gRPC、Socket.IO、MQTT用のサーバをMacで動かす

デモAPIは、gRPC、Socket.IO、MQTTを提供できません。これらのための小さなサーバが、ドキュメントのリポジトリのexamples/serversにあります。Bunが必要で、待ち受けるのはお使いのMacだけです。

git clone https://github.com/staticdreams/echolot-docs.git
cd echolot-docs/examples/servers
bun install
bun run realtime   # Socket.IO on http://localhost:3001 (namespace /support), MQTT on mqtt://localhost:1883
bun run grpc       # the Inventory service on localhost:50051 (in a second Terminal window)

AlpenglowのSupport chat、Warehouse sensors、Inventoryリクエストは、すでにこれらのアドレスを指しています。サーバはControl-Cで止めます。