Slet entitetspost

Gælder for: Dynamics 365 Customer Service og Dynamics 365 Sales

Bemærk

  • Værktøjerne og eksemplerne i denne dokumentation illustrerer de nuværende kapaciteter. Værktøjsnavne, beskrivelser, parametre, svarformater og tilgængelig funktionalitet kan ændre sig over tid.
  • Når du bygger agenter, integrationer eller orkestreringslogik, så kod ikke afhængigheder hårdt på specifikke værktøjsnavne, parameterstrukturer, værktøjsmetadata eller responsskemaer. Design i stedet din løsning, så den opdager og bruger tilgængelige værktøjer under kørsel.
  • Efterhånden som platformen udvikler sig, kan Microsoft tilføje, fjerne, omdøbe eller ændre værktøjer og værktøjsmetadata. At designe ud fra kapabiliteter frem for specifikke værktøjsidentifikatorer hjælper med at opretholde kompatibilitet på tværs af serviceopdateringer.

Brug denne funktion, når du har brug for permanent at fjerne en post fra Dynamics 365, såsom en note, e-mail, opgave eller anden enhed.

Hvad den gør

Assistenten sletter en specifik post fra Dynamics 365. Dette gælder for enhver entitetstype, herunder noter, e-mails, telefonopkald, opgaver, aftaler og brugerdefinerede enheder. Assistenten beder om bekræftelse, før den sletter.

Vigtigt!

Dette er en hard sletning. Der er ingen fortrydelse. Når en post er slettet, kan den ikke gendannes.

Prøv prompts som

  • Slet denne note.
  • Fjern e-mailposten.
  • Slet telefonopkaldsaktiviteten.
  • Fjern denne opgave.
  • Slet aftalen.
  • Fjern denne plade.

Hvad du vil se i chatten

Assistenten bekræfter, at registreringen er slettet, med en bekræftelsesbesked i chatten.

Nyttige tip

  • Assistenten beder altid om bekræftelse, før den sletter.
  • Sørg for, at du har den rigtige journal, før du bekræfter. Sletning kan ikke gøres om.
  • Du skal have sletningsrettigheder på entitetstypen i Dynamics 365.
  • Hvis du vil deaktivere en post i stedet for at slette den, så sig "deaktiver denne post" i stedet.

Tip

Hvis du er usikker på at slette den, så se først posten ved at sige "vis denne post" for at bekræfte, at det er den rigtige.

Hvad sker der nu?

Efter registreringen er slettet, kan du fortsætte med prompts som:

  • Opfør poster for denne enhedstype.
  • Opret en ny note.
  • Vis mine kufferter.

Ændrer det dataene?

Ja, det sletter data permanent.

Posten fjernes fra Dynamics 365 og kan ikke gendannes. Assistenten beder om bekræftelse, før han fortsætter.

Hvad du kan gøre fra app-i-chat-komponenten

Efter sletning viser komponenten en bekræftelse. Der er ingen yderligere handlinger tilgængelige på den slettede post.

Forudsætninger

Dette værktøj er tilgængeligt for de produkter, der er opført i linjen Gælder for øverst på denne side. Der kræves ingen yderligere konfiguration.

Værktøjsoversigt

Egenskab Værdi
Brugerrettet navn Slet entitetspost
Internt værktøjsnavn delete_entity_record
Formål Sletter en Dataverse-post efter entitetens logiske navn og post-ID

Værktøjsadfærd

Sletter en Dataverse-post efter entitetens logiske navn og post-ID. Fungerer kun til noter (annotation) og aktiviteter (e-mail, telefonopkald, opgave, aftale, brev, fax, social aktivitet) – håndtereren afviser alle andre entitetstyper, inklusive brugerdefinerede enheder, med en eksplicit tilladelsesliste-fejl. Dette er en hard delete uden nogen fortrydelse. Brugeren skal have sletningsrettigheder på postens ejerende enhed.

Anmærkninger

Anmærkning Værdi Betydning
readOnlyHint false Dette værktøj ændrer data.
destructiveHint true Dette værktøj udfører en hård sletning.
idempotentHint true Gentagne opkald med samme input har samme endelige effekt.
openWorldHint Ikke angivet Bruger standard (forespørgsler Dataverse).

Inputbegreber

Entitetstype

Input Beskrivelse Påkrævet
entityLogicalName entityLogicalName (snor, påkrævet). Dataverse-entitetens logiske navn (for eksempel annotation, email, task, , phonecall, appointment). Ja

Postidentifikator

Input Beskrivelse Påkrævet
recordId recordId (snor, påkrævet). Registreringen GUID skal slettes. Ja

Respons og UI-adfærd

Dette værktøj giver en bekræftelse i app-i-chat-komponenten.

Dette MCP-værktøj understøttes af en MCP-app.

Svartype

Bekræftelsesbesked

Svaret bekræfter, at registreringen blev slettet. Den slettede post kan ikke gendannes.

Routingnoter

Brug delete_entity_record for:

  • Enhver prompt, der eksplicit beder om at slette, fjerne eller kassere en post.
  • Inline sletningshandlinger fra gitter- eller formularwidgets.

Brug ikke delete_entity_record når:

  • Lukning af en sag—vej til close_case.
  • Deaktivering af en post—brug update_entity_record til at sætte statskode.
  • Opdatering eller redigering – rute til update_entity_record.
Værktøj Relation
get_entity_record Se en post før sletning
update_entity_record Opdater en post i stedet for at slette
create_note Opretter en note; Slet omstøder denne handling
create_activity Skaber en aktivitet; Slet omstøder denne handling

Datamutationsklassifikation

Skriveoperation (destruktiv, idempotent).

Dette værktøj udfører en hard delete på Dataverse-posten. Der er ingen fortrydelse. Operationen er idempotent; Sletning af en allerede slettet post har ingen yderligere effekt.

  • Sidst opdateret den