GET /v1/models から取得したモデル選択欄と、POST /v1/responses からの回答を持つローカルのチャットページができます。
このサンプルは例示用です。ルートにはサインインもレート制限もないため、ルートにアクセスできる人は誰でもあなたのキーを使って支出できます。先にデプロイする前にのチェックを追加してください。
コーディングエージェントに同じアプリを一から作らせるには、次のプロンプトを貼り付けます。
Phaseo Gateway 上に Next.js のウェブチャットアプリ を作成します。
サンプルの構成
サンプルは examples/web-chat-nextjs にあります。実行する
Node.js と Phaseo の API キーが必要です。1
インストールする
package-lock.json が含まれているため、npm はテスト済みのバージョンをインストールします。2
.env.local を作成する
サンプルには ここでは
.env.example がありません。.env.local を自分で作成します。.env.local
NEXT_PUBLIC_GATEWAY_URL はサーバー側でしか読み取られませんが、NEXT_PUBLIC_ という接頭辞が付いた変数はブラウザーのコードに公開されるため、キーは絶対に入れないでください。省略可能な 2 つのヘッダーについてはアプリのアトリビューションで説明しています。3
2 回目のチャットターンを修正する
ChatClient.tsx は、前の回答の id を previous_response_id として送信します。Gateway はレスポンスを保存しないため、このフィールドを 400 validation_error(キーワード unsupported_param)で拒否し、2 通目のメッセージは失敗します。app/api/responses/route.ts で、previous_response_id をペイロードにコピーするブロックを削除します。app/api/responses/route.ts
input で送信してください。4
開発サーバーを起動する
http://localhost:3000 を開きます。動作を確認する
- モデル選択欄にモデル ID が入ります。
- 続けて送った 2 通のメッセージの両方に回答が返ります。
- ブラウザーのネットワークパネルで、リクエストの送信先は
/api/modelsと/api/responsesだけで、PHASEO_API_KEYを含むリクエストはありません。 - 不正なモデル ID を指定すると、空の回答ではなく Gateway のエラーメッセージが表示されます。
- リクエストは、設定したアプリのタイトルとともに 設定 → 利用状況 → ログ に表示されます。
デプロイする前に
- ルートを認証する。
/api/responsesと/api/modelsでサインイン済みのユーザーを必須にするか、OAuth ワークベンチを使って各ユーザーが自分のクレジットを使うようにしてください。 - モデルを許可リストで制限する。 ルートはブラウザーから届いた任意の
model文字列を転送します。サーバー側で固定のリストと照合してください。 - 入力とリクエスト頻度に上限を設ける。 入力の長さとユーザーごとのリクエスト数を制限し、キーに支出上限を設定してください。
- 必要ならストリーミングする。
stream: trueを設定してイベントを転送します。Responses のストリームを終了させるイベントはストリーミングで説明しています。