For AI agents: the complete documentation index is available at https://docs.dataplatform.ovh.net/ja/llms.txt, the full documentation bundle is available at https://docs.dataplatform.ovh.net/ja/llms-full.txt, and this page is available as Markdown at https://docs.dataplatform.ovh.net/ja/dpe-notebooks-jupyter-ai-extension.md.
  • 🇯🇵 日本語

    • OVH AI Endpoints を Jupyter AI に統合する

    Jupyter AI 拡張機能は、ジェネレーティブ AI の力を直接ノートブック環境に持ち込み、大規模言語モデルと相互作用できるようにします

    目的

    Jupyter AI 拡張機能 は、ジェネレーティブ AI の力を直接ノートブック環境に持ち込み、大規模言語モデルと相互作用したり、コードを生成したり、概念を説明したり、JupyterLab を離れることなくさまざまな AI 機能を利用したりすることができます。

    Data Platform Notebooks には、Jupyter AI 拡張機能が事前インストールされており、すぐに AI を活用できるようになっています。OVH AI Endpoints を統合することで、カスタムモデルやサービスをノートブック内で直接利用できます。

    このガイドでは、Data Platform 上の OVH AI Endpoints で Jupyter AI 拡張機能を設定して使用するプロセスを説明します。

    必要条件

    開始する前に、以下を確認してください:

    • アクティブな Data Platform Notebook インスタンス（Jupyter AI は事前インストール済み）。
    • 統合したい OVH AI サービスの AI Endpoints API キー。

    OVH AI Endpoints で Jupyter AI を設定する

    Data Platform ノートブックを開いたら、事前インストールされた Jupyter AI 拡張機能を OVH AI Endpoints に接続するように設定できます。

    :::info 重要な注意事項:

    • この設定は、ノートブックインスタンスごとに1回実行する必要があります。この特定のノートブックを再起動した場合、自動的に保持されますが、異なるノートブックインスタンスには同期されません。
    • Jupyter AI は、環境変数を使用してモデルを設定することが多いです。ここでは UI を通じてこれらを設定しますが、この理解は高度な設定やトラブルシューティングに役立ちます。 :::

    1. Jupyter AI パネルにアクセスする: JupyterLab インターフェースで、左サイドバーの「チャット」アイコンを探してクリックします。

      Jupyter AI

    2. 設定を開始する: チャットパネル内で ⚙️ ここから始める をクリックして設定プロセスを開始します。

    3. 完成モデルを定義する:

      • 3.1 完成モデル: OpenAI (General Interface) を選択します。これにより、モデル ID、ベース URL、API キーの設定が表示されます。
      • 3.2 モデル ID: AI Endpoints カタログ から希望するモデルの ID を入力します。例として、Qwen2.5-Coder-32B-Instruct を使用します。
      • 3.3 ベース API URL: OVH AI Endpoints のベース URL を入力します。例: https://oai.endpoints.kepler.ai.cloud.ovh.net/v1/。
      • 3.4 API キー: 指定されたフィールドに OVH AI Endpoints API キーを入力します。
      Jupyter AI

    4. 保存して戻る: 変更を保存 をクリックし、Jupyter AI チャットパネルに戻るために戻る矢印をクリックします。Jupyter AI 拡張機能は現在設定され、使用準備が整っています。

    Jupyter AI

    ノートブックで Jupyter AI を使用する

    OVH AI Endpoint を Jupyter AI に設定したら、Jupyter AI チャットパネルを使用してノートブック環境内で直接相互作用できます。

    Jupyter AI チャットパネル

    Jupyternaut によって提供される Jupyter AI チャットパネル は、JupyterLab 内で会話形式の相互作用を可能にします。これは、設定された OVH AI Endpoint と相互作用するための主要なインターフェースです。これを使用して、プログラミングのヘルプを受けたり、ノートブックを生成したり、さらに多くのことを簡単に行うことができます。

    以下の操作が可能です:

    • チャットボックスを使用して、データやコードについて質問します。
    • /generate コマンドを使用して、テキストプロンプトから新しい Jupyter ノートブックを生成します。
    • /fix コマンドを使用して、選択したノートブックセルのエラーを修正します。
    • /export コマンドを使用して、チャット履歴を Markdown ファイルにエクスポートします。
    • /learn コマンドを使用して、システム上のファイルについて Jupyternaut に教えます。
    • @file を使用して、選択したファイルの内容を含め、より正確な回答のために、AI に直接コンテキストを提供します。

    すべての機能についての詳細な情報については、Jupyter AI ドキュメント を確認してください。

    Jupyter AI チャットパネル

    例: Kaggle Hub データから機械学習ノートブックを生成するワークフロー

    /generate コマンドを使用して、データを取得し、データ探索を実行し、基本的な機械学習モデルを構築する新しいノートブックを作成する強力な機能をデモンストレーションします。この例では、直接 URL からアクセス可能な Kaggle Titanic データセットの一般的なバージョンを使用します。

    1. 「OVH AI Endpoints で Jupyter AI を設定する」セクションで説明されているように、Jupyter AI を設定します（例: Qwen2.5-Coder-32B-Instruct を使用）。

    2. AI チャットパネルを開く（既に開いていない場合）は、左サイドバーの「チャット」アイコンをクリックします。

    3. /generate コマンド に続けて詳細なプロンプトをチャット入力フィールドに入力します:

      /generate Create a Python notebook to perform binary classification on the Titanic dataset. The notebook should:
