Se enhedspost

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 vil se alle detaljer for en specifik post for enhver Dataverse-enhedstype, der ikke har sin egen dedikerede visningskommando.

Hvad den gør

Assistenten åbner en detaljeret formularvisning for den post, du angiver. Du kan se alle postfelter, redigere understøttede felter inline og navigere til den fulde formular i Dynamics 365. Dette virker for enhver entitetstype, inklusive muligheder, leads, kø-elementer og brugerdefinerede tabeller.

For konti, kontakter og sager bruger assistenten specialiserede værktøjer med mere omfattende adfærd. Dette værktøj er fallback-løsningen for alt andet.

Prøv prompts som

  • Åben mulighed for Contoso-handel.
  • Vis hoveddetaljer for Maria Garcia.
  • Se kø-item recorden.
  • Åbn denne aftalejournal.
  • Vis mig den brugerdefinerede enhedspost.
  • Se denne opgave.

Hvad du vil se i chatten

Assistenten viser en interaktiv registreringsformular som en app-i-chat-komponent. Formularen viser postens felter som defineret af Dynamics 365-systemets formularkonfiguration.

Nyttige tip

  • Du kan bruge et postnavn eller GUID til at åbne en specifik post.
  • Du skal angive entitetstypen, for eksempel "open opportunity for Project Alpha."
  • Lad columns være med at inkludere felter, der ikke er på postens formular (op til 50). De felter, du anmoder om, vises i oplysningerne om posten.
  • For konti, sig "åbn konto Contoso" i stedet. For kontakter, sig "åben kontakt Jordan." For sager, sig "åbn sag CAS-01010-A0A0A0."

Tip

Når postformularen vises, kan du stille opfølgende spørgsmål som "opdater denne post" eller "slet denne post."

Hvad sker der nu?

Når registreringsformularen vises, kan du fortsætte med prompts som:

  • Opdater et felt på denne post.
  • Slet denne optegnelse.
  • Nævn flere plader som denne.
  • Søg efter relaterede optegnelser.

Ændrer det dataene?

Nej, at se en post ændrer ikke data.

Registreringsformularen er som standard skrivebeskyttet. Inline-redigeringer fra formularen kan ændre data. Assistenten beder om bekræftelse, før han foretager ændringer.

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

Fra registreringsformularen i chatten kan du:

  • Gennemgå alle felter i registreringsformularen.
  • Redigering: understøttede felter inline.
  • Åbn den fulde postformular i Dynamics 365.
  • 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 Se enhedspost
Internt værktøjsnavn get_entity_record
Formål Henter en enkelt post for enhver Dataverse-enhed i en formulardrevet detaljevisning med indbygget redigering

Værktøjsadfærd

Henter en enkelt post for enhver Dataverse-enhed i en formulardrevet detaljevisning med inline-redigering. Brug for entitetstyper, der ikke er dækket af get_account, get_contact, eller get_case, såsom muligheder, leads eller brugerdefinerede tabeller.

Anmærkninger

Anmærkning Værdi Betydning
readOnlyHint Ikke angivet Kun læseadgang i praksis; Dette værktøj ændrer ikke data direkte.
destructiveHint Ikke angivet Ikke relevant (skrivebeskyttet værktøj).
idempotentHint Ikke angivet Ikke relevant (skrivebeskyttet værktøj).
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. Ja

Postidentifikator

Input Beskrivelse Påkrævet
recordId recordId (snor, påkrævet). Registrer GUID eller primært navn at søge efter. Ja

Formvalg

Input Beskrivelse Påkrævet
formId formId (streng, valgfrit). En systemformular GUID til brug til rendering. Nej

Ekstra felter

Input Beskrivelse Påkrævet
columns columns (strengarray, valgfrit, maks 50). Yderligere feltlogiske navne at inkludere ud over formularens felter (for eksempel ["createdon", "industrycode"]). Ønskede felter, der ikke er på formularen, projiceres ind i den returnerede formular, så deres værdier vises i svaret. Ukendte eller ulæselige navne ignoreres. Anmodningsopslag, Ejer og Kunde-felterne ved deres grundlæggende logiske navn (for eksempel customerid, ikke _customerid_value); deres værdi returneres som opslagets visningsnavn. Nej

Respons og UI-adfærd

Dette værktøj gengiver en interaktiv app-i-chat enhedsform.

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

Svartype

Interaktiv form (detaljevisning)

Formularen viser postens felter som defineret af den valgte systemformular.

Routingnoter

Brug get_entity_record for:

  • Enhver entitetstype uden et dedikeret detaljeværktøj.
  • Åbn [Entitetstype] [Navn], vis [Entitetstype] Detaljer.

Brug ikke get_entity_record , når prompten eksplicit siger:

  • En konto—rute til get_account.
  • En kontakt—rute til get_contact.
  • En sag—vej til get_case.
  • "Liste" poster—rute til list_entity_records.
Værktøj Relation
list_entity_records Lister poster for samme enhedstype
update_entity_record Opdaterer felter på enhver enhedspost
delete_entity_record Sletter enhver enhedspost
get_account Dedikeret værktøj til kontodetaljer
get_contact Dedikeret kontaktdetaljeværktøj
get_case Dedikeret værktøj til sagsdetaljer

Datamutationsklassifikation

Skrivebeskyttet indgangspunkt med potentiale for nedstrøms mutation.

Selve formularvisningen ændrer ikke data. Inline-redigeringer udløser skriveoperationer gennem update_entity_record.