Dettagli del caso

Note

Questo strumento è disponibile di default sui seguenti server MCP: Dynamics 365 Customer Insights - Journeys. Gli strumenti ed esempi presenti in questa documentazione illustrano le capacità attuali. Nomi degli strumenti, descrizioni, parametri, formati di risposta e funzionalità disponibili possono cambiare nel tempo.
Quando costruisci agenti, integrazioni o logiche di orchestrazione, non codificare dipendenze su nomi specifici di strumenti, strutture di parametri, metadati degli strumenti o schemi di risposta. Invece, progetta la tua soluzione per scoprire e utilizzare gli strumenti disponibili in runtime.
Con l'evoluzione della piattaforma, Microsoft potrebbe aggiungere, rimuovere, rinominare o modificare strumenti e metadati degli strumenti. Progettare in base alle capacità piuttosto che a specifici identificatori di strumenti aiuta a mantenere la compatibilità tra gli aggiornamenti dei servizi.

Usa questa funzionalità quando vuoi visualizzare il modulo completo del caso con tutti i suoi campi, sezioni e timeline direttamente in chat, specialmente quando stai per modificare i dettagli del caso.

Funzionamento

L'assistente apre un modulo interattivo all'interno della chat che rispecchia il layout del caso di Dynamics 365. Il modulo mostra tutti i campi del caso organizzati per sezioni, come dettagli del caso, informazioni sul cliente e informazioni SLA, e include una scheda Timeline che mostra la cronologia delle attività del caso.

