> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# JupyterでAIプロンプトを使用する

export const InlineImage = ({src, alt = '', height = '1.6em'}) => {
  return <img noZoom src={src} alt={alt} style={{
    display: 'inline',
    verticalAlign: 'start',
    height: height,
    margin: '0'
  }} />;
};

### はじめに

Jupyterワークスペースを使用すると、メモ内にAIプロンプトを記述できます。Jupyterは、Jupyterから移動せずにDomo. AIプレイグラウンドの場合と同じプロンプトを使用します。

Jupyter AIの詳細については [こちら](/ja/s/article/000005291) 、AIプレイグラウンドの詳細については [こちら](/ja/s/article/000005236) を参照してください。

***

* [必要な許可](#required_grants)
* [Jupyterワークスペースにアクセスする](#access_jupyter_workspaces)
* [テキスト生成プロンプトを使用する](#using_generate_text)
* [Text-to-SQLプロンプトを使用する](#using_text_to_sql)
* \[テキストからBeast Modeプロンプトを使用する]\(#using\_text\_to\_bBeast Mode)
* [テキスト要約プロンプトを使用する](#using_summariz_text)

***

### 必要な許可

Jupyterにアクセスするには、以下のいずれかの許可が有効になっている権限が必要です。

* **Jupyterワークスペースを作成 —** ユーザーは、自分がアクセス権を持つJupyterワークスペースを作成、編集、削除できます。
* **Jupyterワークスペースを管理** （Jupyter管理者） **—** ユーザーは、インスタンス内のすべてのJupyterワークスペースを表示、編集、削除できます。ほかのユーザーとワークスペースを共有するには、この許可が必要です。

### Jupyterワークスペースにアクセスする

ナビゲーションヘッダーで **［データ］** を選択してData Centerを開きます。

左側のナビゲーションで、 <InlineImage src="/images/kb/ja/ka0Vq0000005FKz-00N5w00000Ri7BU-0EM5w000005vXkP.png" /> **［More］** （水平の三点リーダー）> **［Jupyterワークスペース］** を選択します。

<Frame>
  <img alt="jupyter workspaces.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/bxEAfEU9KvmS3YRs/images/kb/ka0Vq00000051WX-00N5w00000Ri7BU-0EMVq0000040sfd.jpg?fit=max&auto=format&n=bxEAfEU9KvmS3YRs&q=85&s=857944cd52d51c4b14076f5433aedb49" style={{width: 280, height: 512}} width="330" height="604" data-path="images/kb/ka0Vq00000051WX-00N5w00000Ri7BU-0EMVq0000040sfd.jpg" />
</Frame>

ワークスペースの作成の詳細については、 [こちら](/ja/s/article/36004740075#create_workspace) を参照してください。

[このページのトップへ](#intro)

### テキスト生成プロンプトを使用する

generate\_textプロンプトは、質問に対する回答を提供します。この例では、AIサービスに提供されるプロンプトはprompt\_templateにあります。ここには\${words}の制限があり、この値はprompt\_parametersに含まれています。

出力プロンプトは下部に指定されます。

<Frame>
  <img alt="Screenshot 2024-09-18 at 2.04.56 PM.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/bxEAfEU9KvmS3YRs/images/kb/ka0Vq00000051WX-00N5w00000Ri7BU-0EMVq000002moSn.jpg?fit=max&auto=format&n=bxEAfEU9KvmS3YRs&q=85&s=545cee20343e1839018f0f8287986476" style={{width: 903, height: 110}} width="2726" height="332" data-path="images/kb/ka0Vq00000051WX-00N5w00000Ri7BU-0EMVq000002moSn.jpg" />
</Frame>

input\_strに新しいプロンプトを指定することで、標準のgenerate\_textテンプレートを変更できます。prompt\_templateはinput\_strよりも優先されます。

input\_strを使用するには、prompt\_templateおよびprompt\_parametersを削除する必要があります。

generate\_text関数では、以下のパラメータを使用できます。 `input_str` を除くすべてのパラメータはオプションです。

```
def generate_text(input_str:str,  
   prompt_template: Optional[PromptTemplate] = None,  
         parameters: Optional[dict[str, str]] = None,  
         model: Optional[str] = None,  
         model_configuration: Optional[dict[str, object]] = None,  
         system: Optional[str] = None):  
  """      
 文字列入力からテキストを生成  
   
 パラメータ:          
 input_str (str): 入力文字列          
 prompt_template (PromptTemplate): プロンプトテンプレート          
 parameters (dict[str, str]): パラメータ          
 model (str): モデル名          
 model_configuration (dict[str, object]): モデル設定          
 system (str): モデルへのプロンプトに含まれるデフォルトのシステム命令のオプションオーバーライド。  
      
 戻り値:          
 response: 生成されたテキスト      
 """  
 text_generation_request = TextGenerationRequest(input_str, prompt_template, parameters, model,  
model_configuration, system)  
 text_response = _jupyterhub.generate_text(text_generation_request.to_json())  
text_ai_response = TextAIResponse(text_response['prompt'], text_response['choices'])  
return text_ai_response
```

[このページのトップへ](#intro)

### Text-to-SQLプロンプトを使用する

text\_to\_sqlプロンプトは質問にもとづいてSQLクエリを提供します。この例では、AIサービスに提供されるプロンプトはprompt\_templateに、指定した列はprompt\_parametersにあります。

関数SQLクエリは下部の出力で指定されます。

<Frame>
  <img alt="text to sql.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/bxEAfEU9KvmS3YRs/images/kb/ka0Vq00000051WX-00N5w00000Ri7BU-0EMVq000002lNpd.jpg?fit=max&auto=format&n=bxEAfEU9KvmS3YRs&q=85&s=cf1850f22a999aee9324bf8f03a42edd" style={{width: 901, height: 358}} width="936" height="372" data-path="images/kb/ka0Vq00000051WX-00N5w00000Ri7BU-0EMVq000002lNpd.jpg" />
</Frame>

標準のtext\_to\_sqlテンプレートを変更するには、新しいDataSourceSchemaと、AIプロンプトの記述内容を指定するinput\_strを指定します。

ワークスペースに接続されている既存のDataSetにworkspace\_data\_source\_aliasを指定することもできます。workspace\_data\_source\_aliasを指定すると、ワークスペースはSQLクエリの列名を生成するときにスキーマを使用できます。

text\_to\_sql関数では、以下のパラメータを使用できます。 `input_str` を除くすべてのパラメータはオプションです。

```
def text_to_sql(input_str: str,                  
 prompt_template: Optional[PromptTemplate] = None,                  
 data_source_schemas: Optional[list[DataSourceSchema]] = None,                
 parameters: Optional[dict[str, str]] = None,                  
 model: Optional[str] = None,                  
 model_configuration: Optional[dict[str, object]] = None,                  
 workspace_data_source_alias: Optional[str] = None,                  
 dataframe: Optional[pd.DataFrame] = None,                  
 system: Optional[str] = None                  
 ):    
 """      
 テキストをSQLに変換  
    
 パラメータ:         
 input_str (str): 入力文字列          
 data_source_schemas (list[DataSourceSchema]): データソーススキーマのリスト          
 prompt_template (PromptTemplate): プロンプトテンプレート          
 parameters (dict[str, str]): パラメータ          
 model (str): モデル名          
 model_configuration (dict[str, object]): モデル設定          
 workspace_data_source_alias (str): ワークスペースに関連付けられたデータソーススキーマのエイリアス          
 dataframe (pd.DataFrame): Pandasデータフレーム          
 system (str): モデルへのプロンプトに含まれるデフォルトのシステム命令のオプションオーバーライド。  
    
 戻り値:          
 text_ai_response: TextAiResponse      
 """ if workspace_data_source_alias is not None:        
 data_source_schemas = [              
 DataSourceSchema.from_optional_list(domojupyter.io.get_schema_from_datasource(workspace_data_source_alias).get('schema'),                  
 workspace_data_source_alias)]      
 elif dataframe is not None:          
 schema = domojupyter.io.get_schema_from_dataframe(dataframe)          
 data_source_schemas = [              
 DataSourceSchema.from_optional_list(schema,                  
 dataframe.name)]      
 text_to_sql_request = TextToSQLRequest(input_str, data_source_schemas, prompt_template, parameters, model,                                             
 model_configuration, system)      
 sql_response = _jupyterhub.text_to_sql(text_to_sql_request.to_json())      
 text_ai_response = TextAIResponse(sql_response['prompt'], sql_response['choices'])      
 return text_ai_response
```

[このページのトップへ](#intro)

### テキストからBeast Modeプロンプトを使用する

テキストからBeast Modeサービスは、質問にもとづいてBeast Mode関数を提供します。この例では、AIに提供されるプロンプトで、すべての値の列（data\_source\_schemas）をまとめて追加するように要求されています。

Beast Mode関数は下部の出力で指定されます。

<Frame>
  <img alt="text to beast mode.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/bxEAfEU9KvmS3YRs/images/kb/ka0Vq00000051WX-00N5w00000Ri7BU-0EMVq000002lQab.jpg?fit=max&auto=format&n=bxEAfEU9KvmS3YRs&q=85&s=c67cca84afc441c45808a3ce3e3d1fca" style={{width: 897, height: 322}} width="936" height="336" data-path="images/kb/ka0Vq00000051WX-00N5w00000Ri7BU-0EMVq000002lQab.jpg" />
</Frame>

text\_to\_beast\_mode関数では、以下のパラメータを使用できます。 `input_str` を除くすべてのパラメータはオプションです。

```
def text_to_beast_mode(input_str: str,  
 prompt_template: Optional[PromptTemplate] = None,                         
 data_source_schema: Optional[DataSourceSchema] = None,                         
 parameters: Optional[dict[str, str]] = None,                         
 model: Optional[str] = None,                         
 model_configuration: Optional[dict[str, object]] = None,                         
 system: Optional[str] = None):      
  """      
 テキストをBeastmodeに変換  
      
 パラメータ:         
 input_str (str): 入力文字列          
 data_source_schema (DataSourceSchema): データソーススキーマ          
 prompt_template (PromptTemplate): プロンプト          
 parameters (dict[str, str]): パラメータ          
 model (str): モデル名          
 model_configuration (dict[str, object]): モデル設定          
 system (str): モデルへのプロンプトに含まれるデフォルトのシステム命令のオプションオーバーライド。  
     
 戻り値:          
 sql: SQL文字列      
 """
```

[このページのトップへ](#intro)

### テキスト要約プロンプトを使用する

summarize\_textプロンプトは質問にもとづいてテキスト要約を提供します。この例では、AIサービスに提供されるプロンプトはtext\_summarizationにあります。

出力プロンプトは下部に表示されます。

<Frame>
  <img alt="Screenshot 2024-09-18 at 11.30.03 AM.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/bxEAfEU9KvmS3YRs/images/kb/ka0Vq00000051WX-00N5w00000Ri7BU-0EMVq000002mmsQ.jpg?fit=max&auto=format&n=bxEAfEU9KvmS3YRs&q=85&s=8b3734aba4264f0ab42b67cec7c2aa6b" style={{width: 898, height: 449}} width="972" height="486" data-path="images/kb/ka0Vq00000051WX-00N5w00000Ri7BU-0EMVq000002mmsQ.jpg" />
</Frame>

summarize\_text関数では、以下のパラメータを使用できます。 `input_str` を除くすべてのパラメータはオプションです。

```
def summarize(input_str: str,                
 prompt_template: Optional[PromptTemplate] = None,                
 parameters: Optional[dict[str, str]] = None,                
 model: Optional[str] = None,                
 model_configuration: Optional[dict[str, object]] = None,                
 system: Optional[str] = None,                
 chunking_configuration: Optional[ChunkingConfiguration] = None,                
 output_style: Optional[SummarizationOutputStyle] = None,                
 output_word_length: Optional[SizeBoundary] = None):      
 """      
 テキスト要約  
   
 パラメータ:          
 input_str (str): 要約対象のテキスト情報。この属性は必須です。          
 prompt_template (PromptTemplate): プロンプトテンプレート          
 parameters (dict): パラメータ名とそれに対応する値を含む辞書。              
 PromptTemplate内のプレースホルダを置き換えるために使用します。          
 model (str): 要約に使用する言語モデルの名前/id          
 model_configuration (dict): 選択した言語モデルのカスタム構成パラメータを持つ辞書。         
 system (str): モデルへのプロンプトに含まれるデフォルトのシステム命令のオプションオーバーライド。          
 chunking_configuration (ChunkingConfiguration): 指定されたテキストをより小さいパーツまたはチャンクに分割するための設定。          
 output_style (SummarizationOutputStyle): 要約の出力のデザイン、構造化、および構成を決定。          
 output_word_length (SizeBoundary): ワード数にもとづいて出力要約の長さを制限するサイズ境界を定義。  
      
 戻り値:          
 response: 要約されたテキスト      
 """
```

[このページのトップへ](#intro)

日本語
