排解 Colab Enterprise 問題
本頁面說明如何解決 Colab Enterprise 的問題。
無法存取 Colab Enterprise
嘗試在 Google Cloud 控制台中存取 Colab Enterprise 時，會發生下列錯誤：
Authentication error: 7; Error Details: User not allowed to access service.
Google Workspace 設定「無個別控制項的額外服務」已關閉。
如要解決這個問題，請將「無個別控制項的其他服務存取權」設為「開啟」。
無法連線至執行階段
造成這個問題的原因有很多，另請參閱「無法連線至預設執行階段」。最常見的原因如下：
瀏覽器封鎖第三方 Cookie
您使用的瀏覽器封鎖了第三方 Cookie，而 Colab Enterprise 會使用這類 Cookie 與執行階段建立 HTTPS 連線。
如要解決這個問題，請將瀏覽器設定為允許來自網域 DATALAB_TUNNEL_TOKEN*.aiplatform-notebook.googleusercontent.com 的第三方 Cookie。
網路會封鎖筆記本網域的出埠流量
您網路的防火牆規則會封鎖傳出流量，使其無法連至 *.aiplatform-notebook.cloud.google.com 或 *aiplatform.googleapis.com。
如要解決這個問題，請設定網路的防火牆規則，允許傳出流量到 *.aiplatform-notebook.cloud.google.com 和 *aiplatform.googleapis.com。
無法連線至預設執行階段
當您嘗試連線至預設執行階段，但沒有現有的預設執行階段範本時，就會發生下列錯誤：
Failed to connect to runtime
連線至尚未建立的預設執行階段時，Colab Enterprise 會先建立預設執行階段範本，然後使用該範本產生預設執行階段。不過，如果您沒有建立執行階段範本的必要權限，Colab Enterprise 就無法建立預設執行階段範本和預設執行階段。
如要解決這個問題，請管理員授予您具備 aiplatform.notebookRuntimeTemplates.create 權限的角色。
筆記本連線至執行階段的速度緩慢
開始連線至執行階段幾分鐘後，筆記本右上角仍顯示 Connecting 訊息，且 Colab Enterprise 尚未連線至執行階段。
如要解決這個問題，請再等幾分鐘。Colab Enterprise 仍在連線至執行階段。連線至尚未執行的執行階段可能需要幾分鐘，因為 Vertex AI 會配置新的虛擬機器 (VM) 執行個體。
無法建立執行階段
如果無法建立執行階段，就會發生這個問題。另請參閱「無法建立預設執行階段」。最常見的原因如下：
配額不足
如果無法建立執行階段，可能是因為您已超過 Compute Engine 執行階段配額。
Colab Enterprise 會使用 Compute Engine 配額做為執行階段。詳情請參閱 Compute Engine 配額與限制總覽。
如要解決這個問題，請要求調整配額。
無法使用的資源
嘗試建立執行階段時發生下列錯誤。
No available zone found for runtime RUNTIME_ID for machine type MACHINE_TYPE with accelerator type: ACCELERATOR. Please try again later.
如果筆記本所在區域沒有可用的機器類型設定資源，就會發生這項錯誤。
如要解決這個問題，請嘗試下列任一方法：
- 在其他區域建立執行階段。
- 建立具有不同機器類型設定的執行階段範本，然後根據新的執行階段範本建立執行階段。
執行階段範本和預訂設定不符
嘗試建立執行階段時，發生類似下列的錯誤。
Failed to create notebook runtime with error: Invalid value for field
'resource.reservationAffinity': '{"consumeReservationType":
"SPECIFIC_ALLOCATION", "key": "compute.googleapis.com/reservation-name...'.
No available resources in specified reservations.
如果預留項目的 VM 屬性與 Colab Enterprise 執行階段不符，就會發生這項錯誤。舉例來說，如果預留項目指定 e2-standard-8 機器類型，則 Colab Enterprise 執行階段也必須使用 e2-standard-8 機器類型，才能使用預留項目。詳情請參閱「需求條件」。
如要解決這個問題，請建立執行階段範本，並設定與保留項目 VM 屬性相符的設定。
Colab Enterprise 無法建立執行階段範本
本節說明如何解決建立執行階段範本時發生的問題。
無法選取足夠的 GPU
建立執行階段範本時，您無法選取所需的 GPU 數量。這可能是因為配額不足。
Colab Enterprise 會使用 GPU 的 Compute Engine 配額。詳情請參閱 Compute Engine 配額與限制總覽。
如要解決這個問題，請要求調整配額。
預設執行階段已存在
如果預設執行階段已存在，嘗試從預設執行階段範本建立執行階段時，會發生下列錯誤：
Failed to create runtime One click runtime already exists.
如果您嘗試從預設執行階段範本建立執行階段，Colab Enterprise 會嘗試建立預設執行階段。每個使用者、專案和區域只能有一個預設執行階段。如果預設執行階段已存在，Colab Enterprise 就無法建立其他預設執行階段。
如要解決這個問題，請連線至現有的預設執行階段，或使用非預設執行階段範本建立執行階段。
無法建立預設執行階段
Colab Enterprise 建立預設執行階段時，會先建立預設執行階段範本，再使用該範本產生預設執行階段。如果您嘗試建立預設執行階段，但沒有建立執行階段範本所需的權限，Colab Enterprise 就無法建立預設執行階段。
如要解決這個問題，請管理員授予您具備 aiplatform.notebookRuntimeTemplates.create 權限的角色。
執行程式碼時找不到使用者憑證
如果您嘗試在筆記本中執行與 Google Cloud 服務和 API 互動的程式碼，但尚未授予 Colab Enterprise 存取使用者憑證的權限，就會發生這個問題。
錯誤訊息可能如下所示：
Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential
DefaultCredentialsError: Your default credentials were not found.
以下是這個問題的常見原因和解決方法：
-
您未完成首次連線至啟用使用者憑證的執行階段時，系統顯示的「登入」對話方塊。完成這個對話方塊後，您即授予 Colab Enterprise 存取使用者憑證的權限。
如要解決這個問題，請嘗試重新連線至執行階段並授予存取權。
如要驗證存取權是否已授予：
-
依序點選「帳戶」>「受管理 Google 帳戶」>「資料和隱私權」>「第三方應用程式和服務」。
-
確認 Colab Enterprise 是否列在其中。
-
-
首次連線至已啟用使用者憑證的執行階段時，系統會顯示「登入」對話方塊 (同意畫面)，但您未選取使用者帳戶，因此 Colab Enterprise 無法存取您的使用者憑證。
如何解決這個問題：
-
在 Google Cloud 控制台中，按一下帳戶個人資料圖片，然後點選「Google 帳戶」。
-
按一下「資料和隱私權」。
-
在「您在應用程式和服務中的資料」中，按一下「第三方應用程式和服務」。
-
按一下「Colab Enterprise」。
-
在「Colab Enterprise 有權存取您 Google 帳戶中的部分資料」下方，按一下「查看詳細資料」。
-
按一下 [移除存取權]。
-
按一下「確認」。
這會移除目前的存取權設定。
-
下次連線至已啟用使用者憑證的執行階段時，請務必在完成「登入」對話方塊時選取正確的使用者帳戶。
-
-
彈出式視窗封鎖工具可能會導致 Colab Enterprise「登入」對話方塊 (同意畫面) 無法顯示。
如要解決這個問題，請暫時啟用瀏覽器的彈出式視窗，然後再次嘗試連線至執行階段。
-
Google Workspace 的額外服務已關閉 Colab。
如要解決這個問題，請在 Google Workspace 中啟用 Colab 服務。
雖然這項異動是指 Colab，但也會影響 Colab Enterprise。
Colab 應為所有人啟用。
-
企業服務限制可能會封鎖 Colab Enterprise 的存取權。
如要找出問題，請 確認貴機構的服務限制並未封鎖 Google 服務存取權。
「服務狀態」應為「為所有人啟用」。
-
您使用的執行階段未啟用使用者憑證，且您尚未透過 Google Cloud CLI 將使用者憑證提供給應用程式預設憑證 (ADC)。
如要解決這個問題，請參閱在筆記本中執行程式碼，向 ADC 提供使用者憑證。
Gemini 功能無法運作
在 Colab Enterprise 筆記本中輸入內容時，系統不會顯示程式碼完成建議。 或者，程式碼儲存格上方未顯示 pen_spark「幫我寫程式碼」按鈕。
您可能已在 Colab Enterprise 設定中關閉「顯示依據相關資訊提供的程式碼完成建議」設定。
如要解決這個問題，請按照下列步驟操作：
- 按一下「切換標題顯示設定」。
- 按一下「工具」選單中的「設定」。
- 按一下「編輯器」。
- 選取「顯示依據相關資訊提供的程式碼完成建議」。
- 按一下 [儲存]。