> ## 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.

# Domo 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'
  }} />;
};

### はじめに

Domo AIプレイグラウンド機能を使用すると、大規模言語モデル（LLM）を活用して、Domoプラットフォーム内で様々な生成AIサービスを使用できます。これらのサービスには、テキストからSQL、テキスト生成、テキストからBeast Mode、テキストの要約などがあります。

AIサービスプレイグラウンドでは、AIサービスをテストし、Jupyterメモのようなコーディングツールで使用するコードスニペットを生成できます。

***

この記事では、プレイグラウンドについて以下のトピックで説明します。

* [必要な許可](#required_grants)
* [利用可能なサービス](#available_services)
  * [テキストからSQL](#text_to_sql)
  * [テキスト生成](#text_generation)
  * [テキストからBeast Mode](#beast_mode)
  * [テキストの要約](#summarization)
* [プレイグラウンドにアクセスする](#access_playground)
* [プレイグラウンドを使用する](#use_playground)
  * [プロンプトテンプレート](#prompt_template)
  * [コードスニペット](#code_snippets)

***

### 必要な許可

AIプレイグラウンドを使用するには、カスタマイズされた権限に追加された以下の許可が必要です。Domo管理者では、この許可がデフォルトで有効になっています。許可の詳細については、「 [カスタマイズされた権限を管理する](/s/article/360043438973) 」を参照してください。

<Warning>
  **AIサービスを利用する —** Domo App、Domo Bricks、Jupyterワークスペース、ワークフロー内で使用するAIサービスにアクセスできます。この許可は、AIサービスを使用する必要があるが、管理する必要がないすべてのユーザーに付与する必要があります。
</Warning>

### 利用可能なサービス

利用可能なAIサービスについて以下に説明します。これらのサービスは、Jupyterワークスペース、Domo App、Domo Bricks、Domoワークフローで使用できます。

# テキストからSQL

テキストからSQLを使用すると、自然言語を使用して、選択したDataSetで使用するSQLをシステムに出力できます。このサービスでは、テキストとDataSetメタデータ（DataSetスキーマなど）を入力としてSQLを生成します。テンプレートは、サポートが必要な場合に使用できます。

以下の例では、サンプルストアの収益データが選択されています。具体的なプロンプトは、`What were my average sales in Idaho?`（アイダホでの平均売り上げは？）です。

**［実行］** を選択すると、 **［出力］** フィールドにSQLクエリが表示されます。

<Frame>
  <img alt="run prompt.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wPcX.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=768bfb90805114d35e691beb7f87690e" style={{width: 900, height: 351}} width="1600" height="624" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wPcX.jpg" />
</Frame>

これで、SQL式をMySQLエディターまたはMagic ETLにコピーしてデータを変換できるようになります。

**［コードスニペット］** フィールドを展開して、要求されたSQL式を検索するために使用されるコードスニペットが表示されます。コードをコピーしてJupyter（PythonまたはR）またはDomo App（JavaScriptまたはcURL）で使用します。

<Frame>
  <img alt="expand code snippet.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wPcc.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=0d1cf89d2ef00f8a21709a70d4632c77" style={{width: 901, height: 351}} width="1602" height="624" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wPcc.jpg" />
</Frame>

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

# テキスト生成

テキスト生成を使用すると、自然言語プロンプトを入力して、自然言語で回答を出力できます。適切なプロンプトの生成に役立つテンプレートが用意されています。目的の結果を得るには、プロンプトを複数回繰り返す必要がある場合があります。

テキスト生成は、大規模言語モデル（LLM）によって行われます。 **［デフォルトモデルを使用］** チェックボックスが自動的に選択されています（現在のデフォルトモデルはChatGPTです）。インスタンスでほかのモデルが使用可能になっている場合は、別のLLMを選択できます。モデルが異なると出力が若干異なることがあり、特定の使用事例では、あるモデルのパフォーマンスがほかのモデルよりも優れていることがあります。

<Frame>
  <img alt="text generation services.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQ9W.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=b8e62b6e5430473338e18dfd04d8ffc3" style={{width: 908, height: 456}} width="1600" height="804" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQ9W.jpg" />
</Frame>

以下の例では、マーケティングタイプのテキストプロンプトを使用しています。システムは、将来のマーケティングキャンペーンで使用できるステートメントを出力しています。

<Frame>
  <img alt="text generation prompt.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQ9v.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=7bd673ac93f577da2618058b096dab0f" style={{width: 904, height: 400}} width="1600" height="708" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQ9v.jpg" />
</Frame>

**［コードスニペット］** フィールドを展開して、要求されたテキスト生成を検索するために使用されるコードスニペットが表示されます。コードをコピーしてJupyter（PythonまたはR）またはDomo App（JavaScriptまたはcURL）で使用します。

<Frame>
  <img alt="text generation prompt code.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQ9l.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=17fa5112c6c09518a0263c7c0b5f69ee" style={{width: 901, height: 264}} width="1600" height="469" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQ9l.jpg" />
</Frame>

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

# テキストからBeast Mode

テキストからBeast Modeを使用すると、自然言語を使用して、選択した設定済みデータで使用するBeast Mode計算をシステムに出力できます。適切なプロンプトの生成に役立つテンプレートが用意されています。

以下の例では、サンプルストアの収益データが選択されています。プロンプトは、`What was the best revenue quarter in my data?`（データの中で最高の収益の四半期はいつでしたか？）です。 **［実行］** を選択すると、Beast Modeが **［出力］** フィールドに出力されます。

<Frame>
  <img alt="beast mode service prompt.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQAF.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=c87711d022040aea3d77342f77a9856c" style={{width: 901, height: 396}} width="1600" height="703" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQAF.jpg" />
</Frame>

これでBeast ModeをAnalyzerまたはMagic ETL DataFlowにコピーしてデータを変換できるようになります。

**［コードスニペット］** フィールドを展開して、要求されたBeast Mode計算を表示することもできます。コードをコピーしてJupyter（PythonまたはR）またはDomo App（JavaScriptまたはcURL）で使用します。Beast Modeの詳細については、 [こちら](https://domo-support.domo.com/s/topic/0TO5w000000ZanAGAS/beast-mode) を参照してください。

<Frame>
  <img alt="beast mode snippet.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQAK.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=7d5eaae124e89097a7b3e194a5747e93" style={{width: 900, height: 253}} width="1600" height="450" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQAK.jpg" />
</Frame>

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

# テキストの要約

テキストの要約を使用すると、テキストプロンプトを入力して、自然言語で要約を出力できます。プロンプトテンプレートでは、最良の結果を得るのに必要なプロンプトのタイプが定義されています。最終結果を得るには、プロンプトを複数回繰り返す必要がある場合があります。 **［プレイグラウンド］** ページの右側のパネルにある **［設定］** および **［チャンキング］** タブを使用して、出力スタイルを定義します。

テキストの要約は、大規模言語モデル（LLM）によって行われます。 **［デフォルトモデルを使用］** チェックボックスが自動的に選択されています（現在のデフォルトモデルはChatGPTです）。インスタンスでほかのモデルが使用可能になっている場合は、別のLLMを選択できます。モデルが異なると出力が若干異なることがあり、特定の使用事例では、あるモデルのパフォーマンスがほかのモデルよりも優れていることがあります。

<Frame>
  <img alt="summarization service.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQ6Y.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=733dc31e60aabcec236dbe60bdd31e9e" style={{width: 900, height: 400}} width="1600" height="711" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQ6Y.jpg" />
</Frame>

以下の例では、テキストの要約サービスに、イタロ・カルヴィーノの小説『木のぼり男爵』を2段落で要約するよう依頼しています。また、出力スタイルを［段落］、出力ワードの最大長を120ワード、最小長を100ワードに定義しました。

<Frame>
  <img alt="summary output style.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQB3.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=d4f550889876595c5ca3b4be941739f0" style={{width: 901, height: 362}} width="1600" height="643" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQB3.jpg" />
</Frame>

**［コードスニペット］** フィールドを展開して、要求されたテキストの要約を表示することもできます。コードをコピーしてJupyter（PythonまたはR）またはDomo App（JavaScriptまたはcURL）で使用します。

<Frame>
  <img alt="summary snippet.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQBN.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=af25f24aaefbac1dbcaaf53159ea5058" style={{width: 899, height: 272}} width="1600" height="484" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wQBN.jpg" />
</Frame>

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

### プレイグラウンドにアクセスする

ナビゲーションヘッダーからプレイグランドにアクセスするには、 **［その他］** > **［Domo AI］** を選択して、AIランディングページを表示します。

左側のサイドバーで、 <InlineImage src="/images/kb/ja/ka0Vq0000005ZgH-00N5w00000Ri7BU-0EMVq000004BHJN.jpg" /> **［プレイグラウンド］** を選択します。

AIプレイグラウンドページが表示されます。

<Frame>
  <img alt="playground page.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wPcS.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=de17ea409bec243f369e70676ed78974" style={{width: 904, height: 309}} width="1600" height="547" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006wPcS.jpg" />
</Frame>

### プレイグラウンドを使用する

プレイグラウンドでは、 [プロンプトテンプレート](#prompt_template) を使用して使用可能なAIサービスをテストし、 [コードスニペットを生成](#code_snippets) できます。

# プロンプトテンプレート

**［プロンプトテンプレート］** フィールドの内容は、サービスに送信されるものです。 **［プロンプト］** フィールドの内容は、テンプレートの{input}として渡されるものです。

プロンプトテンプレートを編集およびテストするには、 **［プロンプトテンプレート］** を展開します。

<Frame>
  <img alt="prompt template callout.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EMVq000004BHrF.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=66ffd835095d959a04723a30206408e1" style={{width: 899, height: 554}} width="2940" height="1812" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EMVq000004BHrF.jpg" />
</Frame>

プロンプトテンプレートを編集したり、 [サービス](#available_services) で必要な場合は **［設定］** タブにデータソースを追加したり、 **［実行］** を選択してプロンプトテンプレートをテストし、出力を検証したりできます。出力が返されない場合は、プロンプトテンプレートを変更して再実行します。

以下の例では、「Why is the sky blue?」（空はなぜ青い？）というプロンプトが、プロンプトテンプレートの{input}として渡されます。 **［出力］** フィールドに結果が表示されます。

<Frame>
  <img alt="Screenshot 2023-08-31 at 11.18.11 AM.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vl04.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=7594510e7a9fa6dc823a1a1968b0d93e" style={{width: 726, height: 471}} width="2092" height="1372" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vl04.jpg" />
</Frame>

**［プロンプトテンプレート］** で **［+新しいパラメーター］** を選択して、渡されるパラメーターを追加することもできます。

<Frame>
  <img alt="new parameter.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vl1C.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=09fe7810ea85fa3e2a0fa2a6c4ba795e" style={{width: 676, height: 310}} width="2072" height="950" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vl1C.jpg" />
</Frame>

以下の例では、値「blue」を持つ新しい{color}パラメーターがプロンプトテンプレートに追加されています。これでプロンプト が更新されて「Why is the sky」（空はなぜ）となり、プロンプトテンプレートの{input}の後にパラメーター{color}が追加されます。プロンプトテンプレートが渡されると、出力は前の例と同じになりますが、{color}パラメーターの値を「green」に変更すると変更されます。

<Frame>
  <img alt="sky blue.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vl0E.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=9623312e2acbc7b3aba6dea8d473f939" style={{width: 727, height: 316}} width="3150" height="1370" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vl0E.jpg" />
</Frame>

出力の仕様を作成することもできます。以下の例では、同じプロンプトテンプレートが、回答を10ワード以下にする仕様とともに渡されます。

<Frame>
  <img alt="Screenshot 2023-08-31 at 11.31.12 AM.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vl0d.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=467b4e8568ad1b39ca435bdb74771011" style={{width: 738, height: 512}} width="2070" height="1434" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vl0d.jpg" />
</Frame>

##### プロンプトとプロンプトテンプレートをリセットする

**［プロンプト］** も **［プロンプトテンプレート］** もいつでも **［リセット］** を選択して、デフォルトに戻すことができます。

<Frame>
  <img alt="reset.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vkzQ.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=b031532833af82b03203386471b1dd63" style={{width: 726, height: 471}} width="2104" height="1370" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vkzQ.jpg" />
</Frame>

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

# コードスニペット

プレイグラウンドでは、以下のツールおよび言語でコードスニペットを使用できます。

* Jupyter - Python
* Jupyter - R
* DomoApp - Javascript
* cURL

プレイグラウンドでコードスニペットを生成するには、 **［サービス］** ドロップダウンからテストするサービスを選択して、使用する特定のプロンプトを入力し、プロンプトを実行するDataSetを選択します。

<Frame>
  <img alt="playground callouts.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vkSq.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=81b8fb9a22dff3cd1d0e38d5df8e51dc" style={{width: 696, height: 351}} width="2646" height="1338" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vkSq.jpg" />
</Frame>

#### Jupyterメモ用のコードスニペットを生成する

プレイグラウンドで以下の手順を実行して、Jupyterメモで使用する、テキストからSQLサービスコードスニペットを生成します。

1. **［プレイグラウンド］** ページの **［サービス］** ドロップダウンで［テキストからSQL］を選択します。
2. **［プロンプト］** フィールドに、サービスを実行するプロンプトを入力します。
3. **［設定］** タブで、プロンプトを実行するDataSetを選択します。
4. **［実行］** を選択します。

   <Frame>
     <img alt="run prompt.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vkTK.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=2328bf368a0ef1a2c5d275073b5c44df" style={{width: 675, height: 349}} width="2978" height="1542" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vkTK.jpg" />
   </Frame>
5. **［出力］** フィールドで、プロンプトの出力を参照します。

   <Frame>
     <img alt="view output.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vkTe.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=67e26abe7a084c2f75bb8a6e1afda772" style={{width: 677, height: 334}} width="2876" height="1422" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vkTe.jpg" />
   </Frame>
6. **［コードスニペット］** セクションを展開して、関連するJupyter - Pythonコードを表示します。

   <Columns>
     <Frame>
       <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vkTj.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=099756a8291da4b13b22f65b8cedeb1d" width="2876" height="1528" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vkTj.jpg" />
     </Frame>

     <Frame>
       <img alt="Screenshot 2023-08-30 at 3.06.44 PM.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vkTt.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=b630e7f36303144b58caf8f947044228" style={{width: 685, height: 344}} width="2870" height="1440" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vkTt.jpg" />
     </Frame>
   </Columns>
7. （オプション） **［コードスニペット］** で、コードスニペットの言語を変更するにはドロップダウンを使用し、コードをマシンのクリップボードにコピーするには **［コードをコピー］** を選択します。

   <Frame>
     <img alt="change language.jpg" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/NZY_77jeKitg9n1Q/images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vjgN.jpg?fit=max&auto=format&n=NZY_77jeKitg9n1Q&q=85&s=4e3543aa5fd364d20053ed090fb26987" style={{width: 272, height: 228}} width="828" height="694" data-path="images/kb/ka05w0000012Bh8-00N5w00000Ri7BU-0EM5w000006vjgN.jpg" />
   </Frame>

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

日本語
