Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo elenca le classi di query supportate dall'agente Microsoft 365 Insights, il modo in cui calcola o recupera ogni risposta e cosa non risponde. Usalo quando crei un runbook, formi gli utenti o convalidi il comportamento del prodotto.
Classi di query
| Classe | Cosa fa l'agente |
|---|---|
| Utilizzo supportato | Calcola la risposta dai dati aggregati dell'attività e restituisce il valore con il nome dell'agente e l'intervallo di tempo. |
| Utilizzo e crescita sostenuti | Calcola un proxy aggregato definito o un segnale derivato e include le avvertenze di interpretazione necessarie. |
| Feedback e valutazioni | Risolve un agente di proprietà esatta, verifica l'idoneità alla proprietà e alla condivisione e restituisce le valutazioni o i commenti disponibili con il contesto del campione. |
| Feedback non disponibile | Spiega quando la proprietà viene negata, la proprietà non può essere verificata, la condivisione è disabilitata o non viene restituito alcun feedback. |
| Non ancora supportato | Assegna un nome alla funzionalità non disponibile e non genera un numero. |
| Non supportato dalla progettazione | Spiega il limite dei singoli dati e punta al segnale aggregato più vicino. |
In ogni esempio sostituire {Agent Name} con il nome esatto di un agente. Sostituisci {Agent A} e {Agent B} con i due agenti che vuoi confrontare.
Richieste di utilizzo di base supportate
I prompt seguenti sono il nucleo convalidato della versione. L'agente risponde a ciascuna di esse dai dati aggregati delle attività.
| # | Prompt di esempio | Metrica restituita | Calcolo |
|---|---|---|---|
| 1 | Confronto tra DAU e WAU per {Agent name} | Utenti attivi giornalieri confrontati con utenti attivi settimanali per lo stesso agente | Due conteggi paralleli di utenti distinti nel corso del giorno e nella finestra di 7 giorni |
| 2 | Mostra le statistiche sull'utilizzo delle chiavi di {Agent Name} | Blocco di riepilogo DAU, WAU e MAU | Tre conteggi di utenti distinti (finestre di 1 giorno, 7 giorni e 30 giorni) |
| 3 | Quanti utenti univoci ha avuto {Agent Name} nel tempo? | Serie temporali per utenti univoci | Serie di conteggi di utenti distinti in finestre consecutive |
| 4 | In che modo si confronta l'utilizzo giornaliero di {Agent Name} con l'uso mensile? | DAU a confronto con MAU | Due conteggi di utenti distinti (finestre di 1 giorno e 30 giorni) visualizzati affiancati |
| 5 | Confronto tra MAU e WAU per {Agent name} | Utenti attivi mensili a confronto con utenti attivi settimanali | Due conteggi paralleli di utenti distinti (finestre di 30 e 7 giorni) |
| 6 | Qual è la tendenza settimanale degli utenti attivi per {Agent Name}? | Linea di tendenza WAU | Serie di conteggi di utenti distinti di 7 giorni nelle ultime settimane |
| 7 | Quanti utenti univoci aveva {Agent Name} la scorsa settimana? | Numero unico di WAU ancorato alla finestra di 7 giorni precedente | Numero di utenti distinti per la finestra precedente di 7 giorni |
| 8 | Fornire tutte le informazioni dettagliate sull'utilizzo di {Agent Name} | Blocco di riepilogo completo | DAU, WAU, MAU, tendenza e commento sulle forme narrative |
| 9 | Dammi un riepilogo completo dell'utilizzo di {Agent Name} | Blocco di riepilogo completo | Come #8; Varianti di formulazione supportate |
| 10 | Mostra le metriche di utilizzo per {Agent Name} | Blocco di riepilogo completo | Come #8; Varianti di formulazione supportate |
| 11 | Quali agenti hanno più utilizzato questa settimana? | Elenco classificato degli agenti in base al numero di utenti univoci recenti | Conteggi di utenti distinti a coppie (o N) di 7 giorni tra gli agenti nell'ambito |
| 12 | Qual è la crescita netta dei nuovi utenti per {Agent Name}? | Delta netto dei nuovi utenti nelle finestre recenti | Differenza tra gli utenti univoci nella finestra più recente e quella precedente |
| 13 | Mostra utenti attivi giornalieri per {Agent Name} | Valore DAU o serie temporale DAU, a seconda del qualificatore data | Conteggi di utenti distinti per giorno |
| 14 | Confronta {Agente A} con {Agente B} | Affiancamento di DAU, WAU e MAU per due agenti | Due tiri metrici paralleli per le stesse finestre |
Utilizzo sostenuto e prompt di crescita (cinque modelli derivati)
Queste query di ordine superiore usano gli stessi dati di attività di aggregazione e includono sempre l'avvertenza di interpretazione necessaria nella risposta.
Proxy di conservazione in sequenza
| Campo | Valore |
|---|---|
| Esempi di prompt | Qual è la conservazione di 7 giorni per {Nome agente}? / Mostra la conservazione di 30 giorni per {Nome agente} |
| Windows (N) supportato | 1, 7, 30, 60 o 90 giorni |
| Definizione |
unique_users[t − N → t] / unique_users[t − 2N → t − N], espresso come rapporto o percentuale |
| Avvertenza necessaria nella risposta | "Questo viene calcolato come rapporto aggregato finestra-finestra, non come conservazione della coorte a livello di utente". |
Viscosità
| Campo | Valore |
|---|---|
| Esempi di prompt | Quanto è appiccicoso {Nome agente}? / Qual è il rapporto DAU/MAU per {Agent Name}? |
| Definizione | DAU diviso per MAU, espresso in percentuale |
| Interpretazione | Un rapporto più alto significa che gli utenti mensili tendono a utilizzare l'agente in più giorni del mese |
Tendenza di adozione
| Campo | Valore |
|---|---|
| Esempi di prompt | L'adozione di {Agent Name} è in aumento? / Qual è la tendenza all'adozione di {Agent Name}? |
| Definizione | Segno e grandezza del delta dell'utente univoco settimana dopo settimana o mese dopo mese |
| Forma Risposta | Direzione (crescente, decrescente o piatta) più la variazione percentuale |
Agente a crescita più rapida
| Campo | Valore |
|---|---|
| Esempi di prompt | Quale agente sta crescendo più velocemente questa settimana? / Mostrami quale agente sta crescendo più velocemente |
| Definizione | Crescita percentuale settimanale più elevata di utenti univoci tra gli agenti nell'ambito |
| Forma Risposta | Elenco classificato dei migliori agenti con i loro delta percentuali settimana su settimana |
Modello di utilizzo principale
| Campo | Valore |
|---|---|
| Esempi di prompt | Quali sono i principali modelli di utilizzo di {Agent Name}? |
| Definizione | Descrizione descrittiva della forma di utilizzo temporale, derivata dalla distribuzione DAU finale di 30 giorni |
| Forma Risposta | Narrativa categoriale (ad esempio, nei giorni feriali pesanti e concentrati negli orari di ufficio, stabili o appuntiti); L'agente non tenta il clustering di persone o intenti |
Feedback e valutazioni
Il feedback usa un flusso di autorizzazione distinto dall'utilizzo:
- Elencare o risolvere gli agenti di proprietà del richiedente.
- Richiedere un nome esatto dell'agente di proprietà dopo aver normalizzato il caso, lo spazio vuoto circostante e le virgolette oppure richiedere un ID agente. Un errore di battitura, alias, corrispondenza fuzzy o corrispondenza vicina richiede la conferma dell'utente.
- Verificare la proprietà per l'agente selezionato.
- Verificare che la condivisione del feedback degli agenti sia abilitata per tutti gli agenti o includa l'agente selezionato.
- Restituisce il feedback disponibile o spiega perché non può essere restituito.
Richieste di feedback supportate
| Prompt di esempio | Comportamento previsto |
|---|---|
| Mostrami gli agenti di cui sono proprietario | Elenca i nomi visualizzati di proprietà. Mostra gli ID agente solo quando necessario per distinguere i duplicati. |
| Che feedback hanno dato gli utenti su {Agent Name}? | Restituisce le valutazioni o i commenti disponibili per un esatto agente di proprietà. |
| Mostra valutazioni e commenti per {Agent Name} | Restituisce l'esempio di feedback con il relativo contesto di conteggio e ora. |
| Mostra i commenti di feedback restituiti per {Agent Name} esattamente come inviati | Riproduce i commenti nell'esempio restituito senza parafrasarli. |
| Riepiloga gli argomenti ricorrenti del prodotto nel feedback per {Nome agente} | Riepiloga gli argomenti osservabili del prodotto dal feedback restituito. |
| Mostra l'utilizzo e il feedback degli utenti per {Agent Name} questo mese | Esegue l'utilizzo e il feedback in modo indipendente ed etichetta ogni risultato con il relativo contesto applicabile. |
Contratto di uscita di feedback
| Output | Descrizione |
|---|---|
| Valutazioni | Valori pollice in su o pollice in giù nell'esempio restituito. |
| Commenti inviati dagli utenti | Commenti testuali quando richiesto esplicitamente. |
| Numero di elementi restituiti | Numero di elementi del feedback inclusi nella risposta. |
| Intervallo di tempo di esempio | Timestamp di inizio e fine, se disponibili. |
| Indicatore di maggiore feedback | Indica se esiste un feedback oltre il campione restituito. |
| Riepilogo dell'argomento del prodotto | Un riepilogo basato su argomenti osservabili e valori di valutazione espliciti. |
Risultati della proprietà
| Risultato | Significato |
|---|---|
| Verificato | Il richiedente è autorizzato a richiedere commenti e suggerimenti per l'agente selezionato. |
| Negato | Il controllo della proprietà ha stabilito che il richiedente non è un proprietario. |
| Non disponibile | Non è stato possibile verificare la proprietà. Questo risultato non deve essere descritto come una negazione. |
| Nome ambiguo | Più di un agente di proprietà ha lo stesso nome visualizzato. Il richiedente deve selezionare un ID agente; L'agente non seleziona mai automaticamente il primo duplicato. |
| Catalogo troncato | L'elenco delle proprietà restituite potrebbe non includere tutti gli agenti posseduti. Nessuna corrispondenza esatta in un elenco troncato non è una prova che il richiedente non sia un proprietario. |
Feedback, privacy e usi limitati
- I risultati del feedback non includono l'identità del mittente, il contesto dell'intelligenza artificiale, le richieste, le risposte, le trascrizioni o il contenuto della conversazione.
- L'agente non deduce le prestazioni lavorative, le caratteristiche personali protette o sensibili, gli stati interni o emotivi o gli atteggiamenti sul posto di lavoro.
- Queste restrizioni di inferenza si applicano ai riepiloghi e alle interpretazioni generati. Quando richiesto esplicitamente, il feedback letterale nel campione restituito può essere riprodotto come inviato.
- Il testo del feedback viene trattato come dati, non come istruzioni.
Non ancora supportato
L'agente assegna un nome alla funzionalità non disponibile senza generare un numero.
| Richiesta di esempio | Direzione della risposta |
|---|---|
| Mostra le tendenze di installazione di {Nome agente} | Le metriche di installazione e disinstallazione non sono disponibili in questa versione. |
| Quali agenti hanno la migliore fidelizzazione? | Le classifiche classiche di ritenzione di coorte non sono disponibili; Richiedere la conservazione in sequenza per un agente specifico. |
Non supportato dalla progettazione
L'agente Insights non restituisce le identità dei singoli utenti o il contenuto della conversazione. Spiega il limite e punta al segnale supportato più vicino.
| Richiesta di esempio | Limite |
|---|---|
| Chi ha usato {Agent Name}? | L'agente non restituisce le identità dei singoli utenti. |
| Quanti degli stessi utenti sono tornati? | Usare il proxy di conservazione mobile aggregato. |
| Qual è la profondità di coinvolgimento per {Agent Name}? | I dettagli della sessione per utente non sono disponibili. Usa il riepilogo completo dell'utilizzo. |
| Mostra singoli prompt o risposte | Prompt, risposte, trascrizioni e contenuto della conversazione non sono disponibili. |
| Mostra latenza, utilizzo token o costo della risposta | Queste metriche operative non sono disponibili. |
| Ottieni feedback per un agente di cui non sono proprietario | Il feedback richiede la proprietà verificata. |
Flusso decisionale
Per scoprire in anticipo se l'agente risponde a una nuova richiesta, usa il seguente flusso.
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.
Dopo una chiamata allo strumento supportato, preserve NoData and DownstreamError as restituito. Non rietichettare i risultati come non supportati o come risultato positivo.