コードの提案を得る

チャットとエディタ間のコード転送

使用したいコードの提案を受け取ったら、チャットからコードブロックをエディタに挿入することができます。

1. エディタにカーソルを置きます。
2. チャットで、 Insert at cursor アイコンをクリックする。

チャットでコンテキストとして使用したいコードがエディタにある場合、そのコードをチャットにコピーすることができます。

1. エディタでコードをハイライトします。
2. 右クリックでポップアップメニューを表示します。
3. 選択する watsonx Code Assistant。
4. 「選択したコードをチャットに追加 」を選択します。

自然言語の使用

各チャットメッセージはチャット会話の一部です。 会話は特定のテーマやタスクに集中させる。 コンテキストを別のプログラミング言語、ワークスペース内の別のプロジェクト、または別のプログラミングタスクに切り替えるときは、新しいチャット会話を作成します。 あなたの質問に対して、より適切な結果を得ることができます。

例：

• Create a Python class Customer. Include attributes for firstName, lastName and age.
• Create a JavaScript function that fetches data from a REST API endpoint, dynamically populates an HTML table with the results, and updates the UI asynchronously

プロンプト・ライブラリの使用

Watsonx Code Assistantには、一般的な自然言語によるコーディング要求のセットを含むプロンプト ライブラリが含まれています。 チャットにそのまま使用することもできますし、使用するケースに合わせて変更することもできます。

プロンプトライブラリーにアクセスするには

1. メニューを開く アイコンをクリックする。
2. プロンプトライブラリをクリックして開く。
3. クリップボードにコピー アイコンをクリックします。
4. もう一度「プロンプトライブラリ」をクリックして閉じる。
5. プロンプトをチャットに貼り付ける。

効果的なチャットメッセージの書き方

会話に最高の結果をもたらすために：

• チャットメッセージは英語で書いてください。
• シンプルで明確な指示から始める。
• 後続のチャットメッセージを使って、モデルのコード出力を改良する。
• 各ステップについて、できるだけ具体的かつ詳細に説明すること。 作成したコードは、その後のチャットメッセージを通じて徐々に強化することができます。
• 関連するコンテキストを提供するために、メッセージの中でファイルやメソッドの参照を使用してください。 例えば、モデルに他のメソッドに似たメソッドを作らせたい場合は、メッセージに'similar to @<method>を追加する。
• 答えの関連性が薄れたり、新しいタスクを始めたりしたら、新しいチャット会話を作成し、そこから作業する。 異なる無関係なチャットメッセージでモデルを混乱させる可能性のある1つの大きな会話よりも、それぞれが特定のコンテキストを持つ多くの短いチャット会話を持つ方が良い。

チャット会話セッションの切り替え

チャット会話セッションを切り替えるには、チャットセッションリストからセッションを選択します。

チャットセッション名の変更

チャット会話セッションの名前を変更するには

1. チャットセッションで、オーバーフローメニュー アイコンをクリックします。
2. 変名をクリックします。
3. 新しい名前を入力し、Enterを押す。

チャットセッションの削除

1つのチャット会話セッションを削除するには

1. チャットセッションで、オーバーフローメニュー アイコンをクリックします。
2. 「削除」をクリックします。

複数のチャット会話セッションを削除するには

1. チャットを選択 アイコンをクリックします。
2. 削除したいチャットを選択するか、「 すべて選択 」をクリックします。
3. 削除 アイコンをクリックし、 削除ボタンをクリックして確定します。

Eclipseでエディターを使う

C、C++、Go、 JavaScript, Python、 TypeScript:

1. ファイルを右クリックする。
2. で開く] をクリックし、[ テキストエディタ] をクリックする。

Java の場合、 Eclipse IDE の Java エディターによるインライン・コード生成は watsonx Code Assistant でサポートされていますが、最初にセットアップする必要があります。

1. Eclipseの設定でContent Assistに移動します。

   コンテンツ・アシストへのナビゲーション

   オペレーティング・システム	パス
   MacOS	Eclipse > 設定 > Java > エディター > コンテンツ・アシスト
   Windows (US)	ウィンドウ > 環境設定 > Java > エディタ > コンテンツアシスト

2. 挿入セクションで、「単一の提案を自動挿入する 」のチェックを外します。

3. Auto Activation セクションで、 Auto activation triggers for Javaに ._abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ を追加し、 Enable auto activationがチェックされていることを確認する。

4. Apply and Close（適用して閉じる ）をクリックします。

単線補完

エディターでコードを書くと、watsonx Code Assistantがそのコードを完成させるためのコードを提案します。

1. コード行の入力を開始し、一時停止する。
2. Watsonx Code Assistantは、入力した行を補完するコード候補を追加します。
3. Visual Studio Codeで、 Tabを押して提案を受け入れる。 Eclipseで、 Return または Enterを押して提案を受け入れる。 または Escを押して拒否する。