Questa è la visione basata sulla forma di un caso. È meglio quando devi vedere valori specifici dei campi o prepararti ad aggiornare il caso. Per una panoramica generale di un caso (con un riassunto generato dall'IA), usa invece "riassumere il caso" — l'assistente usa di default la vista riassuntiva per la maggior parte dei prompt "mostrami il caso".

Prova con prompt come

  • "Mostra il modulo del caso per CAS-01010-A0A0A0"
  • "Apri la vista del modulo per questo caso"
  • "Mostrami i campi delle valigie"
  • "Apri il modulo del caso così posso modificarlo"
  • "Mostra la timeline del caso CAS-01010-A0A0A0"
  • "Modulo del caso per questo caso, scheda della linea temporale"

Cosa vedrai in chat

L'assistente mostra un modulo interattivo come componente app-in-chat. Il modulo mostra i campi, le sezioni e le schede del caso, inclusa una scheda Timeline con le attività recenti.

Suggerimenti utili

  • Dì invece "riassumi il caso" se vuoi una panoramica rapida generata dall'IA. L'assistente invoglia di default la maggior parte dei prompt "showcase case" o "open case" alla vista sommario.
  • Usa questo strumento quando hai bisogno di vedere valori specifici dei campi o pianificare di modificare il caso.
  • Puoi andare direttamente alla scheda Timeline dicendo "mostra la timeline di questo caso."
  • Filtra le attività della timeline per tipo (email, compiti, note) o intervallo di date nel prompt.
  • Puoi passare un numero di caso (come CAS-01010-A0A0A0) o un GHID del caso.

Cosa succederà dopo

Dopo che il modulo del caso è apparso, puoi continuare con prompt come:

  • "Aggiorna la priorità ad alta"
  • "Riassegna questo caso ad Alex"
  • "Riassumi questo caso"
  • "Redige un'email per il cliente"
  • "Cosa è cambiato in questo caso da ieri?"
  • "Chiudi questo caso"

Questo cambia i dati?

No. Visualizzare il modulo del caso non cambia i dati.

Il modulo è di sola lettura. Azioni successive come aggiornare un campo, riassegnare o chiudere il caso possono modificare i dati. L'assistente chiede conferma prima di apportare modifiche.

Cosa puoi fare dalla componente app-in-chat

Dal modulo del caso in chat, puoi:

  • Visualizza tutti i campi di caso organizzati per sezioni del modulo
  • Passa tra le schede del modulo (Dettagli, Cronologia e altre)
  • Sfoglia la timeline dell'attività con filtri per tipo di attività, stato e intervallo di date
  • Apri l'intero record del caso in Dynamics 365
  • Usa prompt di follow-up per aggiornare i campi o agire sul caso

Prerequisiti

Questo strumento è disponibile sul server MCP di Dynamics 365 Customer Insights - Journeys. Consulta la nota di disponibilità all'inizio di questo articolo per maggiori dettagli. Non è necessaria alcuna configurazione aggiuntiva.

Riepilogo degli strumenti

Proprietà Value
Nome rivolto all'utente Dettagli del caso
Nome dello strumento interno get_case
Purpose Apre il widget Case Form che mostra la disposizione di Dataverse con sezioni, campi, timeline e KPI SLA

Comportamento degli strumenti

Apre il widget del modulo di caso che mostra il layout Dataverse con sezioni, campi, timeline e KPI SLA. Quando includeSummary: true, visualizza anche una carta AI Summary accanto al modulo. Usa per "mostra CAS-X", "apri/visualizza CAS-X", "ottene/mostra dettagli del caso CAS-X", "parlami di CAS-X" o qualsiasi intento generale di triage o edit-preludio. Passare includeSummary: true quando il riassunto del caso è abilitato per check_summary_enabled. Per l'intento dedicato al riassunto dell'IA ("riassumere CAS-X", "ricapitolare CAS-X"), usa summarize_case invece. Per il feed di attività solo in ordine cronologico, usa get_activity_timeline.

Annotations

Annotation Value Meaning
readOnlyHint true Questo strumento non modifica i dati.
destructiveHint Non impostato Non applicabile (strumento di sola lettura).
idempotentHint Non impostato Non applicabile (strumento di sola lettura).
openWorldHint Non impostato Usa il predefinito (interroga Dataverse).

Concetti di input

Identificatore del caso

Inserimento Description Obbligatorio
incidentId, caseNumber incidentId (GUID) o caseNumber (ad esempio CAS-01010-A0A0A0). Almeno uno è richiesto. Quando caseNumber viene fornito, il server lo risolve in un GUID tramite un matching esatto e poi fuzzy matching.

Selezione della forma

Inserimento Description Obbligatorio
formId formId (GUID). Optional. Seleziona una forma di sistema specifica; di default usa la forma principale principale. No

Tabula iniziale

Inserimento Description Obbligatorio
initialActiveTab initialActiveTab (corda). Imposta quale scheda è attiva quando il widget si apre. No

Filtri della linea temporale

Inserimento Description Obbligatorio
typeFilter, stateFilter, searchText, dateFrom, dateTo typeFilter (array di stringhe), stateFilter (array di stringhe), searchText, dateFrom, dateTo. Optional. Pre-filtra la scheda timeline incorporata. No

Riepilogo ai

Inserimento Description Obbligatorio
includeSummary includeSummary (booleano). Quando true, si espande in summarize_case parallelo e visualizza la scheda Riassunto insieme al modulo. Costa una chiamata LLM. No

Risposta e comportamento dell'interfaccia utente

Questo strumento MCP è supportato da un'app MCP.

Tipo di risposta

Modulo di caso interattivo (app-in-chat)

Note di instradamento

Usare get_case quando:

  • L'utente dice "mostra caso", "caso aperto", "visualizza caso", "ottieni dettagli del caso", "parlami di CAS-X" (triage generale o visualizza intenti)
  • L'utente sta per modificare il caso (preludio a update_case)
  • L'utente chiede esplicitamente l'accesso solo al modulo: "basta mostrare il modulo", "solo campi di caso"
  • Passare includeSummary: true al check_summary_enabled ritorno caseSummaryEnabled: true

Non usare get_case quando:

  • L'utente chiede un riassunto dedicato all'IA ("riassumi CAS-X", "ricapitola CAS-X", "ribriefami su CAS-X") - percorso verso summarize_case
  • L'utente vuole solo un feed di attività - rotta verso get_activity_timeline
  • L'utente vuole segnali di triage - rotta verso get_case_highlights
Tool Relazione
summarize_case Genera un riassunto AI con la scheda Riassunto come atterraggio predefinito. Uso per intenti di riassunto dedicati ("riassumere CAS-X", "ricapitolare CAS-X")
update_case Aggiorna i campi sul caso. Usalo get_case come preludio da ispezionare prima del montaggio
get_case_highlights Ritorni segnali di triage strutturati (rischio SLA, escalation, conteggio delle attività)
get_activity_timeline Restituisce il feed grezzo di attività cronologica per il caso
get_case_sla_status Restituisce i dettagli dei KPI SLA per il caso
close_case Risolve e chiude il caso

Classificazione delle mutazioni dei dati

Punto di ingresso di sola lettura con potenziale mutazione a valle.

Il modulo in sé non cambia i dati. Le azioni successive dal modulo, come aggiornare, riassegnare e chiudere, possono attivare operazioni di scrittura utilizzando strumenti separati.