Crescendo Lab 文件
正體中文
註冊開始用

專案設定

在專案的「設定」調整通訊埠、請求最長時間、機敏值和存取權,或暫停、移除專案。

最後更新

通訊埠#

平台依下列順序決定網頁服務的通訊埠,並用環境變數 PORT 告訴你的程式:

  1. 「設定 › 執行設定 › 通訊埠」有填,就用它。
  2. 沒填,就用映像檔 EXPOSE 的那一個 TCP 通訊埠。
  3. 兩者都沒有,就用 8080。

請求最長時間#

每個送到網頁服務的請求都有時限,沒調整過就是 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 檔上傳機敏值。

套用設定#

設定要等服務重新啟動才會生效。你有重新啟動服務的權限、而且有版本正在執行時,存檔按鈕會是「儲存並重新啟動」。按下去會先跳出確認:執行個體會一個一個換新,新的就緒前舊的會繼續服務,但 /tmp 裡的檔案會清空,如果資料庫跑在映像檔裡,裡面的資料也會不見。確認之前什麼都不會存。移除變數或機敏值也一樣,確認視窗會說明服務會重新啟動,按鈕是「移除並重新啟動」。

沒辦法順便重新啟動的時候,例如你沒有重新啟動服務的權限,或目前沒有東西在執行,按鈕就只是「儲存」。變更會先存起來等著:總覽會提示設定已變更,等有人按「重新啟動服務」,或下一個版本上線時才會套用。

透過 MCP 連接的 AI 工具只會存檔。sites_runtime_settings_update 不會重新啟動服務,重新啟動是另一個工具 sites_restart。

暫停、移除與永久刪除#

動作會發生什麼能不能復原
暫停專案專案下線,訪客看到中性頁面。所有內容都保留,暫停期間不能部署新版本。可以,按「恢復專案」。
移除專案專案立刻下線,開始 7 天的寬限期。7 天內可以還原,之後版本會被刪除。
永久刪除所有版本和網址立刻刪除,要輸入專案名稱確認。不能。網址也不會再給任何人。