› 統合 › AI ナレッジベース › AI ナレッジベースとの TotalAgility の統合

AI ナレッジベースとの TotalAgility の統合

TotalAgility を AI ナレッジベースと統合するには、次の手順を実行します。AI ナレッジベース統合は、追加、変更、または削除することができます。

  1. [統合] > [AI ナレッジベース] に移動します。

    [AI ナレッジベース] ページが表示されます。デフォルトでは、Tungsten ナレッジベース プロバイダーが表示されます。

  2. 新しいプロバイダーを構成するには、[新規] をクリックします。

    [新しい AI ナレッジベースの構成] ダイアログ ボックスが表示されます。

  3. 次のような [全般] プロパティを構成します。

    • TotalAgility は API バージョンを内部的に処理するため、URL には含めないようにしてください。

    • 次の API キーでサポートされる最大長は 2,000 文字です。Azure AI Document Intelligence の API キー、Azure AI 検索の API キー、埋め込みの API キー、および Azure Open AI プロバイダーの API キー。

    プロパティ

    説明

    [ID]

    AI ナレッジベース統合を識別するための ID。

    [表示名]

    AI ナレッジベースの構成の名前。

    [説明]

    オプション。AI ナレッジベース統合に関する簡単な説明、または追加情報。

    ドキュメントのチャンク

    Azure AI Document Intelligence の URL

    URL には、使用するドキュメント インテリジェンス モデルが含まれています。Azure Document Intelligence サービスは、顧客ケースのドキュメントをチャンク/セクションにインテリジェントに変換します。
    [カスタム API キーヘッダーを使用]

    API キー認証の API キー ヘッダー名。(デフォルト: オフ)

    API キー認証の場合は [API キー ヘッダー名] を指定します。指定しない場合は、デフォルトの API キー ヘッダー名が使用されます。

    Azure AI Document Intelligence の API キー

    Azure Document Intelligence サービスにアクセスするために必要な API キーは、セキュリティを確保するために暗号化されています。サポートされている API キーのバージョンは 2024-11-30 です。

    ストレージと検索

    Azure AI 検索の URL

    統合する AI 検索サービスの URL。
    [カスタム API キーヘッダーを使用]

    API キー認証の API キー ヘッダー名。(デフォルト: オフ)

    API キー認証の場合は [API キー ヘッダー名] を指定します。指定しない場合は、デフォルトの API キー ヘッダー名が使用されます。

    Azure AI 検索の API キー

    AI 検索サービスにアクセスするために使用される API キー。このキーはセキュリティを確保するために暗号化されており、サポートされている API キーのバージョンは 2024-07-01 です。

    埋め込みの URL

    Azure Open AI 埋め込みモデルの展開の URL。これは、ベクトル ベースの検索が容易にするためのチャンク テキストと検索テキストの埋め込み/ベクトルを作成する場合に使用します。
    [カスタム API キーヘッダーを使用]

    API キー認証の API キー ヘッダー名。(デフォルト: オフ)

    API キー認証の場合は [API キー ヘッダー名] を指定します。指定しない場合は、デフォルトの API キー ヘッダー名が使用されます。

    埋め込みの API キー

    埋め込みモデルにアクセスするためのドキュメントのチャンク/ベクトル ストレージと検索の設定に使用される API キー。このキーはセキュリティを確保するために暗号化されており、サポートされている API キーのバージョンは 2024-10-21 です。

    インデックス:

    寸法を定義し、インデックス フィールドを追加してインデックスを作成します。

    寸法: 最適なパフォーマンスを得るために、モデルに応じてサポートされる寸法 (数値) が異なる場合があります。したがって、使用する埋め込みモデルの寸法を定義するようにしてください。デフォルト値を使用するか、寸法のインライン値を指定します。インライン値を指定すると、構成された埋め込みモデルでは、ナレッジベースにドキュメントを追加するときに、指定されたインデックスが使用されます。インデックスを作成した後に、寸法の設定を変更することはできません。

    インデックス フィールド: 必要に応じて、[表示名] と [ID] を指定してインデックス フィールドを追加します。インデックス フィールド ID には、大文字または小文字、数字、または下線のみを含める必要があります。最初の文字を数字にすることはできず、文字数は 1 ～ 100 文字に制限されます。

    AI ナレッジベースの構成を保存すると、指定したすべてのインデックスが Azure AI Search で自動的に作成されます。既存のインデックスは、TotalAgility で要求されたものと同じ内部フィールドが含まれていることを確認するために検証されます。

    LLM 分析とインサイト

    Azure Open AI プロバイダーの URL

    Azure Open AI プロバイダーの URL。
    [カスタム API キーヘッダーを使用]

    API キー認証の API キー ヘッダー名。(デフォルト: オフ)

    API キー認証の場合は [API キー ヘッダー名] を指定します。指定しない場合は、デフォルトの API キー ヘッダー名が使用されます。

    Azure Open AI プロバイダーの API キー

    Azure Open AI プロバイダーに使用される API キー。このキーはセキュリティを確保するために暗号化されており、サポートされている API キーのバージョンは 2024-10-21 です。

    クエリ タイプ

    Azure AI Search インデックス用に以前に作成されたデフォルトのセマンティック構成を TotalAgility が指定するためのクエリ タイプ。次のようなクエリ タイプを使用することができます。

    • シンプル (デフォルト): シンプルなクエリ パーサーを表します。

    • セマンティック: 高度なセマンティック モデリングのためのセマンティック クエリ パーサーを表します。

    • ベクトル: 計算されたデータに対するベクトル検索を表します。

    • ベクトル シンプル ハイブリッド: シンプルなクエリ戦略とベクトル データの組み合わせを表します。

    • ベクトル セマンティック ハイブリッド: セマンティック検索とベクトル データ クエリの組み合わせを表します。

    一致の最大数

    クエリに設定されているドキュメントの最大数。(デフォルト: 5、最小: 3、最大: 20)

    厳密性

    検索関連性フィルタリングの厳密性のレベル。厳密性の値を高くすると、精度は高くなりますが再現率は低くなります。(デフォルト: 3、最小: 1、最大: 5)
    タイムアウト (秒)

    各プロバイダーのタイムアウト期間 (秒単位)。(デフォルト: 300、最小: 120、最大: 3600)

    テキスト生成やイメージ処理などのリクエストを AI モデルに送信した場合、タイムアウト期間を設定することで、リクエストが無期限に応答しなくなることを回避できます。これは、他のプロバイダーよりも遅く、パフォーマンスを最適化するために時間調整が必要なプロバイダーに対して特に有効です。

    たとえば、テキスト生成リクエストのタイムアウト期間を 120 秒に設定した場合、システムは AI が応答を生成するまで最大 120 秒間待機します。待機時間の終了時までに応答が生成されない場合、システムはリクエストを終了し、エラーを返します。
    再試行回数

    各プロバイダーに対して失敗した操作をシステムが再試行する回数。再試行後、システムは操作を中止し、失敗応答を返します。(デフォルト: 5、最小: 0、最大: 100)。

    たとえば、再試行回数を 3 に設定すると、システムは失敗した要求を最大 3 回まで再送信し、リクエストが引き続き失敗する場合はエラーを返します。

    AI モデルを使用している場合、タイムアウトと再試行回数の設定は、Copilot、抽出用 Copilot、ダッシュボード インサイト、Copilot インサイト、ビジョンの使用に適用されます。

  4. [アクセス制御] タブで検索アクセス権限 ([フル コントロール] または [アクセス権がある]) を設定します。実行時に Azure AI ナレッジベース構成を使用して検索するためのアクセス権は、各 AI ナレッジベース構成に対して定義された権限によって制御されます。AI ナレッジベース検索は、現在のユーザーのセキュリティ権限に基づいて行われます。デフォルトでは、全員に [フル コントロール] の権限が付与されています。
  5. 構成を保存するには、[保存] をクリックします。

    構成が保存され、[AI ナレッジベース] ページに表示されます。既存の AI ナレッジベース統合は変更および削除することができます。

