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

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

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

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

Tungsten Automation は透明性のある方針に準拠し、AI 利用に関する規制ガイダンスを遵守しています。責任ある AI とコンプライアンスに向けた Tungsten Automation の取り組みについては、「AI の使用についての詳細」リンクをクリックしてください。
必要に応じて、アクティビティのデフォルトの [名前] を変更します。
[タイプ] リストで、[一般] > [生成 AI] を選択します。
[プロバイダー] リストで、OpenAI や AI エージェントといった使用する生成 AI プロバイダーを選択します。
[プロバイダー] リストには、[統合] > [生成 AI] で構成したプロバイダーが表示されます。「生成 AI と TotalAgility の統合」を参照してください。

AI エージェントプロバイダーを選択すると、(標準および追加で追加された) 入力変数と出力変数のリストが表示されます。
- 入力変数と出力変数には、静的な値または動的変数 (フォームコントロール、フォーム変数、またはグローバル変数) を設定することができます。
- 標準変数に含まれる出力変数は、チャットコントロール応答を入力するために使用されます。
プロンプトのサイズに応じて、どちらの方法でも入力を提供できます。
- 比較的小さな入力プロンプトの場合は、[入力] ボックスでアクティビティへの入力を指定します。この文字列には、プレーンテキストや変数 (XML やデータオブジェクトなど) を組み合わせることができます。たとえば、「電子メールのテキストを生成する」などが挙げられます。
  
  ドキュメント、フォルダ、複合、動的複合、チェックリスト、データバックボーンの変数はサポートされていません。
- コードブロックのように大きく詳細な入力プロンプトの場合は、 を選択します。エディタでプロンプトを入力し、[保存] をクリックします。
  - テキストエディタは Markdown コンテンツ、プレーンテキスト、変数、またはそれらの組み合わせをサポートします。
  - プロンプトで変数を使用すると、テキストエディタではその変数の内容が 2 つの中括弧内に表示されます。たとえば、変数に「Hello」というテキストが含まれている場合、エディタでは「{{Hello}}」として表示されます。

[ソース] リストで、次のいずれかのソースを選択します。

TotalAgility を以前のバージョンからアップグレードする場合に、[ソース] が [インライン画像] に設定されていた場合、[ソース] は [画像] に設定されます。

オプション	説明
[なし] (デフォルト)	AI プロバイダーからの応答は、提供された入力 (プレーンテキストまたは変数) に基づきます。
イメージ	実行時に提供されたイメージに基づいて応答が生成されます。サポートされているのはシングルページのドキュメントのみです。 [ドキュメント] リストで、いずれかの変数タイプを選択します。 [ドキュメント]: 実行時に、変数は base64 文字列を使用してドキュメントの内容を保存します。 [文字列]: いずれかの [マッピングタイプ] を選択します。インスタンス ID (デフォルト): 実行時に、変数はドキュメントのインスタンス ID を使用します。 base64 文字列形式のデータ: 実行時に、変数はドキュメントのコンテンツを base64 文字列として使用します。 [MIME の種類] リストで、ファイルのタイプを選択します。サポートされている MIME タイプは次のとおりです: GIF、JPEG、および PNG (デフォルト)。
テキスト	ドキュメントに半構造化ドキュメント (請求書、注文書など) や固定フォームなどのレイアウトテキストが含まれている場合は、カスタム LLM プロバイダーを使用するよりもテキスト形式を使用したほうがより良い結果が得られます。実行時に入力として渡されたドキュメントに基づいて応答が生成されます。 [ドキュメント] リストで、いずれかの変数タイプを選択します。 [文字列]: 実行時に、変数はドキュメントのインスタンス ID を使用します。ドキュメント (デフォルト): 実行時に、変数はドキュメントのインスタンス ID を使用します。実行時の TotalAgility のテキスト形式には、Transformation Designer でサポートされている次のようなファイルタイプがサポートされています。 TIFF (.tif) JPEG (.jpg) PNG (*.png) PDF ソース形式を [テキスト] に設定すると、標準モデル構成が使用されます。

オプション

説明

[なし] (デフォルト)

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

イメージ

実行時に提供されたイメージに基づいて応答が生成されます。