1. Download the 'train.csv' dataset from 'https://raw.githubusercontent.com/datasciencedojo/datasets/master/titanic.csv' using pandas.
2. Load the downloaded data into a pandas DataFrame.
3. Display basic information (first 5 rows, data types, descriptive statistics).
4. Handle missing values (e.g., fill 'Age' with the mean, 'Embarked' with the mode, and drop the 'Cabin' column).
5. Encode categorical features ('Sex', 'Embarked').
6. Split the data into training and testing sets (80/20 split), with 'Survived' as the target variable.
7. Train a RandomForestClassifier model.
8. Evaluate the model using accuracy and a classification report.

    4. Enter キーを押してプロンプトを送信します。Jupyter AI は設定された OVH AI Endpoint を使用してリクエストを処理します。短時間後、現在のディレクトリ（例: Titanic Binary Classification Notebook.ipynb）に新しい .ipynb ファイルが生成され、要求された手順を実行する Python コードセルで事前入力されます。

    5. 生成されたノートブックを開き、セルを実行します。必要に応じて、Jupyter AI チャットパネルを使用してさらに支援を受けながら、コードを修正、拡張、またはデバッグできます。これにより、データサイエンスのワークフローが大幅に加速します。

    Jupyter AI チャットパネル

    トラブルシューティング

    • API Key not found または Authentication Error: Jupyter AI 設定中に入力した API キーを確認してください。正しいことと、OVH AI Endpoint に必要な権限を持っていることを確認してください。
    • Could not connect to the model または Bad URL: Jupyter AI 設定中に提供された ベース API URL を確認してください。URL が正しいことと、OVH AI Endpoint が実行中でアクセス可能であることを確認してください。
    • JupyterLab に AI パネル/ボタンが表示されない: AI パネルまたはボタンが表示されない場合は、ブラウザータブを更新するか、Jupyter サーバーを再起動してください。Jupyter AI は事前インストールされていますが、新しい読み込みが役立つことがあります。

    さらに詳しく

    トレーニングや技術的な支援が必要な場合は、営業担当者にお問い合わせください、または このリンク をクリックして見積もりを依頼し、プロフェッショナルサービスの専門家にプロジェクトのカスタム分析を依頼してください。

    専用の Discord チャネル で Data Platform を構築するチームと直接質問し、フィードバックを提供し、相互作用してください。

    OVHcloud サービスについてサポートが必要な場合は、ヘルプセンター でリクエストを作成してください。

    コミュニティのユーザー に参加してください。