安裝Visual Studio Code擴充

watsonx Code Assistant

建立 API 金鑰並將watsonx Code Assistant擴充功能新增至 Microsoft Visual Studio Code編輯器。

相容性

該擴充套件與 Visual Studio Code 1.101 及更新版本相容，使用 Node.js 22.15 或更新版本。

若要在 Visual Studio Code 中驗證您的 Node.js 版本，請按一下「程式碼」功能表，然後選擇「關於 Visual Studio Code」。 請確定 Node.js 的版本為 22.15 或更新版本。

不支援在開發容器中安裝擴充套件。

作業系統：

  • macOS
  • 視窗 11
  • Fedora Linux 41
  • Red Hat Enterprise Linux 8
  • Ubuntu 20.04

在IBM Cloud上建立 API 金鑰

每個開發人員都使用個人 API 金鑰來登錄，而不是使用使用者名稱和密碼。

若要建立 API 金鑰，請

  1. 登入 IBM Cloud API Keys。

    確保您使用的是 IBM Cloud 帳戶，您組織的 watsonx Code Assistant 範例是在該帳戶中配置的。

  2. 按一下建立。

  3. 輸入 IBM watsonx Code Assistant API key 作為 API 金鑰的名稱。 （可選）輸入描述。

  4. 按一下建立。

  5. 按一下 「下載」或 「複製」 並將 API 金鑰儲存在安全位置。

    此密鑰僅可用 296 秒。 存放在您稍後可以找到的地方。

安裝延伸規格

選擇您正在使用的計劃的安裝。

方案說明
方案 說明 延伸規格名稱 顯示語言支援
試行計劃 有限的免費試用版，整合生成 AI 聊天程式碼。 watsonx Code Assistant 英文 (en)，日文 (ja)，韓文 (ko)
基本計劃 針對程式碼建議、程式碼說明、程式碼文件和單元測試整合生成式 AI。 watsonx Code Assistant 英文 (en)，日文 (ja)，韓文 (ko)
標準計畫 Essentials 計劃的所有功能，加上企業 Java 現代化功能、增強代碼解釋、增強單元測試生成和檢索增強生成 (RAG)。

對於標準方案的安裝，您的 Visual Studio Code 擴充套件面板中會出現兩個項目，一個為 watsonx Code Assistant 和 watsonx Code Assistant for Enterprise Java Applications. 這兩個擴充功能是此安裝的依賴項。 需要 1.6.2 或更高版本的 watsonx Code Assistant 和 1.1.0 或更高版本的 watsonx Code Assistant for Enterprise Java Applications。		 watsonx Code Assistant for Enterprise Java Applications 僅英文 (en)

有關完整計劃的詳細信息，請參閱：

來自 Visual Studio 市集

若要從 Visual Studio Marketplace 安裝：

  1. 選擇您正在使用的計劃的安裝。

  2. 按一下「市場」頁面上的 「安裝」。

  3. 在Visual Studio Code中，按一下擴充功能上的 「安裝」。

從Visual Studio Code編輯器

若要從Visual Studio Code編輯器安裝：

  1. 在Visual Studio Code編輯器中，按一下 「擴充功能」 圖示。

  2. 選擇您正在使用的計劃的安裝：

    • 試用計劃 Essentials 計劃要安裝試用計劃和 Essentials 計劃，請搜尋 watsonx Code Assistant。
    • 標準方案 若要為標準方案安裝，請搜尋 watsonx Code Assistant for Enterprise Java Applications。

  3. 選擇您需要的擴充套件，然後按一下安裝。

打開擴充程式

開啟watsonx Code Assistant：

  1. 按一下 watsonx Code Assistantwatsonx Code Assistant 圖示。

  2. 按一下使用您的 API 金鑰登錄，然後輸入您的 IBM watsonx Code Assistant API 金鑰。

    如果您的帳戶與一個以上的 IBM Cloud 資料中心相關聯，也請選擇地點。

設定您的企業 Java 環境

標準計劃如果您使用標準計劃並希望使用企業Java應用程序，則需要設定您的環境。 有關更多信息，請參閱 設定企業Java環境。

更新 HTTP 代理設定

如果您的組織使用 HTTP 代理伺服器，您需要更新 Visual Studio Code 設定，以便它能正確連線。 當您嘗試連線而此設定遺失時，您可能會收到主控台錯誤。

  1. 在 Visual Studio Code 設定中開啟 http.proxy 設定。
  2. 輸入 HTTP 代理伺服器的 URL，格式為 https://proxy_server:port。 您可能需要包含驗證資訊，例如 http://user:pass@proxy_server:port。

設定自訂憑證的驗證

