Aggiorna il Record 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 cambiare il valore di un campo su qualsiasi record Dataverse direttamente dalla chat.

Funzionamento

L'assistente aggiorna uno o più campi su un record che specifichi. Questo vale per qualsiasi tipo di entità, inclusi account, contatti, opportunità, lead e tabelle personalizzate. Dici all'assistente quale record aggiornare e quali campi modificare, e applica l'aggiornamento direttamente in Dynamics 365.

Per gli aggiornamenti specifici del caso, l'assistente utilizza uno strumento dedicato all'aggiornamento dei casi con validazione più ricca. Questo strumento è il fallback generale per tutti gli altri tipi di entità.

Prova con prompt come

  • "Aggiorna il numero di telefono sull'account Contoso"
  • "Cambia il titolo di lavoro di Jordan in Ingegnere Senior"
  • "Fissa il ricavo stimato per questa opportunità a 50.000"
  • "Aggiorna l'indirizzo email di questo contatto"
  • "Cambia lo stato di questo lead in qualificato"
  • "Imposta il campo descrizione su questo record"

Cosa vedrai in chat

L'assistente mostra il record aggiornato come un modulo interattivo in chat, mostrando i campi dopo l'applicazione dell'aggiornamento.

Suggerimenti utili

  • Sii specifico su quale campo cambiare e quale dovrebbe essere il nuovo valore.
  • L'assistente chiede conferma prima di applicare aggiornamenti.
  • Puoi aggiornare più campi in una singola richiesta, ad esempio "cambia il telefono su 555-0100 e la città su Seattle."
  • Per aggiornamenti sui casi, descrivi semplicemente il cambiamento in modo naturale. L'assistente sceglie lo strumento giusto.

Tip

Dopo l'applicazione, l'assistente ti mostra il record aggiornato così puoi verificare la modifica.

Cosa succederà dopo

Dopo l'applicazione dell'aggiornamento, puoi continuare con prompt come:

  • "Mostra di nuovo questo disco"
  • "Aggiorna un altro campo"
  • "Elenco dei record per questo tipo di entità"
  • "Apri questo record su Dynamics 365"

Questo cambia i dati?

Sì, questo aggiorna i dati dei record Dataverse.

L'assistente applica direttamente i cambiamenti di campo al record Dataverse. L'assistente chiede conferma prima di apportare modifiche.

Cosa puoi fare dalla componente app-in-chat

Dal modulo aggiornato di registrazione in chat, puoi:

  • Conferma che l'aggiornamento sia stato applicato correttamente
  • Rivedere i valori attuali dei campi del record
  • 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 Aggiorna il Record dell'Entità
Nome dello strumento interno update_entity_record
Purpose Aggiorna uno o più campi su qualsiasi record di entità Dataverse tramite GUID

Comportamento degli strumenti

Aggiorna uno o più campi su qualsiasi record di entità Dataverse tramite GUID. Utilizzare quando gli strumenti di aggiornamento specifici del dominio (come update_case) non coprono il campo o l'entità richiesta, oppure quando l'entità non dispone di uno strumento dedicato di aggiornamento. Funziona per account, contatti, opportunità, lead, tabelle personalizzate e qualsiasi altra entità Dataverse.

Annotations

Annotation Value Meaning
readOnlyHint false Questo strumento modifica i dati.
destructiveHint false Questo strumento aggiorna i dati senza il comportamento di hard delete.
idempotentHint true Le chiamate ripetute con lo stesso input hanno lo stesso effetto finale.
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 (ad accountesempio , contact, opportunity). Sì

Identificatore di record

Inserimento Description Obbligatorio
recordId recordId (stringa, richiesta). Il record GUID da aggiornare. Sì

Aggiornamenti sul campo

Inserimento Description Obbligatorio
fields fields (mappa chiave-valore, richiesta). Una mappa dei nomi logici dei campi verso nuovi valori. Esempio: { "telephone1": "555-0100", "jobtitle": "Senior Engineer" }. Sì

Risposta e comportamento dell'interfaccia utente

Questo strumento genera un'app interattiva in chat che mostra il record aggiornato.

Questo strumento MCP è supportato da un'app MCP.

Tipo di risposta

Forma interattiva (vista dettagliata)

Il modulo mostra il record dopo l'applicazione dell'aggiornamento.

Note di instradamento

Utilizzo update_entity_record per:

  • Aggiornare i campi su qualsiasi tipo di entità senza uno strumento dedicato di aggiornamento
  • Aggiornare i campi non coperti dagli strumenti di aggiornamento specifici per dominio

Non usare update_entity_record quando:

  • Aggiornamento dei campi del caso - preferito update_case per campi specifici del caso
  • Eliminazione di un record - percorso verso delete_entity_record
Tool Relazione
get_entity_record Visualizza un record prima o dopo l'aggiornamento
get_account Visualizza un record dell'account prima o dopo l'aggiornamento
get_contact Visualizza un record di contatto prima o dopo l'aggiornamento
delete_entity_record Elimina un record invece di aggiornarlo
update_case Strumento dedicato all'aggiornamento dei casi con logica specifica per caso

Classificazione delle mutazioni dei dati

Operazione di scrittura (non distruttiva, idempotente).

Questo strumento modifica i dati. Gli aggiornamenti vengono applicati direttamente al record Dataverse. L'operazione è idempotente; chiamate ripetute con lo stesso input producono lo stesso risultato.

  • Last updated on