Opdater enhedspost

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

Note

  • 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 vil ændre en feltværdi på en hvilken som helst Dataverse-post direkte fra chat.

Hvad den gør

Assistenten opdaterer et eller flere felter på en post, du angiver. Dette gælder for alle enhedstyper, herunder konti, kontakter, muligheder, leads og brugerdefinerede tabeller. Du fortæller assistenten, hvilken post der skal opdateres, og hvilke felter der skal ændres, og den anvender opdateringen direkte i Dynamics 365.

Til case-specifikke opdateringer bruger assistenten et dedikeret case-opdateringsværktøj med rigere validering. Dette værktøj er den generelle fallback for alle andre entitetstyper.

Prøv prompts som

  • Opdater telefonnummeret på Contoso-kontoen.
  • Skift Jordans jobtitel til Senior Engineer.
  • Sæt den estimerede omsætning på denne mulighed til 50.000.
  • Opdater e-mailadressen på denne kontakt.
  • Ændr status på dette lead til kvalificeret.
  • Sæt beskrivelsesfeltet på denne post.

Hvad du vil se i chatten

Assistenten viser den opdaterede post som en interaktiv formular i chatten, hvor felterne vises, efter opdateringen er blevet anvendt.

Nyttige tip

  • Vær specifik omkring, hvilket felt du skal ændre, og hvad den nye værdi skal være.
  • Assistenten beder om bekræftelse, før ansøgningen opdateres.
  • Du kan opdatere flere felter i en enkelt anmodning, for eksempel "skift telefonen til 555-0100 og byen til Seattle."
  • For opdateringer om sager, beskriv bare ændringen naturligt. Assistenten vælger det rigtige værktøj.

Tip

Efter opdateringen er implementeret, viser assistenten dig den opdaterede post, så du kan verificere ændringen.

Hvad sker der nu?

Efter opdateringen er implementeret, kan du fortsætte med prompts som:

  • Vis denne plade igen.
  • Opdater et andet felt.
  • Opfør poster for denne enhedstype.
  • Åbn denne post i Dynamics 365.

Ændrer det dataene?

Ja, dette opdaterer Dataverse-recorddata.

Assistenten anvender feltændringerne direkte på Dataverse-posten. Assistenten beder om bekræftelse, før han foretager ændringer.

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

Fra den opdaterede registreringsformular i chatten kan du:

  • Bekræft at opdateringen blev anvendt korrekt.
  • Gennemgå postens nuværende feltværdier.
  • Fortsæt med at arbejde med registreringen i chatten ved hjælp af opfølgende prompts.

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 Opdater enhedspost
Internt værktøjsnavn update_entity_record
Formål Opdaterer et eller flere felter på enhver Dataverse-enhedspost af GUID

Værktøjsadfærd

Opdaterer et eller flere felter på enhver Dataverse-enhedspost af GUID. Brug når domænespecifikke opdateringsværktøjer (såsom update_case) ikke dækker det ønskede felt eller den pågældende enhed, eller når entiteten ikke har et dedikeret opdateringsværktøj. Virker for konti, kontakter, muligheder, leads, brugerdefinerede tabeller og enhver anden Dataverse-enhed.

Anmærkninger

Anmærkning Værdi Betydning
readOnlyHint false Dette værktøj ændrer data.
destructiveHint false Dette værktøj opdaterer data uden 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-enhedens logiske navn (for eksempel account, contact, ). opportunity Ja

Postidentifikator

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

Feltopdateringer

Input Beskrivelse Påkrævet
fields fields (nøgleværdikort, påkrævet). Et kort over feltlogiske navne til nye værdier. Eksempel: { "telephone1": "555-0100", "jobtitle": "Senior Engineer" }. Ja

Respons og UI-adfærd

Dette værktøj gengiver en interaktiv app i chat-formular, der viser den opdaterede post.

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

Svartype

Interaktiv form (detaljevisning)

Formularen viser posten efter, at opdateringen er blevet anvendt.

Routingnoter

Brug update_entity_record for:

  • Opdatering af felter på enhver entitetstype uden et dedikeret opdateringsværktøj.
  • Opdatering af felter, der ikke dækkes af domænespecifikke opdateringsværktøjer.

Brug ikke update_entity_record når:

  • Opdatering af casefelter—foretrækker update_case case-specifikke felter.
  • Sletter en post—rute til delete_entity_record.
Værktøj Relation
get_entity_record Se en post før eller efter opdatering
get_account Se en kontopost før eller efter opdatering
get_contact Se en kontaktpost før eller efter opdatering
delete_entity_record Sletter en post i stedet for at opdatere den
update_case Dedikeret caseopdateringsværktøj med case-specifik logik

Datamutationsklassifikation

Skriveoperation (ikke-destruktiv, idempotent).

Dette værktøj ændrer data. Opdateringer anvendes direkte på Dataverse-posten. Operationen er idempotent; gentagne kald med samme input giver det samme resultat.

  • Sidst opdateret den