如果您的代理伺服器使用自訂憑證，您需要設定 Visual Studio Code 的驗證。 請遵循下列步驟：

匯出伺服器 SSL 憑證：

  1. 使用 Google Chrome 在 IBM Cloud 上開啟您的 watsonx Code Assistant 範例。

  2. 按一下瀏覽器中網址旁邊的檢視網站資訊圖示。

  3. 按一下連線安全，然後按一下憑證有效，以開啟憑證檢視器。

  4. 按一下詳細資料，選擇代理證書，然後按一下匯出。

設定為 MacOS:

  1. 使用 Spotlight 搜尋並開啟 Keychain Access。

  2. 按一下系統，然後按一下憑證索引標籤。

  3. 將憑證檔案拖曳到「憑證」索引標籤。

  4. 在證書上按一下滑鼠右鍵，然後按一下取得資訊。

  5. 在信任部分，將使用此憑證時設定為 Always Trust。

  6. 重新啟動擴充套件以套用變更。 您應該可以使用 API 金鑰登入。

為 Windows 設定：

  1. 開啟 Microsoft 管理主控台。

  2. 開啟憑證 (本機電腦) > Trusted Root Certification Authorities > 憑證。

  3. 右鍵按一下憑證，按一下所有任務，然後選擇匯入。

  4. 按一下詳細資料，選擇代理證書，然後按一下匯出。

  5. 重新啟動 Visual Studio Code 和 watsonx Code Assistant 擴充套件以套用變更。 您應該可以使用 API 金鑰登入。

保護您的設置

IBM watsonx Code Assistant 不提供額外的安全控制。 使用這些步驟來正確保護您的設定。

您的Visual Studio Code環境

套用所有 Visual Studio Code 更新，以協助確保您擁有最新的安全性和錯誤修正。 有關詳細信息，請參閱 Microsoft 文件。

watsonx Code Assistant擴充日誌儲存在 <your home directory>/.wca 下的 *.log 檔案中。 除了檔案系統提供的加密之外，這些檔案未加密。 保護日誌免遭不當存取。

聊天對話存儲

IBM watsonx Code Assistant 將您所有的聊天對話記錄本機儲存於您的檔案系統，資料庫格式由 <your home directory>/.wca/chat.dbSQLiteIBM watsonx Code Assistant _不會_與任何人分享這些對話。 除了檔案系統提供的加密之外，該檔案未加密。 保護此文件免遭不當存取。

遙測資料

IBM watsonx Code Assistant_不_收集任何遙測資料。 一般來說，watsonx Code Assistant不會將其處理的任何資料傳送給第三方（包括IBM。

登出您的 API 金鑰

如有必要，您可以登出您的 API 金鑰。 登出並重新輸入您的 API 金鑰可能有助於解決您遇到的任何驗證問題。

註銷：

  1. 在Visual Studio Code中，按一下 「帳戶」 圖示。

  2. 按一下「您的姓名（WCA API 金鑰）」 設置，然後按一下「登出」。

使用「輸出」檢視查看活動詳細資訊

您可以使用 Visual Studio Code 的輸出檢視來查看有關擴充功能正在執行的操作和日誌記錄的詳細信息，並檢查是否有任何錯誤。

若要開啟「輸出」檢視，請

  1. 在 Visual Studio Code 中，按一下「檢視」，然後按一下「輸出」。

  2. 在 Output 檢視中，使用下拉清單選擇 WCA 或 WCA Language Server。 兩者都提供了有關擴展程序正在執行的操作的更多詳細資訊。

若要調整 Visual Studio Code 擴充的輸出檢視和日誌記錄：

  1. 在 Visual Studio Code 中，開啟 watsonx Code Assistant 的擴充設定。

  2. 在 Wca: Log level 中，從預設值切換 INFO 到另一個設置，例如 WARN。

停用或卸載擴充套件

如有必要，您可以停用該擴充功能並保留其安裝，也可以將其完全卸載。

若要停用或卸載擴充功能：

  1. 在Visual Studio Code中，按一下 「擴充功能」 圖示以開啟面板。

  2. 點選 watsonx Code Assistant 副檔名。

  3. 按一下 「停用」 或 「卸載」。

變更顯示語言

watsonx Code Assistant 擴充套件有英文版 (en)、日文版 (ja) 和韓文版 (ko)。

watsonx Code Assistant for Enterprise Java Applications 擴充套件只有英文版 (en)。

若要變更顯示語言：

  1. 在 Visual Studio Code 中，按一下檢視，然後按一下指令調板。

  2. 搜尋 display，然後按一下設定顯示語言。

  3. 選擇英文 (en)、日文 (ja) 或韓文 (ko)。

如需詳細資訊，請參閱 Visual Studio Code 文件中的 顯示語言。