Vai alla navigazione
Per iniziareConversationsTopics

Recupera argomenti di conversazione dell'agente

Restituisce gli ultimi risultati dell'esecuzione di individuazione degli argomenti per un determinato agente.

Parametri di percorso

agent_idstringObbligatorio
ID dell'agente

Header

xi-api-keystringOpzionale

Parametri di query

page_sizeintegerOpzionale1-100
Numero di gruppi di argomenti di primo livello da restituire.
sort_byenumOpzionale

Colonna in base alla quale classificare gli argomenti. Usa conversations per il volume, sentiment con sort_direction=asc per gli argomenti più negativi e frustration con sort_direction=desc per quelli più frustranti. Gli argomenti senza punteggio vengono sempre classificati per ultimi.

Valori consentiti:
sort_directionenumOpzionale
Direzione di ordinamento degli argomenti.
Valori consentiti:
from_unix_secsintegerOpzionale

Inizio della finestra per visualizzare gli argomenti. Se impostato con to_unix_secs, le esecuzioni giornaliere completate di rilevamento degli argomenti nell'intervallo vengono aggregate; la finestra delimita quindi sia le metriche sia l'insieme di argomenti. Viene arrotondato per difetto all'inizio del relativo giorno UTC, poiché le esecuzioni coprono intere giornate UTC; aggregated_run_count indica quante esecuzioni sono state sommate. Ometti entrambi i limiti per ottenere l'unica esecuzione più recente.

to_unix_secsintegerOpzionale
Fine della finestra temporale per la visualizzazione degli argomenti.
include_evaluation_criteriabooleanOpzionalePredefinito a true

Include la ripartizione della valutazione per criterio nelle metriche di ogni argomento. Passa false per ometterla: rappresenta la maggior parte del payload e il valore ponderato di success_rate viene restituito in entrambi i casi.

cursorstringOpzionale
Usato per recuperare la pagina successiva. Il cursore viene restituito nella risposta.

Risposta

Risposta riuscita
topicslist of objects
window_start_unix_secsinteger
window_end_unix_secsinteger
aggregated_run_countintegerOpzionalePredefinito a 0
Numero di esecuzioni giornaliere di rilevamento degli argomenti su cui sono state sommate le metriche restituite.
has_morebooleanOpzionalePredefinito a false
next_cursorstringOpzionale

Errori

422
Topics Get Request Unprocessable Entity Error