マルチラインコンプリート

入力したコード行やコメントに基づいて、複数行のコード・サジェストを得ることができる。

1. コード行の入力を開始するか、必要なコードを説明するコメントを入力する。

   最良の結果を得るためには、例えば、予想されるプログラミング言語をコメントに含めてください：

   // Sort an array with a fast sort function (TypeScript programming language)
   

2. キーボードショートカットを使う。

   デフォルトのキーボードショートカット

   オペレーティング・システム	ショートカット
   MacOs	オプション＋。
   Windows (US)	Alt+。

3. Watsonx Code Assistantは、複数行のコード候補を追加します。

4. Visual Studio Codeで、 Tabを押して提案を受け入れる。 Eclipseで、 Return または Enterを押して提案を受け入れる。 または Escを押して拒否する。

特定のコード言語のコード補完を無効にする

必要であれば、 Visual Studio Code 拡張機能の Completion: Disabled Languages 設定を使用して、特定のコード言語のコード補完を無効にすることができます。

1. watsonx Code Assistant の拡張設定を開く。

2. Add Itemをクリックして、コード言語を選択する。 選択肢は以下のとおりです。

   コード言語

   選択	コード言語
   c	C
   cpp	C++
   go	実行
   java	Java
   javascript	JavaScript
   javascriptreact	JavaScript 反応
   python	Python
   typescript	TypeScript
   typescriptreact	TypeScript 反応

コード言語を再度有効にするには、リストから削除します。

1. リスト内のコード言語をクリックします。

2. 項目を削除] アイコンをクリックして、無効な言語のリストから削除します。

コード補完を無効にする

必要であれば、エディター・ウィンドウでのコードの補完を無効にすることができます。

Visual Studio Codeでコード補完を無効にするには：

1. エディターの右下隅で、 Disable watsonx Code Assistant Completions アイコンをクリックする。
2. watsonx Code AssistantCompletions を有効にする」アイコンをもう一度クリックすると、補完機能を再度有効にすることができます。

Eclipse IDEでコード補完を無効にするには：

1. エディター・ツールバーで、「Disablewatsonx Code AssistantCompletions」アイコンをクリックします。
2. watsonx Code AssistantCompletions を有効にする」アイコンをもう一度クリックすると、補完機能を再度有効にすることができます。

長いコードブロックにはチャットを使用してください。 改良と定型コードには、エディタ内でのコード生成を使用します。

チャットを利用する

• 授業全体のアウトラインを作成する
• メソッドを詳細に指定する
• より多くの指示（例えば、名前の変更や置換）を使って、提案されたコードを洗練させる

エディター内のコード生成を使って

• 入力し始めたコード行を完成させる
• ゲッターやセッターのような定型コードを自動的に作成する
• 1行のコメントで記述できるメソッドとコードを作成する

Comment-to-code：指示ではなく、説明的なコメントを使用する

エディターでcomment-to-codeを使うときは、自分が書いたコードにコメントを書くのと同じように、意図した動作を説明するコメントを書いてください。 例えば、'//return even numbers from an arraylistまたは '//method that returns even numbers from an arraylist を使用する。

//write a method that returns even numbers from an arraylist のような指示としてコメントを書かないこと。 Watsonx Code Assistant は、典型的な記述的コメントが多く含まれるデータに対してコードを完成させるように訓練されたモデルを使用しているため、このようなタイプのコメントほど良い結果が得られます。

エディタ内のコード生成に使用されるコンテキスト

コード生成の重要な要素はコンテキスト、つまりモデルに渡す周囲のコードだ。 エディター内でのコード生成には、 watsonx Code Assistantを使う：

1. 生成がトリガーされる行の前の20行のコード。
2. 生成がトリガーされる行の後の20行のコード。
3. 生成のトリガーとなる現在のファイルの先頭から200行まで。
4. 生成がトリガーされた行を囲むコードに類似したコードスニペットを5つまで。 これらのスニペットは、現在のファイルと同じプログラミング言語で開いた、過去10個のファイルから取られている。

エディター内コード生成の結果を改善する：

• ワークスペースで、watsonx Code Assistantに知らせたいコードのあるファイルを開きます。 Watsonx Code Assistant は、これらのファイルの中から、補完のトリガーとなる場所と似たようなコード、例えば、似たようなクラスや変数を使うメソッドを見つけようとし、そのコードをコンテキストとしてモデルに送ります。
• または、 watsonx Code Assistant チャットを使用して最初のアウトラインを作成し、結果をワークスペースのファイルにコピーしてから、エディター内でコード生成を続行します。 ファイル数がゼロか、ほとんど空の状態から始める場合は、エディター内でのコード生成は使わないこと。