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

Search

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.

Relaterede værktøjer

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.