Visual Studio Code用拡張機能のインストール

watsonx Code Assistant

APIキーを作成し、MicrosoftVisual Studio Codeエディタにwatsonx Code Assistantエクステンションを追加します。

互換性

この拡張機能は、 Visual Studio Code 1.101 以降と互換性があり、 Node.js バージョン 22.15 以降を使用します。

Visual Studio Code で Node.js のバージョンを確認するには、 Code メニューをクリックし、 About Visual Studio Code を選択します。 Node.js のバージョンが 22.15 以降であることを確認してください。

開発用コンテナへの拡張機能のインストールはサポートされていません。

オペレーティング・システム:

macOS
Windows 11
Fedora Linux 41
Red Hat Enterprise Linux 8
Ubuntu 20.04

IBM CloudでAPIキーを作成する

ユーザー名とパスワードの代わりに、各開発者は個人のAPIキーを使ってログインする。

APIキーを作成する：

IBM Cloud API キーにログインします。

watsonx Code Assistant の組織インスタンスがプロビジョニングされている IBM Cloud アカウントを使用していることを確認してください。
「作成」 をクリックします。
APIキーの名前として'IBM watsonx Code Assistant API key を入力します。オプションで、説明を入力します。
「作成」 をクリックします。
ダウンロード] または[コピー] をクリックし、APIキーを安全な場所に保管してください。

キーは296秒間しか使用できない。後で見つけられる場所に保管する。

拡張機能のインストール

ご利用のプランのインストールを選択してください。

プランの説明
プラン	説明	拡張名	表示言語サポート
試行計画	コードのための統合されたジェネレーティブAIチャットの限定無料トライアル。	watsonx Code Assistant	英語 (`en`)、日本語 (`ja`)、韓国語 (`ko`)
エッセンシャル・プラン	コード提案、コード説明、コード文書化、ユニットテストのための統合された生成AI。	watsonx Code Assistant	英語 (`en`)、日本語 (`ja`)、韓国語 (`ko`)
標準プラン	Essentialsプランの全機能に加え、エンタープライズ Java モダナイゼーション機能、強化されたコード説明、強化されたユニットテスト生成、および検索拡張生成（RAG）を提供します。スタンダード・プランのインストールでは、 Visual Studio Code 拡張機能パネルに2つのエントリーが表示されます。 watsonx Code Assistant と watsonx Code Assistant for Enterprise Java Applications. この2つの拡張機能は、このインストールに依存する。 watsonx Code Assistant のバージョン 1.6.2 以降と watsonx Code Assistant for Enterprise Java Applications のバージョン 1.1.0 以降が必要。	watsonx Code Assistant for Enterprise Java Applications	英語 (`en`) のみ

プランの詳細については、こちらをご覧ください：

Visual Studio Marketplaceから

Visual Studio Marketplaceからインストールする：

ご利用のプランのインストールを選択してください。
- トライアルプランエッセンシャルプラントライアルプランとエッセンシャルプランをインストールするには、Visual Studio Marketplaceのwatsonx Code Assistantページを開きます。
- 標準プラン標準プランでインストールするには、Visual Studio Marketplaceのwatsonx Code Assistant for Enterprise Java Applicationsページを開きます。
マーケットプレイスのページでインストールをクリックします。
Visual Studio Codeで、拡張機能のインストールをクリックします。

Visual Studio Codeエディターから

Visual Studio Codeエディターからインストールするには

Visual Studio Codeエディターで、Extensions アイコンをクリックします。
ご利用のプランのインストールを選択してください：
- トライアルプランエッセンシャルプラントライアルプランとエッセンシャルプランをインストールするには、「watsonx Code Assistant」を検索します。
- スタンダードプランスタンダードプランをインストールするには、 watsonx Code Assistant for Enterprise Java Applications を検索します。
必要な拡張機能を選択し、 インストールをクリックします。

エクステンションを開く

watsonx Code Assistantを開く：

アイコンをクリックする。 watsonx Code Assistant ンをクリックする。
Log in with your API keyをクリックし、 IBM watsonx Code Assistant APIキーを入力します。

アカウントが複数の IBM Cloud データセンターに関連付けられている場合は、場所も選択してください。

エンタープライズ Java 環境のセットアップ

スタンダード・プランスタンダード・プランを使用していて、エンタープライズJavaアプリケーションを使用したい場合は、環境をセットアップする必要があります。詳細については、エンタープライズJava環境のセットアップを参照してください。

