Søgeenheder poster

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

Bemærkning

  • 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 poster på tværs af en eller flere enhedstyper via nøgleord, telefonnummer eller e-mailadresse — især når du kender en identifikator, men ikke hvilken post den tilhører.

Hvad den gør

Assistenten søger i Dynamics 365-poster ved hjælp af den bedst tilgængelige søgemetode. Hvis relevanssøgning er aktiveret i dit miljø, bruges den; ellers falder assistenten tilbage på en substring-match-søgning. Resultaterne returneres i den rækkefølge, Dynamics 365 leverer dem — det første resultat er ikke nødvendigvis det tætteste match.

Du kan søge i flere enhedstyper på én gang — for eksempel kontakter og konti sammen — hvilket er nyttigt, når et telefonnummer eller en e-mailadresse kan tilhøre en af dem. Kontakt- og kontoresultater indeholder som regel nøglefelter som jobtitel, by og status, så du behøver ofte ikke åbne posten for at besvare et opfølgende spørgsmål. De ekstra felter kommer fra et andet opslag, så hvis det ikke lykkes, får du stadig de matchende poster, bare uden dem.

Telefonnumre og e-mailadresser kan søges på, men de genkendte telefon- og e-mailfelter vises ikke i resultaterne for nogen enhedstype — svaret på "hvem ejer dette nummer" er registreringen, ikke det nummer, du allerede havde. Åbn posten for at se dens gemte kontaktoplysninger. To snævre undtagelser: en brugerdefineret kolonne, som din organisation har navngivet uden en genkendelig telefon- eller e-mailrod, kan stadig returneres, og nogle få brugerdefinerede tabeller bruger en adresse eller et nummer som postens navn, som, hvor det er muligt, rapporteres som navnet.

Prøv prompts som

  • Søg i vores CRM-optegnelser efter telefonnummer 555-0134.
  • Find kontaktoplysningerne med e-mailadressen jordan@contoso.com.
  • Søg efter Contoso på tværs af kontakter og konti.
  • Hvilken kunde har e-mailadressen billing@fabrikam.com?
  • Find problemer med papirer, der matcher printeren.
  • Slå optegnelser om netværksafbrydelser.

Hvad du vil se i chatten

Assistenten viser en tekstliste med matchende poster direkte i chatsamtalen. Hvert resultat viser postnavnet og enhedstypen. Der findes ikke noget interaktivt widget til denne funktion.

Nyttige tip

  • Du kan søge i flere enhedstyper på én gang, for eksempel "søg kontakter og konti for Contoso." Dette er det bedste valg, når et telefonnummer eller en e-mailadresse kan tilhøre begge.
  • Telefonnumre matches fleksibelt, når relevanssøgning er aktiveret i dit miljø — du kan skrive 5550134 selv hvis registreringen gemmer (555)-0134sig. Uden relevanssøgning, skriv nummeret, som det er gemt.
  • For at liste konti efter status eller ejer, brug i stedet "list konti". Søgning er bedre, når du ikke allerede ved, hvilken post du vil have.
  • For at åbne en post, du allerede kan navngive, sig i stedet "åbn Contoso-kontoen".
  • For sagsspecifikke søgninger, sig "søgesager" for en mere målrettet oplevelse.
  • Søgetekst er begrænset til 500 tegn.
  • Assistenten fortæller dig, om den har brugt relevanssøgning eller substring-matching.

Tip

Når søgeresultaterne vises, kan du stille opfølgende spørgsmål som "åbn det første resultat" eller "vis detaljer for Contoso."

Hvad sker der nu?

Når søgeresultaterne vises, kan du fortsætte med prompts som:

  • Åbn det første resultat.
  • Vis detaljer til denne plade.
  • Opsummer denne beretning.
  • Søg igen med forskellige søgeord.

Ændrer det dataene?

Nej, søgning ændrer ikke data.

Søgningen er skrivebeskyttet. Opfølgende handlinger fra resultaterne, såsom opdatering eller sletning af en post, kan ændre data.

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 Søgeenheder poster
Internt værktøjsnavn search_entities
Formål Søger i Dataverse-poster efter nøgleord, telefonnummer eller e-mailadresse ved hjælp af den bedst tilgængelige søgemetode (relevanssøgning når aktiveret, eller OData substring-match fallback)

Værktøjsadfærd

Søger i Dataverse-poster efter nøgleord, telefonnummer eller e-mailadresse ved hjælp af den bedste tilgængelige søgemetode (relevanssøgning når aktiveret, eller OData substring-match fallback). Understøtter enhver entitetstype og flere typer i ét kald. Telefon- og e-mailkolonner tilbageholdes fra resultaterne for hver enhedstype; hvor en posts primære navn i sig selv er en sådan værdi, kan navnet stadig rapporteres som postens navn. Kontakt- og kontoresultater beriges med en kurateret detalje gennem et andet, best-effort opslag — når det opslag fejler, returneres søgeresultatet uberiget i stedet for fejlet. Andre entitetstyper modtager intet kurateret sæt og kan bære de resterende felter, som den valgte backend har leveret. Dette er et tekstbaseret værktøj uden app-i-chat-widget.

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. Ignoreres, hvis entityLogicalNames det er oplyst. Nej

Entitetens omfang (multipel)

Input Beskrivelse Påkrævet
entityLogicalNames entityLogicalNames (strengarray, valgfrit). Flere entitetstyper til søgning samtidig. Har forrang over entityLogicalName. Nej

Søgetekst

Input Beskrivelse Påkrævet
searchText searchText (streng, påkrævet, maks 500 tegn). Naturlig sprog- eller søgeordssøgning. Ja

Resultatgrænse

Input Beskrivelse Påkrævet
top top (heltals, valgfrit). Maksimale resultater pr. enhedstype. Som standard er indstillingen for organisationssidestørrelse. 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 primære navn, enhedstype og relevansscore. Søgeniveauet (relevans eller OData indeholder) angives.

Routingnoter

Brug search_entities for:

  • At finde en post fra en identifikator, du har — et telefonnummer, en e-mailadresse eller et nøgleord — når du ikke ved, hvilken post eller enhedstype der ejer den.
  • Søgning i flere enhedstyper på én gang, såsom kontakter og konti sammen.
  • Generisk søgnings-fallback, når der ikke findes et dedikeret værktøj til entiteten.

Brug ikke search_entities , når prompten eksplicit siger:

  • Åbn eller rediger en post, du allerede kan navngive—rute til get_contact eller get_account.
  • Opfør poster efter kriterier som status eller ejer—rute til list_accounts eller list_contacts.
  • Søgesager—rute til search_cases (samme motor, scoped til hændelse).
  • Opslag på feltassociation—rute til search_lookup_records.
  • AI-genereret tidslinjefortælling – rute til summarize_entity_timeline eller get_case_highlights.
Værktøj Relation
search_cases Samme søgemaskine, begrænset til case-enheder
search_lookup_records Søger i poster efter opslagsfeltassociation
list_accounts Dedikeret kontoliste med filtre
list_contacts Dedikeret kontaktliste med filtre
list_entity_records Generisk entitetsgrid til gennemgang af poster
get_entity_record Åbner en enkelt postdetalje fra søgeresultater

Datamutationsklassifikation

Skrivebeskyttet.

Dette værktøj ændrer ikke data. Den udfører søgeforespørgsler mod Dataverse.

  • Sidst opdateret den