Elimina 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 devi rimuovere permanentemente un record da Dynamics 365, come una nota, un'email, un'attività o un'altra entità.

Funzionamento

L'assistente elimina un record specifico da Dynamics 365. Questo vale per qualsiasi tipo di entità, inclusi appunti, email, telefonate, compiti, appuntamenti ed entità personalizzate. L'assistente chiede conferma prima di cancellare.

Importante

Si tratta di un'eliminazione difficile. Non c'è alcuna operazione di annullamento. Una volta che un record viene cancellato, non può essere recuperato.

Prova con prompt come

  • "Cancella questo biglietto"
  • "Rimuovi il record email"
  • "Elimina l'attività delle chiamate"
  • "Rimuovi questo compito"
  • "Cancella l'appuntamento"
  • "Rimuovi questo disco"

Cosa vedrai in chat

L'assistente conferma che il record è stato cancellato con un messaggio di conferma in chat.

Suggerimenti utili

  • L'assistente chiede sempre conferma prima di cancellare.
  • Assicurati di avere il fascicolo corretto prima di confermare. La cancellazione non può essere annullata.
  • Devi avere privilegi di cancellazione sul tipo di entità in Dynamics 365.
  • Se vuoi disattivare un record invece di cancellarlo, dì "disattiva questo record" invece.

Tip

Se non sei sicuro di eliminarlo, visualizza prima il record dicendo "mostra questo record" per confermare che sia quello giusto.

Cosa succederà dopo

Dopo che il record è stato cancellato, puoi continuare con prompt come:

  • "Elenco dei record per questo tipo di entità"
  • "Crea una nuova nota"
  • "Mostra le mie valigie"

Questo cambia i dati?

Sì, questo cancella i dati in modo permanente.

Il record è stato rimosso da Dynamics 365 e non può essere recuperato. L'assistente chiede conferma prima di procedere.

Cosa puoi fare dalla componente app-in-chat

Dopo la cancellazione, il componente mostra una conferma. Non sono disponibili ulteriori azioni sul record eliminato.

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 Elimina il record dell'entità
Nome dello strumento interno delete_entity_record
Purpose Elimina un record Dataverse per nome logico dell'entità e ID record

Comportamento degli strumenti

Elimina un record Dataverse per nome logico dell'entità e ID del record. Funziona per appunti, email, telefonate, compiti, appuntamenti e qualsiasi altro tipo di entità. Questa è una cancellazione forzata senza annullamento. L'utente deve avere privilegi di cancellazione sull'entità proprietaria del record.

Annotations

Annotation Value Meaning
readOnlyHint false Questo strumento modifica i dati.
destructiveHint true Questo strumento effettua una cancellazione forzata.
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 annotationesempio , email, task, phonecall, ). appointment Sì

Identificatore di record

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

Risposta e comportamento dell'interfaccia utente

Questo strumento fornisce una conferma nella componente app-in-chat.

Questo strumento MCP è supportato da un'app MCP.

Tipo di risposta

Messaggio di conferma

La risposta conferma che il registro è stato cancellato. Il record cancellato non può essere recuperato.

Note di instradamento

Utilizzo delete_entity_record per:

  • Qualsiasi prompt che chieda esplicitamente di eliminare, rimuovere o scartare un record
  • Azioni di eliminazione in linea da widget di griglia o modulo

Non usare delete_entity_record quando:

  • Chiudere un caso - percorso verso close_case
  • Disattivazione di un record - usare update_entity_record per impostare il codice di stato
  • Aggiornamento o modifica - percorso verso update_entity_record
Tool Relazione
get_entity_record Visualizza un record prima di eliminarlo
update_entity_record Aggiorna un record invece di cancellarlo
create_note Crea una nota; delete annulla questa azione
create_activity Crea un'attività; delete annulla questa azione

Classificazione delle mutazioni dei dati

Operazione di scrittura (distruttiva, idempotente).

Questo strumento effettua una cancellazione totale del record Dataverse. Non c'è alcuna operazione di annullamento. L'operazione è idempotente; Cancellare un record già cancellato non ha alcun effetto aggiuntivo.

  • Last updated on