HTTP プロキシ設定の更新

お客様の組織で HTTP プロキシサーバーを使用している場合は、 Visual Studio Code 設定を更新して、正しく接続できるようにする必要があります。接続しようとした際にコンソールエラーが表示される場合があります。この設定が欠落している場合です。

http.proxy の設定を Visual Studio Code の設定で開きます。
HTTP プロキシサーバーの URL を https://proxy_server:port の形式で入力してください。 http://user:pass@proxy_server:port のような認証情報を含める必要があるかもしれません。

カスタム証明書の検証設定

プロキシサーバーがカスタム証明書を使用している場合は、 Visual Studio Code の検証を設定する必要があります。以下の手順を実行します。

サーバーSSL証明書をエクスポートするには

watsonx Code Assistant のインスタンスを IBM Cloud で開くには、 Google Chrome を使用します。
ブラウザのウェブアドレスの横にある「 サイト情報を見る 」アイコンをクリックします。
接続は安全です ]をクリックし、[ 証明書は有効です] をクリックして証明書ビューアを開きます。
Details] をクリックし、プロキシの証明書を選択し、[ Export ]をクリックする。

を設定する MacOS:

Spotlightを使ってKeychain Accessを検索し、開く。
システム」をクリックし、「 証明書」タブをクリックします。
証明書ファイルを証明書タブにドラッグします。
証明書を右クリックし、「 情報を取得 」をクリックします。
Trust] セクションで、[ When using this certificate ] を Always Trust に設定する。
変更を適用するには、拡張機能を再起動します。 APIキーを使ってログインできるはずです。

Windows用に設定する：

Microsoft 管理コンソールを開きます。
証明書（ローカルコンピュータ） ＞ 信頼されたルート認証局 ＞ 証明書を開く。
証明書]を右クリックし、[ すべてのタスク] をクリックし、[ インポート] を選択する。
Details] をクリックし、プロキシの証明書を選択し、[ Export ]をクリックする。
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.db、 SQLite で定義されたデータベース形式です。 IBM watsonx Code Assistant はこれらの会話を誰とも共有し_ません_。このファイルは、ファイルシステムが提供する暗号化以外には、暗号化されていません。このファイルを不正アクセスから保護する。

テレメトリー・データ

IBM watsonx Code Assistantは遠隔測定データを収集_しない_。一般的に、watsonx Code Assistantは、IBMて、処理するデータを第三者に送信しない。

APIキーのログアウト

必要に応じて、APIキーからログアウトすることができます。ログアウトしてから再度APIキーを入力すると、認証に関する問題が解決する場合があります。

ログアウトする：

Visual Studio Code で Accounts アイコンをクリックします。
Your Name (WCA API Key)] 設定をクリックし、[Sign out] をクリックします。

アウトプットのビューを使ってアクティビティの詳細を見る

Visual Studio Codeの Outputビューを使用すると、拡張機能の動作やログの詳細を確認したり、エラーをチェックしたりできます。

出力ビューを開くには

Visual Studio Codeの［表示］をクリックし、［出力］をクリックします。
Outputビューで、ドロップダウンリストを使用して WCA または WCA Language Serverを選択します。どちらも、エクステンションが何をしているのか、より詳しく説明している。

Visual Studio Code 拡張機能の出力ビューとロギングを調整します：

Visual Studio Codeで、 watsonx Code Assistantの拡張設定を開きます。
Wca：ログ・レベル ]で、デフォルトの INFO から、 WARN などの別の設定に切り替えます。

拡張機能の無効化またはアンインストール

必要であれば、拡張機能を無効にしてインストールしたままにするか、完全にアンインストールすることができます。

拡張機能を無効化またはアンインストールするには

Visual Studio Codeで、拡張機能アイコンをクリックしてパネルを開きます。
拡張子 watsonx Code Assistant をクリックします。
無効化またはアンインストールをクリックします。

表示言語の変更

watsonx Code Assistant 拡張モジュールは、英語 (en)、日本語 (ja)、韓国語 (ko) で利用できる。

watsonx Code Assistant for Enterprise Java Applications 拡張機能は英語版のみ (en) です。

表示言語を変更するには

Visual Studio Code で、[ 表示] をクリックし、[ コマンドパレット ]をクリックする。
display を検索し、 Configure Display Language をクリックします。
英語(en)、日本語(ja)、韓国語(ko)のいずれかを選択してください。

詳細については、 Visual Studio Code ドキュメントの「表示言語」を参照。