Søg opslagsposter

Gælder for: Dynamics 365 Customer Service

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 skal finde en post at knytte til en anden post, for eksempel ved at sætte en kunde på en sag eller tildele en konto til en mulighed.

Hvad den gør

Assistenten søger i Dynamics 365-poster efter navn, eller konti og kontakter efter telefonnummer, så du kan vælge én at forbinde med en anden post. Dette bruges typisk, når du ønsker:

  • Sæt eller skift kunden på en sag.
  • Tildel en konto eller kontakt til et opslagsfelt.
  • Forbind en post med en anden post.
  • Vælg en bruger, et hold eller en kø til tildeling.

Efter søgeresultaterne vises, spørger assistenten, hvilken post du skal vælge, og anvender derefter associationen ved hjælp af et separat opdateringstrin.

Prøv prompts som

  • Find en kontaktperson at sætte som kunde i denne sag.
  • Vælg en konto til denne mulighed.
  • Tildel denne sag til en bruger ved navn Alex.
  • Sæt kunden på denne sag til Jordan Reyes.
  • Find en konto ved navn Contoso til dette opslag.
  • Find kontakten med telefonnummer +1-555-0142 for denne søgning.
  • Skift kunden til Fabrikam.

Hvad du vil se i chatten

Assistenten viser en tekstliste over matchende poster direkte i chatsamtalen, inklusive postnavn og enhedstype. Assistenten spørger derefter, hvilken plade du skal vælge. Der findes ikke noget interaktivt widget til denne funktion.

Nyttige tip

  • Du kan søge på tværs af flere enhedstyper på én gang, for eksempel både konti og kontakter for et kundeopslag.
  • Telefonopslag understøtter konto- og kontaktmål og tjekker deres standard telefonfelter.
  • Telefonopslag bruger primære fællesfelter som standard. Udtømmende dækning prioriterer disse felter og søger op til 48 læsbare Dataverse Phone-formaterede felter, inklusive brugerdefinerede felter.
  • Efter du har valgt en post, bruger assistenten et separat trin til at anvende associationen.
  • Til generel søgning eller browsing, sig "søg efter" eller "liste" i stedet. Dette værktøj er specifikt til at finde poster til at forbinde.
  • Assistenten beder om bekræftelse, før foreningen ansøger.

Tip

Denne funktion er mest nyttig, når du er midt i at opdatere en post og skal finde en relateret post at forbinde.

Hvad sker der nu?

Efter du har valgt en post, anvender assistenten associationen. Du kan derefter fortsætte med prompts som:

  • Vis denne plade.
  • Opdater et andet felt.
  • Opsummer denne sag.
  • Åbn den tilknyttede post.

Ændrer det dataene?

Nej, selve søgningen ændrer ikke data.

Søgningen er skrivebeskyttet. Opfølgende trin, der anvender associationen, ændrer data. Assistenten beder om bekræftelse, før han foretager ændringen.

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 Søg opslagsposter
Internt værktøjsnavn search_lookup_records
Formål Søger i Dataverse-poster efter navn eller telefon for at finde en specifik post til tilknytning til en anden post via et opslagsfelt

Værktøjsadfærd

Søger i Dataverse-poster efter navn eller konto- og kontaktposter via telefon for at finde en specifik post til tilknytning til en anden post via et opslagsfelt. Understøtter søgning på tværs af én eller flere entitetstyper i et enkelt opkald. En telefonbaseret anmodning uden enhedsomfang søger både konti og kontakter. Primær telefondækning bruger produktkuraterede fælles felter. Udtømmende dækning prioriterer disse felter og søger op til 48 læsbare Dataverse Phone-formaterede felter. Når både search og phone er angivet, skal begge prædikater matche. Når metadata eller feltbegrænsninger, kandidatudhentning eller den ønskede resultatgrænse udelader match, indeholder phoneLookupTruncated: true svaret, og fortællingen advarer om, at yderligere matches kan eksistere.

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

Enhedsområde (enkelt)

Input Beskrivelse Påkrævet
entityLogicalName entityLogicalName (streng, valgfrit). En enkelt enhedstype at søge i. Giv dette eller entityLogicalNamesikke begge dele. Nej

Entitetens omfang (multipel)

Input Beskrivelse Påkrævet
entityLogicalNames entityLogicalNames (strengarray, valgfrit). Flere entitetstyper til at søge samtidig (for eksempel ['account', 'contact'] for kundeopslagsfelter). Maksimalt 10 entitetstyper. Nej

Søgeord

Input Beskrivelse Påkrævet
search search (snor). Søgeord for at matche med enhedens primære navn. Mindst én af search eller phone er påkrævet. Betinget

Telefon

Input Beskrivelse Påkrævet
phone Telefonnummer til kontoopslag eller kontaktopslag. Når entitetsomfanget udelades, søger værktøjet i begge entitetstyper. Konti tjekker telephone1, telephone2, og telephone3; kontakter tjekker telephone1 og mobilephone. Mindst én af search eller phone er påkrævet. Betinget

Søgedækning

Input Beskrivelse Påkrævet
searchCoverage primary (standard) søgninger kuraterede fælles telefonfelter. exhaustive søger i op til 48 læsbare Dataverse Phone-formaterede felter og rapporterer afskæring, når flere findes. Gælder, når phone den leveres. Nej

Resultatgrænse

Input Beskrivelse Påkrævet
top top (heltals, valgfrit, maks 100). Maksimale poster pr. enhedstype. Standard 25. Nej

Respons og UI-adfærd

Dette værktøj returnerer et tekstbaseret svar uden app-i-chat-komponent.

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

Svartype

Tekstliste over matchende poster

Svaret indeholder matchede poster med deres ID, enhedstype, visningsnavn og valgfri sekundær tekst. Telefonresultater inkluderer den matchede lagrede telefonværdi, felt og matchtype. phoneLookupTruncated: true betyder, at metadata eller feltgrænser, kandidatudhentning eller den ønskede resultatgrænse kan have udeladt yderligere match. Assistenten præsenterer resultater og spørger brugeren, hvilken post der skal vælges.

Routingnoter

Brug search_lookup_records for:

  • Sæt som, tildel som, skift til, associer med, link til, sæt kunden, vælg en kontakt til, find en post til vedhæftning.
  • Enhver prompt, hvor målet er at finde en registrering til opslag i feltassociation.
  • Konto- eller kontaktopslagsforening efter telefonnummer.

Brug ikke search_lookup_records , når prompten eksplicit siger:

  • Generel entitetsgennemgang eller søgning – rute til search_entities.
  • Opremsning af poster efter kriterier—rute til list_accounts, list_contacts, eller list_cases.
  • Visning af en posts detaljer—rute til get_entity_record, get_account, eller get_contact.
Værktøj Relation
search_entities Generel enhedssøgning; Brug til browsing, ikke opslagsassociation.
update_entity_record Opdaterer opslagsfeltet, efter brugeren har valgt en post
update_case Opdaterer sagsspecifikke felter, inklusive kundeopslag
list_accounts Lister konti; Brug ved filtrering i stedet for at søge efter association
list_contacts Lister kontakter; Brug ved filtrering i stedet for at søge efter association

Datamutationsklassifikation

Skrivebeskyttet.

Dette værktøj ændrer ikke data. Den søger efter poster, som derefter kan tilknyttes via et separat opdateringsværktøj.

  • Sidst opdateret den