Operations エージェントのベスト プラクティスと制限事項

この記事では、Real-Time インテリジェンスで運用エージェントを使用する場合のベスト プラクティスと制限事項について説明します。

ベスト プラクティス

運用エージェントは、リアルタイム データを継続的に監視し、明示的なしきい値を評価し、定義された条件が満たされたときにアクションを推奨することで、組織が明確なビジネス目標を運用化するのに役立ちます。 たとえば、運用エージェントは、インベントリの可用性が重要なレベルに低下した場合に、事前に対応するのに役立ちます。 運用エージェントには、次のベスト プラクティスを使用します。

  • Eventhouse テーブル: EVENTHOUSE テーブルに JSON などの入れ子になった列が含まれている場合は、エージェントを構成する前にテーブルをフラット化します。 わかりやすい列名を持つフラット テーブルにより、エージェントがデータを解析および評価する機能が向上します。

  • Eventhouse 列の説明: 列の目的が名前から不明な場合は、KQL テーブル スキーマの description フィールドを使用して、プレーン言語の説明を追加します。 この説明は、エージェントがデータ値を正しく解釈するのに役立ちます。

  • インジェスト時間列: 操作エージェントは、既定でテーブルのインジェスト時間を使用してレコードが到着した時刻を識別します。 エージェントは、最新のデータのクエリを実行し、時間の経過に伴うデータの変更を計算するときに、この値を使用します。 取り込み時刻が入力されていることを確認してください。

  • ビジネス オブジェクトの識別: エージェントがステーション、センサー、人事レコードなどの特定のビジネス オブジェクトを監視する必要がある場合は、オブジェクトを一意に識別する列 ( StationID や SensorIDなど) を識別します。 KQL データベース ソースを使用している場合は、それが属するテーブルを指定します。 オントロジ ソースを使用している場合は、エージェントが使用するエンティティを指定します。

  • フィールド名の引用符: ルールが、アンダースコアやハイフンなどの特殊文字を含む列またはプロパティ名を参照する場合は、列名を引用符 ("") で囲みます。 この方法により、エージェントによって正しく識別されます。

  • 定量化可能な条件: ルールで "低可用" や "高温" などの定性言語を使用する場合は、それを特定の数値しきい値に置き換えます。

    • たとえば、"利用可能な自転車が 3 台未満" や "温度が 80 を超える" などの語句を使用します。 エージェントは、既定の LLM ナレッジを使用して、"酸性条件" などの一般的な用語のしきい値を提案します(pH <7 を意味します)。

  • ルールの分離: 複数のルールを定義する場合は、各ルールを個別の行または箇条書きで記述します。 同じ文内の異なるルールの条件を組み合わせないでください。

  • ルールの順序: エージェントが特定のルールに優先順位を付ける必要がある場合は、優先順位の高いルールを最初に一覧表示します。 LLM は、プロンプトでの位置に基づいて情報を解釈する方法が異なる場合があります。

  • エージェントのクエリとデータ アクセスを追跡します。 監視対象の Eventhouse または KQL データベースを調べて、エージェントが使用するデータ ソースとクエリを確認します。 [クエリ分析情報] タブを使用して、実行されたクエリを表示し、生成された KQL を検証します。

    KQL データベースの [クエリ分析情報] タブのスクリーンショット。

指示のサンプル

操作ルールとデータ内のフィールドに関するセマンティック情報を明確にするために、エージェントに指示をレイアウトする方法の例を次に示します。

*** Operational Instructions ***
1. Alert me when a trip has high occupancy level.
2. Alert me when a trip has high departure delay.

*** Semantic Instructions ***
1. Information about a trip can be found in 'TripUpdateFlattened' table, each identified by the 'trip_id' column.
2. Information about a vehicle can be found in 'VehiclePositionsFlat' table, each identified the 'vehicle_id' column.
3. A trip is a associated with multiple vehicles via shared trip ID.
4. Occupancy status of a trip is calculated as the latest occupancy status from the vehicle the trip is associated with. The value 'HIGH' means high occupancy level.
5. The departure delay is measured in number of seconds. Higher than 300 seconds of delay is considered significant.

制限事項

運用エージェントには、ルールと監視シナリオを設計する際に考慮する必要がある機能、プラットフォーム、および動作の制限があります。

データ ソースの制限事項

  • 現在、運用エージェントは通常の Eventhouse テーブルの監視データのみをサポートしています。 ショートカット テーブル、関数、具体化されたビューはサポートされていません。
  • エージェントのデータ ソースとして Fabric Ontology を使用する場合:
    • オントロジは、オペレーション エージェントと同じワークスペースに存在する必要があります。
    • エージェントで監視するオントロジ エンティティには、エンティティの識別子として使用する静的プロパティが少なくとも 1 つ必要です。 時系列プロパティは、eventhouse フィールドにバインドする必要があります。

監視とルールの制限

  • オントロジ監視では、基本的なプロパティ値のみがサポートされます。 平均値、最小値、最大値などの集計はサポートされていません。
  • "AND" 条件を必要とするルールはサポートされていません (たとえば、ランウェイのブレーキ インデックスが 0.8 を超え、サーフェス温度が 40 < )。

言語とモデルの動作の制限

ランタイムの制限事項

  • エージェントは、アクティブなときに 5 分ごとにクエリを実行します。
  • 操作は、3 日以内に何も実行されない場合に有効期限が切れます。 有効期限が切れた後は、アクションを承認できなくなります。

アクセス許可とアクセス制限

  • エージェントは、その作成者の委任された ID とアクセス許可を使用して動作します。 これはですね：
    • クエリとアクションでは、作成者の資格情報が使用されます。
    • 既定では、作成者はレコメンデーション メッセージを受信します。 受信者を変更しても、クエリとアクションに使用される資格情報は変更されません。

メッセージングとスロットリングの制限事項

  • 大量に使用すると、メッセージのスロットリングが発生する可能性があります。 このような場合、簡略化された LLM で生成されていないメッセージがMicrosoft Teamsで送信される可能性があります。

リージョンとワークスペースの制限事項

  • Last updated on