Listekontakter

Note

Dette værktøj er tilgængeligt som standard på følgende MCP-servere: Dynamics 365 Customer Service. 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 finde kontakter, gennemgå dem i chatten, og tag handling uden at forlade samtalen.

Hvad den gør

Assistenten viser en liste over kontakter, der matcher dine filtre. Du kan filtrere efter:

  • Om kontakten er tildelt dig.
  • Kontaktstatus (aktiv eller inaktiv).
  • Moderselskab.
  • Kontaktnavn.

Resultaterne vises i en interaktiv kontaktliste inde i chatten.

Prøv prompts som

  • Vis mine kontakter.
  • Skriv mine aktive kontakter.
  • Vis kontakter hos Contoso.
  • List inaktive kontakter.
  • Vis kontakter, der er tildelt mig.
  • Find Jordan Reyes.
  • Lav en liste over alle kontakter.
  • Vis kontakter hos Fabrikam.

Hvad du vil se i chatten

Assistenten viser en interaktiv kontaktliste som en app-i-chat-komponent. Listen viser matchende kontakter med nøgleoplysninger som navn, e-mail, telefonnummer, firma og jobtitel.

Nyttige tip

  • Sig "mine kontakter" eller "tildelt mig" for kun at se kontakter, du ejer.
  • Brug statusord som aktiv eller inaktiv til at filtrere resultater.
  • Brug et firmanavn til at finde kontakter i en bestemt organisation, for eksempel "vis kontakter hos Contoso."
  • Kombiner filtre ved at sige noget i retning af "vis mine aktive kontakter på Fabrikam."
  • Hvis du vil have et tekstresumé af en kontakt, så sig i stedet "opsummere kontakt Jordan Reyes".

Tip

Når kontaktlisten er dukket op, kan du stille opfølgende spørgsmål om enhver kontakt, der vises. For eksempel "åbn den første kontakt" eller "opsummer Jordan Reyes."

Hvad sker der nu?

Når listen er dukket op, kan du fortsætte med prompts som:

  • Åbn den første kontakt.
  • Opsummer denne kontakt.
  • Vis kontoen for denne kontakt.
  • Opdater denne kontakts e-mailadresse.

Ændrer det dataene?

Nej, at liste kontakter ændrer ikke data.

Kontaktlisten er skrivebeskyttet. Opfølgende handlinger fra listen, såsom opdatering af et felt, kan ændre data. Assistenten beder om bekræftelse, før han foretager ændringer.

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

Fra kontaktlisten i chatten kan du:

  • Scan og gennemgå matchende kontakter i et sorterbart gitter.
  • Vælg en kontakt for at se flere detaljer.
  • Åbn den fulde kontaktformular i Dynamics 365.
  • Opdater understøttede felter inline, når det er tilgængeligt.
  • Fortsæt med at arbejde med kontakten i chatten ved hjælp af opfølgende prompts.

Forudsætninger

Dette værktøj er tilgængeligt på Dynamics 365 Customer Service MCP-serveren. Se tilgængelighedsnoten øverst på denne side for detaljer. Der kræves ingen yderligere konfiguration.

Værktøjsoversigt

Egenskab Værdi
Brugerrettet navn Listekontakter
Internt værktøjsnavn list_contacts
Formål Lister kundekontakter filtreret efter status, moderselskab, ejer eller navnesøgning og viser dem i en interaktiv gitter-lignende app-i-chat-oplevelse

Værktøjsadfærd

Lister kundekontakter filtreret efter status, moderselskab, ejer eller navnesøgning og gengiver dem i en interaktiv gitter-stil app-i-chat-oplevelse. Parameteren search udfører et contains-match mod kontaktnavnet.

Anmærkninger

Anmærkning Værdi Betydning
readOnlyHint true Dette værktøj ændrer ikke data.
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

Input Beskrivelse Påkrævet
– fritekststreng. Udfører et contains-match mod kontaktens navn. Nej

Firma

Input Beskrivelse Påkrævet
– Filtrer efter moderselskabets navn (indeholder match). Brug den, når brugeren angiver en virksomhed eller organisation. Nej

Status

Input Beskrivelse Påkrævet
active, inactive active eller inactive. Filtrer efter kontakt-statskode. Nej

Ejerskabsområde

Input Beskrivelse Påkrævet
assignedToMe assignedToMe (boolesk). Når det er sandt, resulterer scopes i kontakter ejet af den nuværende bruger. Nej

Resultatgrænse

Input Beskrivelse Påkrævet
top top (heltal). Maksimalt antal kontakter at returnere. Standardindstillingen er 10, maks 200. Nej

Flere filtre

Input Beskrivelse Påkrævet
additionalFilter additionalFilter (nøgle-værdi kort). Vilkårlige OData-filterbetingelser er slået sammen med AND. Nej

Respons og UI-adfærd

Dette værktøj gengiver et interaktivt app-i-chat kontaktgitter.

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

Svartype

Interaktivt gitter (listevisning)

Gitteret viser kontaktnavn, e-mail, telefonnummer, firma og jobtitel. Brugere kan vælge en række for at undersøge kontaktdetaljer eller følge op via chat.

Routingnoter

Brug list_contacts for:

  • Mine kontakter, kontakter tildelt mig, mine aktive kontakter.
  • Statusbaseret filtrering (aktiv, inaktiv).
  • Virksomhedsbaseret filtrering.
  • Kontaktnavnesøgning.

Brug ikke list_contacts , når prompten eksplicit siger:

  • En specifik kontakt ved navn for detaljevisning—rute til get_contact.
  • "Opsummer" en kontakt (person)—rute til summarize_contact.
  • Fritekstsøgning på tværs af flere entitetstyper—rute til search_entities.
  • Opslag på feltassociation—rute til search_lookup_records.
Værktøj Relation
get_contact Åbner hele kontaktformularen for en valgt kontakt
summarize_contact Genererer et AI-drevet kontaktresumé
list_accounts Lister konti; Ofte brugt sammen med kontaktbrowsing
search_entities Fritekstsøgning på tværs af enhver entitetstype
search_lookup_records Søger i poster efter opslagsfeltassociation
list_entity_records Generisk entitetsgrid for entitetstyper uden et dedikeret listeværktøj

Datamutationsklassifikation

Skrivebeskyttet indgangspunkt med potentiale for nedstrøms mutation.

Selve annoncen ændrer ikke dataene. Opfølgende handlinger fra gitteret (opdatering, rediger felter) kan udløse skriveoperationer gennem separate værktøjer.

  • Sidst opdateret den