この記事では、Microsoft 365 Insights エージェントがサポートするクエリ クラス、各応答の計算方法または取得方法、応答しないクエリ クラスの一覧を示します。 Runbook の作成、ユーザーのトレーニング、または製品の動作の検証に使用します。
クエリ クラス
| クラス |
エージェントが行うこと |
| サポートされている使用法 |
集計アクティビティ データから回答を計算し、エージェント名と時間枠で値を返します。 |
| 持続的な使用と成長 |
定義された集約プロキシまたは派生信号を計算し、必要な解釈の警告を含めます。 |
| フィードバックと評価 |
正確に所有されているエージェントを解決し、所有権と共有の適格性を確認して、利用可能な評価またはコメントをサンプル コンテキストと共に返します。 |
| フィードバックが利用できない |
所有権が拒否されたとき、所有権を確認できない場合、共有が無効になったとき、またはフィードバックが返されない場合について説明します。 |
| まだサポートされていません |
使用できない機能に名前を付けますが、数値は生成しません。 |
| 仕様ではサポートされていません |
個別データの境界を説明し、最も近い集計信号を指します。 |
すべての例で、 {Agent Name} 正確なエージェント名に置き換えます。
{Agent A}と {Agent B} を、比較する 2 つのエージェントに置き換えます。
サポートされているコア使用状況のプロンプト
次のプロンプトは、このリリースの検証済みのコアです。 エージェントは、集約されたアクティビティ データからそれぞれに回答します。
| # |
プロンプトの例 |
メトリックが返される |
計算 |
| 1 |
{Agent Name} の DAU と WAU を比較する |
同じエージェントについて、毎日のアクティブ ユーザーと毎週のアクティブ ユーザーを比較した |
1 日および 7 日間のウィンドウにおける 2 つの並列個別ユーザーカウント |
| 2 |
Show me {Agent Name} のキー使用状況統計 |
DAU、WAU、および MAU の概要ブロック |
3 つの個別ユーザー数 (1 日、7 日、30 日のウィンドウ) |
| 3 |
{Agent Name} の一意のユーザーは何人存在しましたか? |
一意のユーザーの時系列 |
連続するウィンドウにわたる一連の個別のユーザー数 |
| 4 |
{Agent Name} の 1 日の使用量と月間の使用量はどのように比較されますか? |
MAU と DAU の比較 |
2 つの個別のユーザー数 (1 日と 30 日のウィンドウ) が並んで表示されています |
| 5 |
{Agent Name} の MAU と WAU の比較 |
月間アクティブ ユーザーと週次アクティブ ユーザーとの比較 |
2 つの並列個別ユーザー数 (30 日と 7 日) |
| 6 |
{Agent Name} の週間アクティブ ユーザーの傾向を教えてください。 |
WAU 傾向線 |
ここ数週間にわたる一連の 7 日間の個別ユーザー数 |
| 7 |
先週、{Agent Name} に存在した一意のユーザーは何人いましたか? |
前の 7 日間のウィンドウに固定された単一の WAU 番号 |
過去 7 日間の個別のユーザー数 |
| 8 |
{Agent Name} のすべての使用状況の分析情報を提供します |
完全な要約ブロック |
DAU、WAU、MAU、トレンドに加えて、物語の形の解説 |
| 9 |
{Agent Name} の完全な使用状況の概要を教えてください |
完全な要約ブロック |
#8と同じ。バリアントの言い回しをサポート |
| 10 |
Show me usage metrics for {Agent Name} |
完全な要約ブロック |
#8と同じ。バリアントの言い回しをサポート |
| 11 |
今週の使用量が多いエージェントはどれですか? |
最近のユニーク ユーザー数別のエージェントのランク付けリスト |
スコープ内のエージェント間でのペアワイズ (または N ワイア) の一種の 7 日間の個別のユーザー数 |
| 12 |
{Agent Name} の純新規ユーザー増加率はどのくらいですか? |
最近のウィンドウ間の純新規ユーザー デルタ |
最新のウィンドウと前のウィンドウの一意のユーザーの違い |
| 13 |
{エージェント名} の毎日のアクティブ ユーザーを表示する |
日付修飾子に応じた DAU 値または DAU 時系列 |
日別の個別ユーザー数 |
| 14 |
{エージェント A} と {エージェント B} の比較 |
2 つのエージェント用の DAU、WAU、MAU のサイドバイサイド |
同じウィンドウに対する 2 つの並列メトリックプル |
持続的な使用と成長のプロンプト (5 つの派生パターン)
これらの高次クエリでは、同じ集計アクティビティ データが使用され、応答に必要な解釈上の警告が常に含まれます。
ローリング保持プロキシ
| フィールド |
値 |
| プロンプトの例 |
{Agent Name} の 7 日間のリテンション期間はどのくらいですか? / {Agent Name} の 30 日間のローリング リテンション期間を表示する |
| サポートされている Windows (N) |
1、7、30、60、または 90 日 |
| 定義 |
unique_users[t − N → t] / unique_users[t − 2N → t − N]、比率またはパーセンテージで表される |
| 対応に必要な警告 |
「これは、ユーザーレベルのコホートリテンションではなく、ウィンドウオーバーウィンドウの総計比率として計算されます。」 |
持続性
| フィールド |
値 |
| プロンプトの例 |
{エージェント名} の粘着性はどのくらいですか? / {Agent Name} の DAU/MAU 比率はいくらですか? |
| 定義 |
DAU を MAU で割り、パーセンテージで表します |
| 解釈 |
比率が高いということは、月間ユーザーが月内のより多くの日にエージェントを使用する傾向があることを意味します |
導入傾向
| フィールド |
値 |
| プロンプトの例 |
{エージェント名} の採用は増加していますか? / {Agent Name} の導入傾向はどのようなものですか? |
| 定義 |
一意ユーザーのデルタの符号と大きさ (週ごとまたは月ごと) |
| 応答図形 |
方向 (増加、減少、または横ばい) と変化率 |
最も急成長しているエージェント
| フィールド |
値 |
| プロンプトの例 |
今週最も急成長しているエージェントはどれですか? / どのエージェントが最も急速に成長しているかを示す |
| 定義 |
スコープ内のエージェント全体での一意のユーザーの前週比で最も高い割合の増加率 |
| 応答図形 |
週ごとのパーセンテージ差分を含む上位エージェントのランク付けされたリスト |
主な使用パターン
| フィールド |
値 |
| プロンプトの例 |
{Agent Name} の主な使用パターンは何ですか? |
| 定義 |
過去 30 日間の DAU 分布から導き出された、時間的な使用状況の形状の説明。 |
| 応答図形 |
カテゴリ別の物語 (例: 平日が多い、営業時間が集中している、定常している、またはスパイクしている)エージェントがペルソナまたはインテントのクラスタリングを試みない |
フィードバックと評価
フィードバックでは、使用状況とは別の承認フローを使用します。
- 要求者が所有するエージェントを一覧表示または解決します。
- 大文字小文字、周囲の空白、引用符を正規化した後、1 つの正確な所有エージェント名を要求するか、エージェント ID を要求します。 タイプミス、エイリアス、あいまい一致、または近接一致を使用するには、ユーザーの確認が必要です。
- 選択したエージェントの所有権を確認します。
- エージェント フィードバックの共有がすべてのエージェントに対して有効になっているか、選択したエージェントが含まれていることを確認します。
- 利用可能なフィードバックを返すか、返却できない理由を説明します。
サポートされているフィードバック プロンプト
| プロンプトの例 |
予想される動作 |
| Show me the agent my own (所有するエージェントを表示する) |
所有している表示名を一覧表示します。 重複を区別する必要がある場合にのみエージェント ID を表示します。 |
| {Agent Name} についてユーザーからどのようなフィードバックが寄せられましたか? |
1 つの完全に所有されているエージェントに対して利用可能な評価またはコメントを返します。 |
| {エージェント名} の評価とコメントを表示する |
フィードバックのサンプルをカウントと時間のコンテキストと共に返します。 |
| {Agent Name} に対して返されたフィードバック コメントを、送信されたとおりに正確に表示します |
返されたサンプル内のコメントを言い換えずに再現します。 |
| {Agent Name} へのフィードバックで頻繁に行われる製品トピックを要約する |
返されたフィードバックから観察可能な製品トピックを要約します。 |
| {Agent Name} の今月の使用状況とユーザー フィードバックを表示する |
使用状況とフィードバックを個別に実行し、各結果に該当するコンテキストでラベル付けします。 |
フィードバック出力コントラクト
| 出力 |
説明 |
| 評価 |
返されるサンプルでの GOOD または BAD の値。 |
| ユーザーが送信したコメント |
明示的に要求された場合の逐語的コメント。 |
| 返品アイテム数 |
応答に含まれるフィードバック項目の数。 |
| サンプル時間枠 |
開始タイムスタンプと終了タイムスタンプ (使用可能な場合)。 |
| その他のフィードバック インジケーター |
返されたサンプルの外部にフィードバックが存在するかどうか。 |
| 製品トピックの概要 |
観察可能なトピックと明示的なレーティング値に基づく要約。 |
所有権の成果
| 結果 |
意味 |
| 検証済み |
要求元は、選択したエージェントのフィードバックを要求する権限があります。 |
| 拒否されました |
所有権チェックにより、要求者が所有者ではないことが判断されました。 |
| 使用不可 |
所有権を確認できませんでした。 この結果を否定として説明してはなりません。 |
| あいまいな名前 |
複数の所有エージェントに同じ表示名が付いている。 依頼者はエージェント ID を選択する必要があります。エージェントは、最初の重複を自動的に選択しません。 |
| カタログの切り捨て |
返された所有権リストには、すべての所有エージェントが含まれているとは限りません。 切り捨てられたリストに完全一致がない場合でも、要求元が所有者ではないという証明にはなりません。 |
フィードバック、プライバシー、制限付き使用
- フィードバックの結果には、提出者 ID、AI コンテキスト、プロンプト、回答、トランスクリプト、会話内容は含まれません。
- エージェントは、仕事のパフォーマンス、保護されたまたはセンシティブな個人の特徴、内部または感情の状態、または職場の態度を推測しません。
- これらの推論の制限は、生成された要約と解釈に適用されます。 明示的に要求された場合、返されたサンプルの逐語的なフィードバックは送信されたとおりに再現できます。
- フィードバック テキストは、指示としてではなくデータとして扱われます。
まだサポートされていません
エージェントは、番号を生成せずに使用できない機能に名前を付けます。
| 要求の例 |
応答の方向 |
| {Agent Name} のインストール傾向を表示する |
このリリースでは、インストールおよびアンインストールのメトリックは使用できません。 |
| どのエージェントのリテンションが最も良好ですか? |
古典的なコホートリテンションランキングは利用できません。特定のエージェントのローリング保持を要求します。 |
仕様ではサポートされていません
Insights エージェントは、個々のユーザー ID や会話の内容を返しません。 境界を説明し、サポートされている最も近い信号を指します。
| 要求の例 |
境界 |
| {エージェント名} を使用したのは誰ですか? |
エージェントは個々のユーザー ID を返しません。 |
| 同じユーザーのうち何人が戻ってきたか |
集約ローリング保持プロキシを使用します。 |
| {エージェント名} のエンゲージメントの深さは? |
ユーザーごとのセッションの詳細は使用できません。 使用状況の完全な概要を使用します。 |
| 個別のプロンプトまたは応答を表示する |
プロンプト、応答、トランスクリプト、会話コンテンツは使用できません。 |
| 応答の待機時間、トークンの使用状況、またはコストの表示 |
これらの操作メトリックは使用できません。 |
| 所有していないエージェントのフィードバックを取得する |
フィードバックには、確認済みの所有権が必要です。 |
意思決定フロー
エージェントが新しいプロンプトに応答するかどうかを事前に確認するには、次のフローを使用します。
Does the request combine usage and feedback?
YES -> Send the original request to usage and independently resolve one exact owned agent for feedback.
NO -> continue
Does the request ask only which agents the requester owns?
YES -> List owned agents. If duplicate names exist, require Agent ID selection; if the catalog is truncated, disclose that the list may be incomplete.
NO -> continue
Does the request ask for ratings, comments, thumbs, or feedback?
YES -> Resolve one exact owned agent, verify ownership and sharing, then return feedback or a scoped explanation.
NO -> continue
Does the request ask for a supported aggregate usage metric?
YES -> Return the grounded metric with the agent name and time window.
NO -> continue
Does the request ask for rolling retention, stickiness, adoption trend, fastest-growing, or a usage pattern?
YES -> Return the derived aggregate signal and its required caveat.
NO -> continue
Does the request require individual identity, install data, latency, token usage, cost, prompts, responses, or transcripts?
YES -> Explain the boundary and point to the closest supported signal.
NO -> Return the generic out-of-scope response.
サポートされているツール呼び出しの後、返された NoData と DownstreamError を保持します。 いずれの結果も、サポートされていない結果または成功した結果として再ラベル付けしないでください。
関連情報