方法: AI ナレッジベース統合の管理

Tungsten AI ナレッジベース プロバイダー

Tungsten AI ナレッジベース プロバイダーは、AI ナレッジベースで使用するためのすぐに使用できる AI プロバイダーです。Tungsten AI ナレッジベース プロバイダーを削除することはできません。

Tungsten AI プロバイダーは、TotalAgility 2025.2 でデフォルトで使用することができます。次の設定が含まれます。

プロパティ

説明

[表示名]

Tungsten ナレッジベース プロバイダーの名前。(読み取り専用)

インデックス:

インデックス フィールドを追加してインデックスを作成します。

インデックス フィールド: 必要に応じて、[表示名] と [ID] を指定してインデックス フィールドを追加します。インデックス フィールド ID には、大文字または小文字、数字、または下線のみを含める必要があります。最初の文字を数字にすることはできず、文字数は 1 ～ 100 文字に制限されます。

共有ライセンスを使用している場合、これらのインデックスはデータベースに保存されるため、TotalAgility のこのインスタンスで作成されたインデックスのみを表示できます。

AI ナレッジベースの構成を保存すると、指定したすべてのインデックスが Azure AI Search で自動的に作成されます。既存のインデックスは、TotalAgility で要求されたものと同じ内部フィールドが含まれていることを確認するために検証されます。

  • 共有ライセンスを使用している場合、新しいインデックスを作成することはできませんが、データベースに保存されている TotalAgility の現在のインスタンスのインデックスのみを表示できます。

  • TotalAgility オンプレミスのマルチテナント環境では、テナント専用データベースに保存されるインデックスは、そのテナント専用に作成されたものだけを表示できます。ただし、インデックス サービスはすべてのテナント間で共有されるため、インデックス名は一意である必要があります。テナントで既存の名前のインデックスの作成が試行された場合は、競合を示すエラー メッセージが表示されます。

クエリ タイプ

Azure AI Search インデックス用に以前に作成されたデフォルトのセマンティック構成を TotalAgility が指定するためのクエリ タイプ。次のようなクエリ タイプを使用することができます。[シンプル] (デフォルト)、[セマンティック]、[ベクトル]、[ベクトル シンプル ハイブリッド]、および [ベクトル セマンティック ハイブリッド]。

一致の最大数

クエリに設定されているドキュメントの最大数。(デフォルト: 5、最小: 3、最大: 20)

厳密性

検索関連性フィルタリングの厳密性のレベル。厳密性の値を高くすると、精度は高くなりますが再現率は低くなります。(デフォルト: 3、最小: 1、最大: 5)
タイムアウト (秒)

各プロバイダーのタイムアウト期間 (秒単位)。(デフォルト: 300、最小: 120、最大: 3600)
再試行回数

各プロバイダーに対して失敗した操作をシステムが再試行する回数。再試行後、システムは操作を中止し、失敗応答を返します。(デフォルト: 5、最小: 0、最大: 100)。

関連付けの表示

Tungsten ナレッジベース プロバイダーに関連付けられている項目の一覧を表示できます。

  1. AI ナレッジベースのリスト ページに移動します。

    [AI ナレッジベース] ページには、デフォルトで Tungsten ナレッジベース プロバイダーが表示されます。

  2. Tungsten ナレッジベース プロバイダーのコンテキスト メニューで、[関連付け] をクリックします。

    Tungsten ナレッジベース プロバイダーを使用しているアクティビティのリストが表示されます。