AIを活用したデータソースのクエリ

自然で会話形式の言語を使用して、データから洞察を得たり、リアルタイムでチャートやグラフを生成したりできます。

Squidの Query with AI 機能を使用すると、データベースコネクタ内のデータと対話することができます。ユーザーが自然言語で記述可能なプロンプトを提供すると、Query with AI は実行したクエリとともに自然言語での説明を返します。

Query with AI を使用すれば、クエリやグラフ作成関数を書く必要なく、誰でも主要なデータポイントの特定、チャートやグラフの生成、データに関する質問への回答を得ることができます。

Use cases

Squid AI を利用して、データの人間に読みやすい説明を取得できます。以下は例としてのプロンプトです:

How many games has team A won against team B?
Create a line graph of sales in 2022, with x representing the month and y representing the total value of sales in dollars.
What is the most common question asked by our customers?

Query with AI は Squid プラットフォームにおける強力なツールであり、複雑な質問やクエリを簡素化するために使用できます。以下のガイドは、主要な概念の概要と併せてコードスニペットを提供しています。詳細な例については、当社の website をご覧ください。

Configure your database connector

Query with AI は database connector 上でクエリを実行します。AI がデータを理解するために、最初にコレクションとフィールドが記載されたデータベーススキーマを確認します。Squid AI は、どのクエリを実行するかを判断するために、これらのコレクションやフィールドの説明も使用します。

コレクションとフィールドの説明を提供する方法は2通りあります:

自分自身の言葉で説明を手動で入力する。
Squid AI にスキーマの説明を生成させる。

Manually enter descriptions

以下の手順で、データベーススキーマを確認し、コレクションとフィールドの説明を提供します:

Squid Console で Connectors タブをクリックし、クエリを実行したいデータベースを見つけます。

もし、Squid AI で使用するデータベースがまだ接続されていない場合は、ここでコネクタを追加してください。データベースコネクタの設定方法については、database connectors documentation をご確認ください。データベースコネクタが追加されたら、次のステップに進めます。あるいは、Squid の組み込みデータベースを使用することもできます。
データベースコネクタの ellipsis (…) ボタンをクリックし、ドロップダウンメニューから Schema を選択します。
データベースに既に存在するデータに基づいてスキーマを更新するには、Rediscover schema をクリックします。あるいは、コンソール上で直接スキーマを編集することもできます。
コレクション名の右側にある鉛筆ボタンをクリックしてコレクションに説明を追加します。フィールドには、フィールド上の ellipsis (…) をクリックし、ドロップダウンメニューから Edit field を選択して説明を追加します。
スキーマを再発見または説明を編集した後、Save schema をクリックして更新内容を公開します。

Use AI-generated descriptions

Squid AI は、あなたに代わってコレクションとフィールドの説明を生成することができます。この機能は、コレクションから少量のデータをクエリし、そのデータとスキーマを OpenAI に送信します。

Note

Squid が利用するLLMは、あなたのデータをモデルのトレーニングに使用することは決してありません。もし、LLMにデータベースデータを一切渡したくない場合は、AI生成の説明を使用しないでください。Query with AI 機能はあなたのデータベースデータを送信しないため、独自に生成した説明を使用して機能を利用することができます。

以下の手順で、データベーススキーマを確認し、AI生成のコレクションとフィールドの説明を作成します:

Squid Console で Connectors タブをクリックし、クエリを実行したいデータベースを見つけます.

もし、Squid AI で使用するデータベースがまだ接続されていない場合は、ここでコネクタを追加してください。データベースコネクタの設定方法については、database connectors documentation をご確認ください。データベースコネクタが追加されたら、次のステップに進めます。あるいは、Squid の組み込みデータベースを使用することもできます。
データベースコネクタの ellipsis (…) ボタンをクリックし、ドロップダウンメニューから Schema を選択します。
データベースに既に存在するデータに基づいてスキーマを更新するには、Rediscover schema をクリックします。あるいは、コンソール上で直接スキーマを編集することもできます。
Generate Descriptions with AI ボタンをクリックして、スキーマ内の全てのコレクションとフィールドの説明を生成します。データベーススキーマのサイズによっては、数分かかる場合があります。生成後、コレクションとフィールドの説明を手動で確認および編集することができます。
スキーマを再発見または説明を編集した後、Save schema をクリックして更新内容を公開します。

Test Squid AI for Your Data

スキーマの構成と説明の追加が完了すると、コンソール上で Squid AI を使用してデータにクエリを実行できます。データベースコネクタの schema ビューで Query with AI ボタンをクリックしてください。提供された AI エージェントにデータの詳細を尋ね、応答をテストすることができます。

Query with AI in the console

Note

Query with AI は、質問の複雑さや生成されるクエリに応じて、応答に数秒から数分かかる場合があります。Squid AI がコード作成を担当するため、プロセスが簡素化されます。

Add Squid AI to the backend

Squid backend で Query with AI を利用して、プログラム的にデータに関する質問を行うことができます。

以下の例は、executable 内で executeAiQuery メソッドを使用して AI クエリを実行する例です:

Backend code
export class SquidAiDataService extends SquidService {
  @executable()
  async askQuestion(question: string): Promise<string> {
    const aiResponse = await this.squid
      .ai()
      .executeAiQuery('DATABASE_CONNECTOR_ID', question);

    // Log results to view in Squid Console logs
    console.log(
      `Question: ${question}
        Query: ${aiResponse.executedQuery ?? 'No query executed'}
        Explanation: ${aiResponse.explanation ?? 'No explanation'}`
    );
    // Send the answer to the client
    return aiResponse.answer;
  }
}

Next Steps

データ向けの Query with AI を試してみませんか？完全なコードサンプルと手順については、tutorial をご覧いただき、数分でセットアップする方法をご確認ください！

自然で会話形式の言語を使用して、データから洞察を得たり、リアルタイムでチャートやグラフを生成したりできます。​

Use cases​

Configure your database connector​

Manually enter descriptions​

Use AI-generated descriptions​

Test Squid AI for Your Data​

Add Squid AI to the backend​

Next Steps​