Visualizza il registro dell'entità

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 vedere tutti i dettagli di un record specifico per qualsiasi tipo di entità Dataverse che non abbia un comando di visualizzazione dedicato.

Funzionamento

L'assistente apre una visualizzazione dettagliata del modulo per il documento che specifichi. Puoi vedere tutti i campi di record, modificare i campi supportati in linea e navigare fino alla forma completa in Dynamics 365. Questo funziona per qualsiasi tipo di entità, inclusi opportunità, lead, elementi della coda e tabelle personalizzate.

Per account, contatti e casi, l'assistente utilizza strumenti specializzati con comportamenti più ricchi. Questo strumento è il backup per tutto il resto.

Prova con prompt come

  • "Opportunità aperta per l'affare Contoso"
  • "Mostra i dettagli della pista per Maria Garcia"
  • "Visualizza il record dell'elemento in coda"
  • "Apri questo registro degli appuntamenti"
  • "Mostrami il record personalizzato dell'entità"
  • "Visualizza questo compito"

Cosa vedrai in chat

L'assistente mostra un modulo di registrazione interattiva come componente app-in-chat. Il modulo mostra i campi del record come definiti dalla configurazione del modulo di sistema Dynamics 365.

Suggerimenti utili

  • Puoi usare un nome di record o GUID per aprire un record specifico.
  • Devi specificare il tipo di entità, ad esempio "opportunità aperta per Project Alpha."
  • Per gli account, dì invece "open account Contoso". Per i contatti, dì "open contact Jordan." Per i casi, si dica "caso aperto CAS-01010-A0A0A0."

Tip

Dopo che il modulo di registrazione appare, puoi porre domande di approfondimento come "aggiorna questo record" o "elimina questo registro."

Cosa succederà dopo

Dopo che il modulo di registrazione è apparso, puoi continuare con prompt come:

  • "Aggiorna un campo su questo record"
  • "Cancella questo registro"
  • "Elenca altri dischi come questo"
  • "Cerca documenti correlati"

Questo cambia i dati?

No, visualizzare un record non cambia i dati.

Il modulo record è di sola lettura di default. Le modifiche in linea dal modulo possono modificare i dati. L'assistente chiede conferma prima di apportare modifiche.

Cosa puoi fare dalla componente app-in-chat

Dal modulo di registrazione in chat, puoi:

  • Ripassa tutti i campi della forma dei record
  • Modifica i campi supportati in linea
  • Apri il modulo completo del record in Dynamics 365
  • Continua a lavorare con il record in chat usando i prompt di follow-up

Prerequisiti

Questo strumento è disponibile sul server MCP di Dynamics 365 Customer Insights - Journeys. Consulta la nota di disponibilità in cima a questa pagina per i dettagli. Non è necessaria alcuna configurazione aggiuntiva.

Riepilogo degli strumenti

Proprietà Value
Nome rivolto all'utente Visualizza il registro dell'entità
Nome dello strumento interno get_entity_record
Purpose Recupera un singolo record per qualsiasi entità Dataverse in una vista dettagliata guidata dai moduli con editing inline

Comportamento degli strumenti

Recupera un singolo record per qualsiasi entità Dataverse in una vista dettagliata guidata dal modulo con editing inline. Utilizzare per tipi di entità non coperti da get_account, get_contact, o get_case, come opportunità, lead o tabelle personalizzate.

Annotations

Annotation Value Meaning
readOnlyHint Non impostato In pratica solo lettura; Questo strumento non modifica direttamente 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

Tipo di entità

Inserimento Description Obbligatorio
entityLogicalName entityLogicalName (stringa, richiesta). Il nome logico dell'entità Dataverse. Sì

Identificatore di record

Inserimento Description Obbligatorio
recordId recordId (stringa, richiesta). Registra GUID o nome principale da cercare. Sì

Selezione della forma

Inserimento Description Obbligatorio
formId formId (stringa, opzionale). Un sistema form GUID da utilizzare per il rendering. No

Risposta e comportamento dell'interfaccia utente

Questo strumento genera una forma interattiva di entità, app-in-chat.

Questo strumento MCP è supportato da un'app MCP.

Tipo di risposta

Forma interattiva (vista dettagliata)

Il modulo mostra i campi del record come definiti dal modulo di sistema selezionato.

Note di instradamento

Utilizzo get_entity_record per:

  • Qualsiasi tipo di entità senza uno strumento di dettaglio dedicato
  • "Aperto [Tipo di Entità] [Nome]", "Mostra dettagli [Tipo di Entità]"

Non usare get_entity_record quando il prompt dice esplicitamente:

  • Un account - via verso get_account
  • Un contatto - via verso get_contact
  • Un caso - percorso verso get_case
  • Record "List" - percorso verso list_entity_records
Tool Relazione
list_entity_records Elenca i record per lo stesso tipo di entità
update_entity_record Aggiorna i campi su qualsiasi record di entità
delete_entity_record Elimina qualsiasi record di entità
get_account Strumento dedicato ai dettagli degli account
get_contact Strumento dedicato ai dettagli di contatto
get_case Strumento dedicato al dettaglio delle case

Classificazione delle mutazioni dei dati

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

La vista del modulo in sé non modifica i dati. Le modifiche in linea attivano le operazioni di scrittura tramite update_entity_record.

  • Last updated on