› ユーザー インターフェイス › フォーム › フォームのプロパティ › Copilot

Copilot

ダッシュボード、生成 AI、または AI ナレッジベースを使用して、実行時にフォーム上のデータに関する分析情報を取得できます。

[インサイトのタイプ] リストで、インサイトのタイプを選択して構成します。

メイン フォームでダッシュボード インサイト、生成 AI、または Copilot の AI ナレッジベースを有効にすると、マルチビュー フォームの子フォーム間を移動してもチャット ウィンドウが開いたままになります。コンテキストは維持され、クエリは引き続きそのまま使用されます。

  • 生成 AI インサイトを使用しているマルチビュー フォームでは、すべての子フォームにこの機能が継承され、個々のフォーム設定に関係なく、それぞれの子フォームに Copilot の構成が表示されます。

  • Copilot を使用していないマルチビュー フォームでは、各子フォームにそのフォーム固有の Copilot の構成が表示されますが、子フォーム間ではコンテキストは維持されません。

  • マルチビュー フォームでは、Web Capture コントロールの複数のインスタンスはサポートされません。

ダッシュボード

ダッシュボードを使用して、実行時にフォーム データの分析情報を取得します。フォームに少なくとも 1 つのグラフ、タイル、テーブル、作業キュー、ジョブ リスト、またはワークロード コントロールが含まれていることを確認します。ただし、生成 AI チャット コントロールは含めないようにしてください。

ダッシュボードを次のように構成します。

[ヘッダー ラベル] 実行時に表示されるダッシュボードの名前を入力します。
[プロバイダー] 生成 AI プロバイダーを選択します。(デフォルト: Tungsten)

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

カスタム LLM および AI エージェント プロバイダーはサポートされていません。

