プロジェクトの設定
プロジェクトの「設定」で、ポート、リクエストの最大時間、シークレット、アクセスを変更したり、プロジェクトを一時停止・削除したりします。
ポート#
プラットフォームは次の順でWeb サービスのポートを決め、環境変数 PORT でプログラムに渡します。
- 「設定 › 実行設定 › ポート」に値があれば、それを使います。
- なければ、イメージが
EXPOSEしている 1 つの TCP ポートを使います。 - どちらもなければ
8080を使います。
リクエストの最大時間#
Web サービスへのリクエストには時間の上限があり、変更しなければ 30 秒です。上限はレスポンス全体にかかり、ストリーミング(server-sent events、生成しながら送る LLM の回答)も含みます。延ばすには「設定 › コンピューティング › リクエストの最大時間(秒)」で、プランの上限まで(欄に最大値が表示されます)設定し、サービスを再起動します。この設定はコンソールでのみ変更でき、MCP で接続した AI ツールからは変更できません。
リクエストが上限に達したとき:
| タイミング | 呼び出し側が受け取るもの |
|---|---|
| サービスがレスポンスヘッダーを送る前 | 504。ヘッダー X-AgentLab-Error: platform-timeout、本文は {"error":"platform_request_timeout","timeoutSeconds":30,"retry":false} |
| 送信が始まった後(ストリーミング中) | 接続が閉じられ、レスポンスはそこで止まります。送信中のレスポンスにエラーは追加できません。 |
X-AgentLab-Error のない 504 は、プラットフォームではなくお使いのサービス自身が返したものです。
タイムアウトしたリクエストを再送しないでください
上限で切れるのは接続であり、処理そのものとは限りません。サービスはまだそのリクエストを処理し、モデルの料金も発生している可能性があります。再送すると同じ処理が二重に行われることがあるため、本文は "retry": false になっています。上限より長い処理は、すぐに応答するリクエストで開始し、結果は呼び出し側が後から取りに行く形にしてください。
シークレット#
シークレットは API キーやトークンなどの機密値です。コンソールで入力し、コードからは環境変数として読み取ります。シークレットは環境ごとに分かれます。
保存したシークレットの値は、誰にも再表示されません。各シークレットには、誰がいつ設定したかが表示されます。Agent Lab が生成したもの、またはデータベースやキャッシュの接続時に設定したものには、誰の操作によるものかが表示されます。「稼働中のサービスで使用中」は反映済み、「サービスの再起動後に反映されます」は再起動を待っている状態です。
シークレットを会話に貼らない
シークレットの値をコマンドに書いたり、AI ツールとの会話に貼ったりしないでください。値がすでに .env ファイルにある場合は、AI ツールが値を見ずにそのファイルをプラットフォームへ直接送れます。.env ファイルからシークレットをアップロードするを参照してください。
設定を反映する#
設定はサービスの再起動で反映されます。サービスを再起動できる権限があり、バージョンが稼働しているときは、保存ボタンが「保存して再起動」になります。押すと先に確認が表示されます。インスタンスは 1 つずつ入れ替わり、新しいインスタンスの準備ができるまで古いインスタンスが配信を続けますが、/tmp のファイルは消え、イメージ内で動かしているデータベースのデータも消えます。確認するまでは何も保存されません。変数やシークレットを削除するときも同じで、確認にサービスが再起動することが書かれ、ボタンは「削除して再起動」になります。
再起動できない場合(再起動の権限がない、または何も稼働していない)は、ボタンは「保存」です。変更は保存されて待機します。概要に設定が変わったことが表示され、誰かが「サービスを再起動」を選ぶか、次のバージョンが公開されたときに反映されます。
MCP で接続した AI ツールは保存だけを行います。sites_runtime_settings_update はサービスを再起動せず、再起動は別のツール sites_restart で行います。
一時停止、削除、完全削除#
| 操作 | どうなるか | 元に戻せるか |
|---|---|---|
| プロジェクトを一時停止 | プロジェクトがオフラインになり、訪問者には中立的なページが表示されます。内容はすべて保持され、停止中は新しいバージョンをデプロイできません。 | はい。「プロジェクトを再開」を選びます。 |
| プロジェクトを削除 | プロジェクトはすぐにオフラインになり、7 日間の猶予期間が始まります。 | 7 日以内なら復元できます。その後バージョンは削除されます。 |
| 完全に削除 | すべてのバージョンとアドレスがすぐに削除されます。プロジェクト名を入力して確定します。 | いいえ。アドレスが他の誰かに割り当てられることもありません。 |