サポートされているのはシングルページのドキュメントのみです。

[ドキュメント] リストで、いずれかの変数タイプを選択します。
- [ドキュメント]: 実行時に、変数は base64 文字列を使用してドキュメントの内容を保存します。
- [文字列]: いずれかの [マッピングタイプ] を選択します。
  - インスタンス ID (デフォルト): 実行時に、変数はドキュメントのインスタンス ID を使用します。
  - base64 文字列形式のデータ: 実行時に、変数はドキュメントのコンテンツを base64 文字列として使用します。
[MIME の種類] リストで、ファイルのタイプを選択します。サポートされている MIME タイプは次のとおりです: GIF、JPEG、および PNG (デフォルト)。

テキスト

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

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

[ドキュメント] リストで、いずれかの変数タイプを選択します。

[文字列]: 実行時に、変数はドキュメントのインスタンス ID を使用します。
ドキュメント (デフォルト): 実行時に、変数はドキュメントのインスタンス ID を使用します。

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

TIFF (*.tif)
JPEG (*.jpg)
PNG (*.png)
PDF

ソース形式を [テキスト] に設定すると、標準モデル構成が使用されます。

オプション。ナレッジベースの検索時に、シード値を動的に設定できます。シード値により、繰り返しのリクエストで AI プロバイダーからより一貫性のある結果が得られる可能性が高まりますが、一貫性が保証されるわけではありません。次のいずれかを実行します。
- [シードを使用] のチェックボックスをオンにします (デフォルト: オフ)。または、 をクリックし、動的な値 (ブール値やフォームコントロールと互換性のあるフォーム変数) を選択します。
- [シード] リストで、フォーム変数またはフォームコントロールを選択するか、数値を選択します。(デフォルト: 0、最大: 32,767)。
[応答] リストで、指定された入力に対する応答を保持する変数を選択します。

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

応答にマッピングされた変数タイプに基づいて、結果が表示されます。たとえば、「空の色は青いですか?」と入力したとします。ブール変数を応答としてマッピングすると、結果に true と表示されます。応答に文字列変数をマッピングした場合、結果はテキストとして返されます。
AI プロバイダーのプロセスの [温度] を設定します。(デフォルト: 0.5、最小: 0、最大: 2)
プロバイダーからエラーが返された場合にジョブを一時停止するかどうかを指定できます。[エラー時にジョブを一時停止] するには、次のいずれかの操作を実行します。
- オプションを選択したままにする (デフォルト)。
  
  プロバイダーがソースサーバーと同じ名前および同じ ID で構成されている場合は、プロセスをエクスポートしてターゲットサーバーにインポートすると、生成 AI アクティビティが正しく実行されます。
- チェックボックスをオフにして、次のプロセス変数をマッピングする。
  - [発生したエラー] リストで、ブール変数を選択します。
  - [ステータスコード] リストで、Short 変数を選択します。
  - [エラーメッセージ] リストで、文字列変数を選択します。
  生成 AI アクティビティを実行してエラーが発生した場合、アクティビティはエラーなしで完了し、応答にマッピングされたプロセス変数には値が入力されません。
[応答が空の場合は再試行] を選択します。(デフォルト: オフ)

生成 AI アクティビティが空の応答を返した場合、システムは自動的に一度だけ呼び出しを再試行します。再試行は、手動での介入を必要とせずに有効な結果を得るために役立ちます。
プロセスマップを保存します。
このアクティビティを実行すると、システムでは次のような動作が発生します。
- 選択した AI プロバイダーに正しい入力が渡され、実行時にマッピングした変数が設定されます。
- 正しいイメージまたはドキュメントテキストが入力の一部として AI プロバイダーに渡され、応答が返されます。たとえば、ドキュメントをアップロードし、ドキュメント内の合計金額の計算をリクエストすると、AI プロバイダーによって金額が計算され、結果が返されます。
- シードは、構成に基づいて適用されます。
- 生成 AI アクティビティが実行されたという監査エントリが記録されます。
- カスタム LLM プロバイダーを使用する場合は、ドキュメントの Base 64 文字列と正しいドキュメントタイプがカスタム LLM に渡されます。