› ワークフロー › ビジネス プロセス › 基本プロセスの設計 › アクティビティの追加 › アクティビティ タイプ › 一般的なアクティビティ › 生成 AI アクティビティ › 生成 AI アクティビティの構成

生成 AI アクティビティの構成

生成 AI アクティビティを構成するには、次の手順を実行します。

  1. マップにアクティビティの追加をします。

    デフォルトでは、アクティビティの [プロパティ] パネルで [構成] タブが開きます。

  2. 必要に応じて、アクティビティのデフォルトの [名前] を変更します。
  3. [タイプ] リストで、[一般] > [生成 AI] を選択します。
  4. [プロバイダー] リストで、生成 AI プロバイダーを選択します。

    [プロバイダー] リストには、[統合] > [生成 AI] で構成したプロバイダーが表示されます。「生成 AI と TotalAgility の統合」を参照してください。

  5. [入力] ボックスで、アクティビティへの入力を指定します。この文字列には、プレーン テキストや変数 (XML やデータ オブジェクトなど) を組み合わせることができます。たとえば、「電子メールのテキストを生成する」などが挙げられます。
    次の変数はサポートされていません。ドキュメント、フォルダ、複合、動的複合、チェックリスト、およびデータ バックボーン。
  6. [ソース] リストで、次のいずれかのソースを選択します。

    [なし] (デフォルト)

    AI プロバイダーからの応答は、提供された入力 (プレーン テキストまたは変数) に基づきます。

    イメージ

    1. [ドキュメント] リストで、ドキュメント変数を選択します。

      すべての生成 AI モデルは、イメージの使用をサポートしません。これは、カスタム LLM プロバイダーにもあてはまります。

    2. [MIME の種類] リストで、ファイルのタイプを選択します。提供されたイメージに基づいて応答が生成されます。

      次の MIME の種類がサポートされています。GIF、JPEG、および PNG (デフォルト)。

    テキスト

    ドキュメントに半構造化ドキュメント (請求書、注文書など) や固定フォームなどのレイアウト テキストが含まれている場合は、カスタム LLM プロバイダーを使用するよりもテキスト形式を使用したほうがより良い結果が得られます。

    [ドキュメント] リストで、ドキュメント変数を選択します。

    実行時に入力として渡されたドキュメント テキストに基づいて応答が生成されます。

    • TotalAgility のテキスト形式には、Transformation Designer でサポートされている次のようなファイル タイプがサポートされています。

      • TIFF (*.tif)

      • JPEG (*.jpg)

      • PNG (*.png)

      • PDF

      ソース形式を [テキスト] に設定すると、標準モデル構成が使用されます。
    TotalAgility を以前のバージョンからアップグレードすると、ソース形式が [なし] に設定されます。
  7. オプション。[シードを使用] のチェック ボックスをオンにします (デフォルト: オフ)、[シード] リストでインライン値を指定するか、数値変数を選択します。(デフォルト: 0、最大: 32767)

    シード値により、繰り返しのリクエストで AI プロバイダーからより一貫性のある結果が得られる可能性が高まりますが、一貫性が保証されるわけではありません。

  8. [応答] リストで、指定された入力に対する応答を保持する変数を選択します。

    応答は、単純型の変数、XML、データ オブジェクト、およびデータ オブジェクト内のリストのみをサポートします。

    応答にマッピングされた変数タイプに基づいて、結果が表示されます。たとえば、「空の色は青いですか?」と入力したとします。ブール変数を応答としてマッピングすると、結果に true と表示されます。応答に文字列変数をマッピングした場合、結果はテキストとして返されます。

  9. AI プロバイダーのプロセスの [温度] を設定します。(デフォルト: 0.5、最小: 0、最大: 2)
  10. プロバイダーからエラーが返された場合にジョブを一時停止するかどうかを指定できます。[エラー時にジョブを一時停止] するには、次のいずれかの操作を実行します。

    • オプションを選択したままにする (デフォルト)。

      プロバイダーがソース サーバーと同じ名前および同じ ID で構成されている場合は、プロセスをエクスポートしてターゲット サーバーにインポートすると、生成 AI アクティビティが正しく実行されます。

    • チェック ボックスをオフにして、次のプロセス変数をマッピングする。

      • [発生したエラー] リストで、ブール変数を選択します。

      • [ステータス コード] リストで、Short 変数を選択します。

      • [エラー メッセージ] リストで、文字列変数を選択します。

      生成 AI アクティビティを実行してエラーが発生した場合、アクティビティはエラーなしで完了し、応答にマッピングされたプロセス変数には値が入力されません。

  11. プロセス マップを保存します。

    このアクティビティを実行すると、システムでは次のような動作が発生します。

    • 選択した AI プロバイダーに正しい入力が渡され、実行時にマッピングした変数が設定されます。

    • 正しい画像またはドキュメント テキストが入力の一部としてプロバイダーに渡され、応答が返されます。たとえば、ドキュメントをアップロードし、ドキュメント内の合計金額の計算をリクエストすると、AI プロバイダーによって金額が計算され、結果が返されます。

    • 生成 AI アクティビティが実行されたという監査エントリが記録されます。

    • カスタム LLM プロバイダーを使用する場合は、ドキュメントの Base 64 文字列と正しいドキュメント タイプがカスタム LLM に渡されます。