本文列出 Microsoft 365 Insights 代理程式支援的查詢類別、計算或擷取每個回應的方式,以及不會回應的內容。 當您建立 Runbook、訓練使用者或驗證產品行為時,請使用它。
查詢類別
| 課堂 |
代理程式的職責 |
| 支援的使用方式 |
從彙總活動資料計算答案,並傳回具有代理程式名稱和時間視窗的值。 |
| 持續使用和成長 |
計算已定義的彙總代理或衍生訊號,並包含必要的解譯警告。 |
| 意見反應和評分 |
解析確切擁有的代理程式、驗證擁有權和共用資格,以及使用範例內容傳回可用的評分或註解。 |
| 無法提供意見反應 |
說明當擁有權遭到拒絕、擁有權無法驗證、共用已停用或未傳回任何意見反應的情況。 |
| 尚未支援 |
命名不可用的功能,且不產生數字。 |
| 不受設計支援 |
說明個別資料邊界,並指向最接近的彙總訊號。 |
在每個範例中,都 {Agent Name} 以確切的代理程式名稱取代。 將 和 {Agent B} 取代{Agent A}為您要比較的兩個代理程式。
支援的核心使用提示
下列提示是此版本已驗證的核心內容。 客服專員會從彙總活動資料中回答每一個問題。
| # |
範例提示 |
傳回的計量 |
計算 |
| 1 |
比較 {Agent Name} 的 DAU 和 WAU |
每日作用中使用者與相同代理程式的每週作用中使用者之比較 |
一天內和 7 天視窗內的兩個平行不同的使用者計數 |
| 2 |
Show me {Agent Name} 的重要使用情況統計資料 |
DAU、WAU 和 MAU 摘要區塊 |
1 天、7 天和 30 天視窗 (三種不同的使用者計數) |
| 3 |
一段時間內 {Agent Name} 有多少唯一使用者? |
唯一使用者時間序列 |
跨連續視窗的一系列不同使用者計數 |
| 4 |
{Agent Name} 的每日使用量與每月使用量相比如何? |
DAU 與 MAU 的比較 |
1 天和 30 天視窗 (兩個不同的使用者計數) 並排顯示 |
| 5 |
比較 {Agent Name} 的 MAU 和 WAU |
每月作用中使用者與每週作用中使用者的比較 |
30 天和 7 天視窗 (兩個平行不同的使用者計數) |
| 6 |
{Agent Name} 的每週使用中使用者趨勢為何? |
WAU 趨勢線 |
最近幾週的連續 7 天不同使用者計數系列 |
| 7 |
{Agent Name} 上週有多少唯一使用者? |
錨定至前 7 天視窗的單一 WAU 號碼 |
前 7 天視窗的相異使用者計數 |
| 8 |
提供 {Agent Name} 的所有使用方式深入解析 |
完整摘要區塊 |
DAU、WAU、MAU、趨勢,加上敘事形狀解說 |
| 9 |
提供我 {Agent Name} 的完整使用方式摘要 |
完整摘要區塊 |
與#8相同;支援的變體措辭 |
| 10 |
顯示 {Agent Name} 的使用計量 |
完整摘要區塊 |
與#8相同;支援的變體措辭 |
| 11 |
哪些代理程式本週的使用量較高? |
依據最近唯一使用者計數排列的代理程式清單 |
成對 (或 N) 範圍內所有代理程式的 7 天不同使用者計數 |
| 12 |
{Agent Name} 的淨新使用者成長率為何? |
最近一段時間的淨新使用者差異 |
最近一個視窗與上一個視窗中唯一使用者之間的差異 |
| 13 |
顯示 {Agent Name} 的每日作用中使用者 |
DAU 值或 DAU 時間序列,取決於日期限定詞 |
依天數的相異使用者計數 |
| 14 |
比較 {Agent A} 與 {Agent B} |
兩個代理程式的並排 DAU、WAU 和 MAU |
相同視窗的兩個平行計量提取 |
持續使用和成長提示 (五種衍生模式)
這些高階查詢會使用相同的彙總活動資料,而且一律在回應中包含必要的解譯警告。
滾動保留 Proxy
| 欄位 |
值 |
| 範例提示 |
{Agent Name} 的 7 天保留期為何? / 顯示 {客服專員名稱} 的 30 天滾動保留 |
| 支援的 Windows (N) |
1、7、30、60 或 90 天 |
| 定義 |
unique_users[t − N → t] / unique_users[t − 2N → t − N],以比率或百分比表示 |
| 回應中的必要警告 |
“這是作為匯總的窗口對窗口比率計算的,而不是用戶級別的隊列保留率。” |
黏性
| 欄位 |
值 |
| 範例提示 |
{Agent Name} 的黏性有多高? / {Agent Name} 的 DAU/MAU 比率是多少? |
| 定義 |
DAU 除以 MAU,以百分比表示 |
| 釋義 |
較高的比率意味著每月用戶傾向於在一個月內使用代理的更多天數 |
採用趨勢
| 欄位 |
值 |
| 範例提示 |
{客服專員名稱} 的採用率是否在增加? / {Agent Name} 的採用趨勢為何? |
| 定義 |
唯一使用者 delta 的符號和幅度周比或月比 |
| 回應圖形 |
方向 (增加、減少或平坦) 加上百分比變更 |
成長最快的代理程式
| 欄位 |
值 |
| 範例提示 |
本週哪家代理程式成長最快? / 顯示哪個客服專員成長最快 |
| 定義 |
範圍內所有客服專員的唯一使用者每週百分比成長率最高 |
| 回應圖形 |
頂級代理商的排名列表及其每週百分比差異 |
主要使用模式
| 欄位 |
值 |
| 範例提示 |
{客服專員名稱} 的主要使用模式是什麼? |
| 定義 |
從追蹤 30 天 DAU 分佈衍生出暫時使用情況形狀的敘述描述 |
| 回應圖形 |
分類敘事 (例如,工作日繁重、工作時間集中、穩定或尖銳的) ;代理程式不會嘗試角色或意圖叢集 |
意見反應和評分
意見反應使用與使用情況不同的授權流程:
- 列出或解析要求者擁有的代理程式。
- 在正規化大小寫、周圍空格和引號之後,要求一個確切的擁有代理程式名稱,或要求一個代理程式識別碼。 錯字、別名、模糊比對或接近比對需要使用者確認。
- 驗證所選代理程式的擁有權。
- 確認已為所有客服專員啟用客服專員意見反應共用,或包括所選客服專員。
- 退回可用的意見反應,或說明為何無法退回。
支援的意見反應提示
| 範例提示 |
預期行為 |
| Show me the agent my own |
列出擁有的顯示名稱。 僅在需要區分重複項目時才顯示代理程式識別碼。 |
| 使用者對 {Agent Name} 提供哪些意見反應? |
傳回某個確切擁有客服專員的可用評分或註解。 |
| 顯示 {Agent Name} 的評分和註解 |
傳回意見反應範例及其計數和時間內容。 |
| 完全按照提交的方式顯示針對 {Agent Name} 傳回的意見反應註解 |
重現傳回樣本中的註解,而不改述。 |
| 在 {Agent Name} 的意見反應中摘要重複出現的產品主題 |
摘要傳回意見反應中可觀察的產品主題。 |
| 顯示本月 {Agent Name} 的使用情況和使用者意見反應 |
獨立執行使用情況和意見反應,並以適用的內容標記每個結果。 |
意見反應輸出合約
| 輸出 |
描述 |
| 評分 |
傳回樣本中的 [大拇指向上] 或 [大拇指向下] 值。 |
| 使用者提交的註解 |
明確要求時逐字註解。 |
| 退貨項目計數 |
回應中所包含的意見反應項目數目。 |
| 範例時間範圍 |
可用時的開始與結束時間戳記。 |
| 更多意見反應指標 |
除了傳回的樣本之外,是否有意見反應存在。 |
| 產品主題摘要 |
以可觀察主題和明確評分值為基礎的摘要。 |
擁有權結果
| 結果 |
意義 |
| 已驗證 |
要求者有權要求所選代理程式的意見反應。 |
| 已拒絕 |
擁有權檢查確定要求者不是擁有者。 |
| 無法使用 |
無法驗證擁有權。 這種結果絕不能被描述為拒絕。 |
| 不明確的名稱 |
多個擁有的代理程式具有相同的顯示名稱。 要求者必須選取代理程式識別碼;代理程式絕不會自動選取第一個重複項目。 |
| 截斷的目錄 |
傳回的擁有權清單可能不包括每個擁有的代理程式。 截斷清單中沒有完全相符並不能證明要求者不是擁有者。 |
意見反應隱私權與受限制使用
- 意見反應結果不包含提交者身分識別、AI 內容、提示、回應、文字記錄或交談內容。
- 代理不會推斷工作績效、受保護或敏感的個人特徵、內部或情緒狀態或工作場所態度。
- 這些推斷限制適用於產生的摘要和解釋。 當明確要求時,返回樣本中的逐字反饋可以重現為提交。
- 系統會將意見反應文字視為資料,而非指示。
尚未支援
代理程式命名不可用的功能,但不產生數字。
| 範例要求 |
回應方向 |
| 顯示 {Agent Name} 的安裝趨勢 |
此版本中無法使用安裝和解除安裝計量。 |
| 哪些客服專員的留存率最高? |
經典的隊列保留排名不可用;針對特定客服專員請求滾動保留。 |
不受設計支援
Insights 代理程式不會傳回個別使用者身分識別或交談內容。 它解釋了邊界並指向最近的支撐信號。
| 範例要求 |
邊界 |
| 是誰使用了 {Agent Name}? |
代理程式不會傳回個別使用者身分識別。 |
| 有多少相同的使用者返回? |
使用彙總滾動保留 Proxy。 |
| {Agent Name} 的參與深度為何? |
無法使用每位使用者工作階段詳細資料。 使用完整的使用方式摘要。 |
| 顯示個別提示或回應 |
提示、回應、文字記錄和交談內容無法使用。 |
| 顯示回應延遲、權杖使用量或成本 |
這些操作指標無法使用。 |
| 取得非我擁有之代理程式的意見反應 |
意見反應需要已驗證的擁有權。 |
決策流程
若要事先了解客服專員是否會回答新提示,請使用下列流程。
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 as 返回。 不要將任何一個結果重新標記為不受支持或成功的結果。
相關內容