次の方法で共有

ai.generate_response 関数を使用してカスタム ユーザー プロンプトに応答する

ai.generate_response 関数では、Generateive AI を使用して、独自の命令に基づいてカスタム テキスト応答を生成します。すべて 1 行のコードで生成されます。

AI 関数は、Fabric の組み込みの大規模言語モデルの力を手に入れることで、データ エンジニアリングをターボチャージします。 詳細については、この概要記事 参照してください。

重要

この機能は、Fabric 1.3 ランタイム 以降で使用するために、プレビューにあります。

  • この概要記事 の前提条件 (AI 関数を使用するために一時的に必要な ライブラリのインストール など) を確認します。
  • 既定では、AI 関数は現在、gpt-3.5-turbo (0125) モデルを利用しています。 課金と消費率の詳細については、この記事を参照してください。
  • 基になるモデルは複数の言語を処理できますが、ほとんどの AI 関数は英語のテキストで使用できるように最適化されています。
  • AI 関数の最初のロールアウト中、ユーザーは Fabric の組み込み AI エンドポイントを使用して 1 分あたり 1,000 件の要求に一時的に制限されます。

pandas で ai.generate_response を使用する

ai.generate_response 関数は、pandas DataFrame クラスを拡張します。 ai.generate_response 関数は、pandas Series クラスを拡張するため、他の AI 関数とは異なります。 Pandas DataFrame 全体でこの関数を呼び出して、カスタム テキスト応答を行ごとに生成します。 プロンプトにはリテラル文字列を指定できます。この場合、関数は応答の生成中に DataFrame のすべての列を考慮します。 または、プロンプトに書式指定文字列を指定することもできます。この場合、関数は、プロンプトの中かっこの間に表示される列値のみを考慮します。

この関数は、入力行ごとにカスタム テキスト応答を含む pandas Series を返します。 テキスト応答は、新しい DataFrame 列に格納できます。

構文

df["response"] = df.ai.generate_response(prompt="Instructions for a custom response based on all column values")

パラメーター

名前 説明
prompt
必須		 カスタム応答の入力テキスト値に適用するプロンプト命令を含む 文字列。
is_prompt_template
任意		 プロンプトが書式文字列かリテラル文字列かを示すブール値 。 このパラメーターが Trueに設定されている場合、関数は書式指定文字列に表示される各列名の特定の行値のみを考慮します。 この場合、これらの列名は中かっこの間に含める必要があり、他の列は無視されます。 このパラメーターが既定値の Falseに設定されている場合、関数はすべての列値を各入力行のコンテキストと見なします。

収益

この関数は、各入力テキスト行のプロンプトに対するカスタム テキスト応答を含む pandas DataFrame を返します。

例

# This code uses AI. Always review output for mistakes. 
# Read terms: https://azure.microsoft.com/support/legal/preview-supplemental-terms/

df = pd.DataFrame([
        ("Scarves"),
        ("Snow pants"),
        ("Ski goggles")
    ], columns=["product"])

df["response"] = df.ai.generate_response("Write a short, punchy email subject line for a winter sale.")
display(df)

PySpark で ai.generate_response を使用する

ai.generate_response 関数は、Spark DataFramesでも使用できます。 既存の入力列の名前をパラメーターとして指定する必要があります。 また、文字列ベースのプロンプトと、そのプロンプトを書式指定文字列として扱う必要があるかどうかを示すブール値も指定する必要があります。

この関数は新しい DataFrame を返し、出力列に格納されている入力テキスト行ごとにカスタム応答を返します。

構文

df.ai.generate_response(prompt="Instructions for a custom response based on all column values", output_col="response")

パラメーター

名前 説明
prompt
必須		 カスタム応答用の入力テキスト値に適用するプロンプト命令を含む文字列 。
is_prompt_template
任意		 プロンプトが書式指定文字列かリテラル文字列かを示すブーリアン 。 このパラメーターが Trueに設定されている場合、関数は書式指定文字列に表示される各列の特定の行値のみを考慮します。 この場合、これらの列名は中かっこの間に含める必要があり、他の列は無視されます。 このパラメーターが既定値の Falseに設定されている場合、関数はすべての列値を各入力行のコンテキストと見なします。
output_col
任意		 入力テキストの各行のカスタム応答を格納する新しい列の名前を含む 文字列。 このパラメーターが設定されていない場合は、出力列の既定の名前が生成されます。
error_col
オプション		 入力テキストの各行の処理に起因する OpenAI エラーを格納する新しい列の名前を含む 文字列。 このパラメーターが設定されていない場合は、エラー列の既定の名前が生成されます。 入力行にエラーがない場合、この列の値は null。

収益

Spark DataFrameには、各入力テキスト行のプロンプトに対するカスタムテキスト応答を含む新しい列が追加されています。

例

# This code uses AI. Always review output for mistakes. 
# Read terms: https://azure.microsoft.com/support/legal/preview-supplemental-terms/

df = spark.createDataFrame([
        ("Scarves",),
        ("Snow pants",),
        ("Ski goggles",)
    ], ["product"])

responses = df.ai.generate_response(prompt="Write a short, punchy email subject line for a winter sale.", output_col="response")
display(responses)

関連コンテンツ