生成 AI プロバイダーが構成されていない場合は、警告メッセージが表示されます。
[会話の永続化] 選択すると、会話を継続している間にコンテキストが維持されます。(デフォルト: オフ）
会話を永続化するとトークンの使用量が増加し、トークン制限を超過する可能性があります。プロンプトがトークン制限を超過すると、トークン制限を自動的に管理するために以前の会話履歴が削除されます。トークン制限を超過した既存のメッセージとコンテキストもクリアされます。
[応答プロファイルの使用] 選択すると、応答に特定の単語数やスタイルを適用する場合に備えて、実行時に使用できる応答プロファイルが追加されます。(デフォルト: オフ）
[応答プロファイル]

をクリックしてインライン値を指定するか、文字列変数 (フォームまたはグローバル)、またはフォーム コントロールを選択します。
[シードを使用] 選択すると、シードを指定できます。(デフォルト: オフ）

インライン値を指定するか、数値変数を選択します。(デフォルト: 0、最大: 32767)

シードを使用すると、繰り返しのリクエストで AI プロバイダーからより一貫性のある結果が得られる可能性が高まりますが、一貫性が保証されるわけではありません。
デフォルト メッセージの上書き

選択した場合、[ようこそメッセージ] ボックスと [ヘルプ テキストを入力] ボックスが有効になり、実行時にチャット ウィンドウに表示されるカスタマイズされたようこそメッセージとヘルプ テキストを入力できるようになります。(デフォルト: オフ）

ようこそメッセージ

ようこそメッセージには、静的または動的な値 (フォーム コントロール、フォーム変数、またはグローバル変数)、あるいはその両方の組み合わせを指定することができます。

たとえば、メッセージとして「こんにちは!」と入力し、[名前] というフォーム変数に「John Doe」という値が含まれている場合、デフォルトの「ようこそ <ユーザー名> 様、今日は何かお手伝いできることはありますか?」は「こんにちは!」に置き換えられます。実行時には「John Doe」と表示されます。
ヘルプ テキストを入力

実行時にチャット ウィンドウに表示されるヘルプ テキストを入力します。

応答形式

応答形式にいずれかのオプションを選択します。

  • [HTML] (デフォルト): 箇条書き、見出し、および太字テキストなどの HTML 形式で応答を返すことで、構造化されたコンテンツを明確に表示し、読みやすさを向上させます。

  • [なし]: フォーマット設定されていないプレーン テキストとして応答を返します。

  • TotalAgility を 2025.2 にアップグレードすると、応答形式が [なし] に設定されます。

  • この設定は、カスタム LLM または AI エージェント AI プロバイダーを使用する場合は使用できません。
表示

実行時にフォームを開いたときに表示される Copilot チャット ウィンドウの幅を設定するには、[幅モード] にいずれかのオプションを選択します。

固定

固定に設定すると、Copilot チャット ウィンドウの幅はフォームの幅に応じて変化しなくなります。

[幅] をピクセル単位で入力します。(デフォルト: 450 px)

デフォルトでは、この設定は、フォームがアップグレードされた場合、または以前のバージョンからインポートされた場合に適用されます。
パーセント (デフォルト)

パーセントに設定すると、Copilot チャット ウィンドウの幅はフォームの幅に応じて調整されます。

[幅] をパーセントで入力し、[最小幅] をピクセルで入力します。(デフォルト: 450 px)

幅 (パーセント) が最小幅より小さい場合、Copilot チャット ウィンドウの幅は最小幅に設定されます。

[高さ] のデフォルト値は 450 ピクセルです。この値を変更すると、変更した値に応じて実行時に Copilot チャット ウィンドウが表示されます。
イベント

必要に応じてアクションを追加するには、次のイベントを構成します。フォーム コントロール イベント用のアクションの構成を参照してください。

  • 返された応答: アクションの実行時に返される応答。

  • チャットのリセット: たとえば、テーブルから行を削除するために、[行の削除] アクションを追加します。[チャットのリセット] ボタンをクリックするとアクションが実行されます。

  • プロンプトが入力されました: Copilot チャット ウィンドウにプロンプトが入力されたときに、アクションが実行されます。

実行時に、フォームの右下隅に [Copilot とチャットする] アイコンが表示されます。このアイコンをクリックすると、チャット ウィンドウが開きます。

チャット ウィンドウは、サイズを拡大または縮小したり、画面上の任意の場所に配置したりすることができます。

チャット ウィンドウでは、次の操作を実行できます。

  • Copilot チャット ボックスに「Process_1 にはいくつのアクティビティがリストされていますか?」などのリクエストを入力し、[戻る] アイコン をクリックするか、Enter を押して Copilot からの応答を取得します。

  • グラフ、タイル、テーブル、作業キュー、ジョブ リスト、ワークロード コントロールの詳細についてリクエストを行います。

    • 大規模言語モデル (LLM) では、数学的計算を実行する場合に制限があります。したがって、ダッシュボード インサイトを使用する場合は、カウント、合計、および同様のメトリックを要求すると、不正確な結果が返される可能性があります。

    • AI プロバイダーにグラフの作成をリクエストする場合は、プロンプトで HTML チャートを明示的に指定する必要があります。例: 「今週作成されたアクティブなジョブと完了したジョブの HTML グラフを作成する。」

  • 現在の会話をクリアし、新しい会話を開始するには、チャット ボックスの右上隅にある [やり直す] アイコン をクリックします。

    フォームの設計時に「会話の永続化」を選択した場合は、会話のコンテキストが維持されます。ただし、2 つの異なる形式間では会話のコンテキストが維持されません。

  • チャット ウィンドウを閉じるには、[折りたたみ] アイコン をクリックします。

生成 AI

生成 AI を使用して、添付された画像ファイル、テキスト ファイル、プレーン テキストから分析情報を取得し、実行時に一般的なクエリを処理します。

生成 AI インサイトのタイプを次のように構成します。

[ヘッダー ラベル] 実行時に表示されるヘッダーの名前を入力します。
[プロバイダー] ChatGPT OpenAI や AI エージェントといった使用する生成 AI プロバイダーを選択します。(デフォルト: Tungsten)

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

生成 AI プロバイダーが構成されていない場合は、警告メッセージが表示されます。

AI エージェント プロバイダーを選択すると、追加した入力変数と出力変数のリストが表示されます。入力変数と出力変数には、静的な値を設定するか、動的変数 (フォーム コントロール、フォーム変数、グローバル変数、および Copilot インサイト) を選択します。
ソース AI プロバイダーが応答を提供する場合にベースとなるソースを選択します。

[なし] (デフォルト)

指定された入力 (プレーン テキストまたは変数) に基づいて応答が生成されます。

イメージ

[ドキュメント] リストで、フォーム コントロール (Web Capture コントロール)、フォーム変数、または文字列型のグローバル変数を選択し、[MIME の種類] リストでファイル タイプを選択します。

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

  • フォーム変数では [MIME の種類] はサポートされていません。

  • すべての生成 AI モデルでイメージの使用がサポートされているわけではありません。

テキスト

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

[ドキュメント] リストで、フォーム コントロール (Web Capture コントロール)、フォーム変数、または文字列型のグローバル変数を選択します。

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

  • Transformation Designer でサポートされているファイル タイプ (TIFF、JPEG、PNG、および PDF) は、実行時の TotalAgility のテキスト ソース形式でサポートされています。

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

[インライン画像]

実行時に利用可能な添付ファイル アイコン をクリックして、イメージをアップロードし、それについての質問をします。アップロードした画像のサムネイルが表示されます。

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

  • ドキュメント ID を設定するために、Web capture コントロールにドキュメントを保存する必要はありません。

  • Microsoft Word ドキュメントなど、さまざまなタイプのドキュメントをアップロードできるように、Web capture コントロールで EDoc レンダリング オプションが選択されていることを確認してください。
[会話の永続化] 選択すると、会話を継続している間にコンテキストが維持されます。(デフォルト: オフ）
会話を永続化するとトークンの使用量が増加し、トークン制限を超過する可能性があります。プロンプトがトークン制限を超過すると、トークン制限を自動的に管理するために以前の会話履歴が削除されます。トークン制限を超過した既存のメッセージとコンテキストもクリアされます。
[応答プロファイルの使用] 選択すると、応答に特定の単語数やスタイルを適用する場合に備えて、実行時に使用できる応答プロファイルが追加されます。(デフォルト: オフ）
[応答プロファイル]

[応答プロファイル] リストで、 をクリックしてインライン値を指定するか、文字列変数 (フォームまたはグローバル)、またはフォーム コントロールを選択します。
[シードを使用] 選択すると、シードを指定できます。(デフォルト: オフ）

インライン値を指定するか、数値変数を選択します。(デフォルト: 0、最大: 32、767

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

選択した場合、生成 AI を使用するときに分析用のケース データが含まれます。これにより、ケース データ自体は画面で非表示のまま、ケース データを利用して自然言語クエリを通じて必要な情報を取得できるようになります。

[ケース識別子] の場合は、変数 (グローバル変数、フォーム変数、またはフォーム コントロール) を選択するか、[ケース参照] または [ケース ID] のインライン値を指定します。ケース データのリストが表示されます。デフォルトでは、主要なケースの詳細、履歴 (完全)、変数、およびメモのオプションが選択されています。必要に応じてリストから項目を選択することができます。

カスタム LLM プロバイダーを使用する場合、[ケース データを含める] は使用できません。
デフォルト メッセージの上書き

選択した場合、[ようこそメッセージ] ボックスと [ヘルプ テキストを入力] ボックスが有効になり、実行時にチャット ウィンドウに表示されるカスタマイズされたようこそメッセージとヘルプ テキストを入力できるようになります。(デフォルト: オフ）

ようこそメッセージ

ようこそメッセージには、静的または動的な値 (フォーム コントロール、フォーム変数、またはグローバル変数)、あるいはその両方の組み合わせを指定することができます。

たとえば、メッセージとして「こんにちは!」と入力し、[名前] というフォーム変数に「John Doe」という値が含まれている場合、デフォルトの「ようこそ <ユーザー名> 様、今日は何かお手伝いできることはありますか?」は「こんにちは!」に置き換えられます。実行時には「John Doe」と表示されます。
ヘルプ テキストを入力

実行時にチャット ウィンドウに表示されるヘルプ テキストを入力します。

応答形式

応答形式にいずれかのオプションを選択します。

  • [HTML] (デフォルト): 箇条書き、見出し、および太字テキストなどの HTML 形式で応答を返すことで、構造化されたコンテンツを明確に表示し、読みやすさを向上させます。

  • [なし]: フォーマット設定されていないプレーン テキストとして応答を返します。

  • TotalAgility を 2025.2 にアップグレードすると、応答形式が [なし] に設定されます。

  • この設定は、カスタム LLM または AI エージェント AI プロバイダーを使用する場合は使用できません。
表示

実行時にフォームを開いたときに表示される Copilot チャット ウィンドウの幅を設定するには、[幅モード] にいずれかのオプションを選択します。

固定

固定に設定すると、Copilot チャット ウィンドウの幅はフォームの幅に応じて変化しなくなります。

[幅] をピクセル単位で入力します。(デフォルト: 450 px)

デフォルトでは、この設定は、フォームがアップグレードされた場合、または以前のバージョンからインポートされた場合に適用されます。
パーセント (デフォルト)

パーセントに設定すると、Copilot チャット ウィンドウの幅はフォームの幅に応じて調整されます。

[幅] をパーセントで入力し、[最小幅] をピクセルで入力します。(デフォルト: 450 px)

幅 (パーセント) が最小幅より小さい場合、Copilot チャット ウィンドウの幅は最小幅に設定されます。

[高さ] のデフォルト値は 450 ピクセルです。この値を変更すると、変更した値に応じて実行時に Copilot チャット ウィンドウが表示されます。
イベント

必要に応じてアクションを追加するには、次のイベントを構成します。フォーム コントロール イベント用のアクションの構成を参照してください。

  • 返された応答: アクションの実行時に返される応答。

  • チャットのリセット: たとえば、テーブルから行を削除するために、[行の削除] アクションを追加します。[チャットのリセット] ボタンをクリックするとアクションが実行されます。

  • プロンプトが入力されました: Copilot チャット ウィンドウにプロンプトが入力されたときに、アクションが実行されます。

AI ナレッジベース

AI ナレッジベースを使用すると、ユーザーがソリューション内の自然言語クエリに対する回答を複数のドキュメントにわたって検索できるようにすることで、インサイトを得ることができます。キャプチャされたドキュメントおよびドキュメント以外のデータを含むさまざまなタイプのドキュメントをアップロードして、Azure Search に保存することで、ナレッジベースを作成することができます。この知識ベースは、大規模言語モデル (LLM) と組み合わせて自然言語を使用したクエリを実行することができます。検索を実行すると、応答は表示される前にストリーミングされます。検索をキャンセルするには、[キャンセル] ボタン をクリックします。

ナレッジベースへのアクセスは、エンタープライズ レベルの顧客のみが利用できます。標準およびアドバンスト レベルのユーザーの場合、この機能は制限されており、ロック アイコンが表示されます。

名前 説明
[ヘッダー ラベル]

実行時に表示されるヘッダーの名前を入力します。
AI ナレッジベース

構成済みの AI ナレッジベース プロバイダーを選択します。(デフォルト: Tungsten)

「AI ナレッジベースとの統合」を参照してください。
インデックス:

インデックス フィールドを追加、編集、および削除できるインデックス名のリスト。少なくとも 1 つのインデックスを指定する必要があります。
一致の最大数を上書き

選択した場合、AI ナレッジベース統合の構成時に構成したドキュメントの最大数を上書きできるようになります。(デフォルト: オフ）

「AI ナレッジベースとの TotalAgility の統合」を参照してください。
一致の最大数

上書きするドキュメントの最大数を指定します。(デフォルト: 5)

このプロパティは、「一致の最大数を上書き」が有効になっている場合にのみ使用できます。
[会話の永続化] 選択すると、会話を継続している間にコンテキストが維持されます。(デフォルト: オフ）
会話を永続化するとトークンの使用量が増加し、トークン制限を超過する可能性があります。プロンプトがトークン制限を超過すると、トークン制限を自動的に管理するために以前の会話履歴が削除されます。トークン制限を超過した既存のメッセージとコンテキストもクリアされます。
[応答プロファイルの使用] 選択すると、応答に特定の単語数やスタイルを適用する場合に備えて、実行時に使用できる応答プロファイルが追加されます。(デフォルト: オフ）
[応答プロファイル]

をクリックしてインライン値を指定するか、文字列変数 (フォームまたはグローバル)、またはフォーム コントロールを選択します。
[シードを使用] 選択すると、シードを指定できます。(デフォルト: オフ）

インライン値を指定するか、数値変数を選択します。(デフォルト: 0、最大: 32767)

シードを使用すると、繰り返しのリクエストで AI プロバイダーからより一貫性のある結果が得られる可能性が高まりますが、一貫性が保証されるわけではありません。
シード インライン値を指定するか、数値変数を選択します。(デフォルト: 0、最大: 32767)
ケース データを含める

選択した場合、生成 AI を使用するときに分析用のケース データが含まれます。これにより、ケース データ自体は画面で非表示のまま、ケース データを利用して自然言語クエリを通じて必要な情報を取得できるようになります。

[ケース識別子] の場合は、変数 (グローバル変数、フォーム変数、またはフォーム コントロール) を選択するか、[ケース参照] または [ケース ID] のインライン値を指定します。ケース データのリストが表示されます。デフォルトでは、主要なケースの詳細、履歴 (完全)、変数、およびメモのオプションが選択されています。必要に応じてリストから項目を選択することができます。

カスタム LLM プロバイダーを使用する場合、[ケース データを含める] は使用できません。
デフォルト メッセージの上書き

選択した場合、[ようこそメッセージ] ボックスと [ヘルプ テキストを入力] ボックスが有効になり、実行時にチャット ウィンドウに表示されるカスタマイズされたようこそメッセージとヘルプ テキストを入力できるようになります。(デフォルト: オフ）

ようこそメッセージ

ようこそメッセージには、静的または動的な値 (フォーム コントロール、フォーム変数、またはグローバル変数)、あるいはその両方の組み合わせを指定することができます。

たとえば、メッセージとして「こんにちは!」と入力し、[名前] というフォーム変数に「John Doe」という値が含まれている場合、デフォルトの「ようこそ <ユーザー名> 様、今日は何かお手伝いできることはありますか?」は「こんにちは!」に置き換えられます。実行時には「John Doe」と表示されます。
ヘルプ テキストを入力

実行時にチャット ウィンドウに表示されるヘルプ テキストを入力します。

応答形式

応答形式にいずれかのオプションを選択します。

  • [HTML] (デフォルト): 箇条書き、見出し、および太字テキストなどの HTML 形式で応答を返すことで、構造化されたコンテンツを明確に表示し、読みやすさを向上させます。

  • [なし]: フォーマット設定されていないプレーン テキストとして応答を返します。

  • TotalAgility を 2025.2 にアップグレードすると、応答形式が [なし] に設定されます。

  • この設定は、カスタム LLM または AI エージェント AI プロバイダーを使用する場合は使用できません。
表示

実行時にフォームを開いたときに表示される Copilot チャット ウィンドウの幅を設定するには、[幅モード] にいずれかのオプションを選択します。

固定

固定に設定すると、Copilot チャット ウィンドウの幅はフォームの幅に応じて変化しなくなります。

[幅] をピクセル単位で入力します。(デフォルト: 450 px)

デフォルトでは、この設定は、フォームがアップグレードされた場合、または以前のバージョンからインポートされた場合に適用されます。
パーセント (デフォルト)

パーセントに設定すると、Copilot チャット ウィンドウの幅はフォームの幅に応じて調整されます。

[幅] をパーセントで入力し、[最小幅] をピクセルで入力します。(デフォルト: 450 px)

幅 (パーセント) が最小幅より小さい場合、Copilot チャット ウィンドウの幅は最小幅に設定されます。

[高さ] のデフォルト値は 450 ピクセルです。この値を変更すると、変更した値に応じて実行時に Copilot チャット ウィンドウが表示されます。
イベント

必要に応じてアクションを追加するには、次のイベントを構成します。フォーム コントロール イベント用のアクションの構成を参照してください。

  • 返された応答: アクションの実行時に返される応答。

  • クリックされたドキュメント: たとえば、Web Capture コントロールにドキュメントが表示されるようにするには、同じページ アクションを追加します。ドキュメントをクリックするとアクションが実行されます。

    クリックしたドキュメントのドキュメント ID へのアクセス権が割り当てられている必要があります。

  • チャットのリセット: たとえば、テーブルから行を削除するために、[行の削除] アクションを追加します。[チャットのリセット] ボタンをクリックするとアクションが実行されます。

  • プロンプトが入力されました: Copilot チャット ウィンドウにプロンプトが入力されたときに、アクションが実行されます。

実行時に、[Copilot とチャットする] アイコンをクリックすると、チャット ウィンドウを開くことができます。チャット ウィンドウでは、次の操作を実行できます。

  • 入力として画像またはテキストを入力し、AI プロバイダーからの応答をリクエストします。たとえば、車の登録証の画像をアップロードし、AI プロバイダーに応答として登録番号を取得するようにリクエストします。リクエストを入力すると、応答は表示される前にストリーミングされます。リクエストをキャンセルするには、[キャンセル] ボタン をクリックします。

  • 現在の会話をクリアし、新しい会話を開始するには、チャット ボックスの右上隅にある [新しいチャット] アイコン をクリックします。

    フォームの設計時に「会話の永続化」を選択した場合は、会話のコンテキストが維持されます。ただし、2 つの異なる形式間では会話のコンテキストが維持されません。

  • 実行時にケース データを含めて Copilot と対話を行うと、検索に使用できる情報と応答にケースの詳細が含まれます。

  • Copilot で構成し、生成 AI インサイトのタイプとして設定したフォームを使用している場合に、Copilot チャット ウィンドウでプロンプトを送信すると、監査ログにエントリが記録されます。