Del via

Konfigurer skjematildeling for kunnskapsartikkel

Gjelder: Dynamics 365 Contact Center – bare frittstående og Dynamics 365 Customer Service

Som en del av tilleggingen av en integrert søkeleverandør i kundeservice må du fortelle tjenesten hvordan du inkluderer kunnskapsartiklene den mottar fra leverandøren. Det gjør du ved å velge og konfigurere et kunnskapsartikkelskjema. Du kan ikke endre skjemaet etter du lagrer konfigurasjonen.

Hvis du brukte et språkfilter i delen Godkjenning og testing, må du vedlikeholde tilordningen for nasjonale språk i JSON-skjemaet eller i delen om skjematildeling for kunnskapsartikkel. Finn ut mer om språklige nasjonale verdier i: Referanse til tabellen/enheten for språk (LanguageLocale).

Velg et alternativ i delen Kunnskapsartikkelskjema:

Felttilordning

Velg og last opp filen for metadatavalg, og velg deretter metakodene du vil bruke i tildelingen. Med felttilordning tilordner du en kunnskapsartikkel mottatt fra søkeleverandøren (kildeegenskapen) til et attributt for kunnskapsartikkelenheten (målet), basert på en operasjonstype.

Velg og last opp filen for metadatavalg

  1. Lagre artikkelen lokalt som en webside, bare HTML-fil. Kontroller at filnavnet er under 99 tegn.

  2. Last opp filen i områdekartet for administrasjonssenteret for Copilot-tjenesten, delen Kunnskapsartikkelskjema>Felttilordning , ved å velge Velg fil.

    Alle metamerkene som finnes i HTML-filen, vises i delen Innstillinger for metamerker .

  3. Velg Velg alle under metamerker eller velg bare metamerkene du vil tilordne.

    Metamerkene du velger her, blir attributter som du kan velge som kildeegenskaper i Tilordning-delen. Hvis du ikke velger noen, er det bare standardkildeegenskapene HTML-tittel og HTML-brødtekst som er tilgjengelige for tilordning.

  4. Velg Neste for å gå til Tilordning. Hvis du vil stoppe og komme tilbake til dette punktet senere, velger du Lagre som utkast.

Tildel artikkelattributter

Bruk en operasjonstype for å tilordne kildeegenskapen til målet.

  • Artikkelattributter: Målfeltverdiene for kunnskapsartikkelen.
  • Operasjonstyper: Tilordningsmønstrene som tilordner kildeartikkelen til artikkelattributtene for kunnskapsartikkelenheten. Lær mer om alternativer for tilordning av operasjonstypen.
  • Kildeegenskap: Verdien du angir for hver operasjonstype. Hvis du for eksempel velger Direkte-operasjonstypen, må du velge blant tidligere valgte metamerker eller eller HTML-Title-merket.

  1. I områdekartet for administrasjonssenteret for Copilot-tjenesten, Tilordning-delen , er de obligatoriske kunnskapsartikkelattributtene Innhold, Ekstern referanse-ID og Tittel. For hver velg en Operasjonstype og en Kildeegenskap.

    Kontroller at verdien for Ekstern referanse-ID er unik.

  2. Hvis du vil legge til flere artikkelattributter, velger du Legg til rad, og deretter velger du en Artikkelattributt, en Operasjonstype og en Kildeegenskap.

    Du kan også velge Slett for å slette et artikkelattributt om nødvendig.

  3. Velg Valider tilordning.

    Tjenesten bruker verdiene du oppgav, til å fastsette verdiene for attributtene i HTML-filen du lastet opp. Den validerer oppføringene i tilordningstabellen og Regex-mønstrene. Det finnes ingen valideringer for RegexUrl.

    Hvis valideringen er vellykket, vises en bekreftelsesmelding. Hvis valideringen mislykkes, vises en feilmelding. Avhengig av feilmeldingen kontrollerer du enten oppføringene i tilordningstabellen eller regex-mønstrene du angav.

  4. Velg Neste for å gå til neste del. Hvis du vil stoppe og komme tilbake til dette punktet senere, velger du Lagre som utkast.

Alternativer for tilordning av operasjonstype

Velg blant følgende tilordningsalternativer for operasjonstypen:

  • Regex: Bruker regex-mønstre til å trekke ut verdier fra kildenettstedet. Kildeegenskapen er et tekstfelt der du kan angi regex-mønsteret. Strengen fra webområdets HTML som samsvarer med dette mønsteret, tilordnes det tilsvarende kunnskapsartikkelfeltet.

    Regex-mønstrene må ha en registreringsgruppe i parentes, slik at du kan trekke ut en bestemt del av teksten som samsvarer. Teksten trekkes ut fra den første gruppen som ikke er tom, i det første samsvaret.

    Her er noen eksempler på regex-mønstre som trekker ut innhold fra en bestemt div-kode:

    • Basert på ID-en for div-kode: <div\b[^>]*id=\"your-id-name-here\"[^>]*>([\s\S]*?)<\/div>
    • Basert på klassen for div-kode: <div\b[^>]*class=\"your-class-name-here\"[^>]*>([\s\S]*?)<\/div>
    • For innhold i brødteksten: <body[^>]*>([\s\S]*)<\/body>
    • For innhold i hodemerket: <head[^>]*>([\s\S]*)<\/head>

  • Direkte: Tilordner verdien for et metakode fra kildenettstedet direkte til et kunnskapsartikkelfelt. Kildeegenskap-listen viser alle metamerkene som er trukket ut fra eksempelnettstedet, sammen med HTML-tittel og HTML-brødtekst, som er tilgjengelige som standard.

    Hvis du velger Direkte som operasjonstype og og: URL som kildeegenskap, tilordnes verdien for metakoden og: URL fra kildeegenskapen til det tilsvarende kunnskapsartikkelattributtet.

  • Konstant: Angi en konstant verdi i alle kunnskapsartikkelfelt. Kildeegenskapen er et tekstfelt der du kan angi konstantverdien.

  • RegexUrl: Som Regex, men ser bare etter treff i URL-adressen til kildenettstedet. Hvis du vil tilordne hele URL-adressen til kildeområdet til et felt for kunnskapsattributt, velger du Regexurl i operasjonstypen og bruker (. *)-mønsteret i kildeegenskapen.

Her er et eksempel som forklarer hvordan du tilordner artikkelattributtene.

Eksempel

HTML-eksempel:

<html>
<head>
	<meta charset="utf-8" />
	<meta name="viewport" content="width=device-width, initial-scale=1.0" />
	<meta property="og:type" content="website" />
	<meta property="og:url" content="https://contoso.com/en-us/id/2911cacd-efa5-4593-ae22-e09ae14c6698/ee734739(v=msdn.10)" />
	<meta name="ms.keywords" content="XML Reader, WS-Trust" />
</head>	
<title>WSTrustRequestSerializer.CanRead Method (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn</title>
<body lang="en-us" dir="ltr">
	<div id="ms-descriptionArticle">
	 Checks if an XML reader is positioned at a WS-Trust RequestSecurityToken element. This is crucial for handling security token requests in .NET applications using Windows Identity Foundation (WIF).
	</div>
	<div id="ms--content-well-notifications" data-bi-name="content-well-notification">
	</div>
	<p>Starting with the .NET Framework 4.5, Windows Identity Foundation (WIF) has been fully integrated into the .NET Framework. The version of WIF addressed by this topic, WIF 3.5, is deprecated and should only be used when developing against the .NET Framework 3.5 SP1 or the .NET Framework 4. Learn more about WIF in the .NET Framework 4.5, also known as WIF 4.5</p>
	<p>When implemented in a derived class, checks if the specified XML reader is positioned at a WS-Trust RequestSecurityToken element.</p>
	<p><strong>Namespace:</strong> Microsoft.IdentityModel.Protocols.WSTrust<br/>
	<strong>Assembly:</strong> Microsoft.IdentityModel (in Microsoft.IdentityModel.dll)</p>
	<h2 id="usage">Usage</h2>
	<pre><code class="lang-vb">'Usage
	Dim instance As WSTrustRequestSerializer
	Dim reader As XmlReader
	Dim returnValue As Boolean

	returnValue = instance.CanRead(reader)
	</code></pre>
	<h4 id="parameters">Parameters</h4>
	<ul>
	<li><strong>reader</strong><br/>
	The XmlReader object from which to read.</li>
	</ul>
	<h4 id="return-value">Return Value</h4>
	<p><strong>true</strong> if the reader is positioned at an RST element that the serializer can read; otherwise, <strong>false</strong>.</p>
</body>
</html>

Bruk følgende operasjonstyper til å tilordne kildeegenskapen til målet i html-fileksemplet:

Skjermbilde som forklarer tildelingen fra den valgte html-filen.

der

  • Artikkelattributt: Innhold
  • Operasjonstype: Regulært uttrykk
  • Kildeegenskap: <body[^>]>([\s\S])</body>

Eksempel på regulært uttrykk trekker ut hele innholdet i body-koden til HTML-filen.

  • Artikkelattributt: ID for ekstern referanse
  • Operasjonstype: RegexUrl
  • Kildeegenskap: ^https://.?/id/(.?)/.*$

RegexUrl trekker ut ID-en 2911cacd-efa5-4593-ae22-e09ae14c6698 fra HTML-filen.

  • Artikkelattributt: Tittel
  • Operasjonstype: Direkte
  • Kildeegenskap: HTML-tittel

Direkte trekker ut innholdet i Tittel-feltet i HTML-filen, for eksempel metoden WSTrustRequestSerializer.CanRead (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn

  • Artikkelattributt: Beskrivelse
  • Operasjonstype: Regulært uttrykk
  • Kildeegenskap: <div\b[^>]id="ms-descriptionArticle"[^>]>([\s\S]*?)</div>

Eksempel på regulært uttrykk trekker ut innhold fra en bestemt div-kode basert på ID. Her er ms-desciptionArticle ID-en til div-koden i html-filen.

  • Artikkelattributt: Nøkkelord
  • Operasjonstype: Direkte
  • Kildeegenskap: ms.keywords

Direkte trekker ut innholdet i feltet ms.keywords i HTML-filen, for eksempel XML-leser, WS-Trust.

JSON-skjema

Finn ut mer om skjemadetaljer for å bygge en mal for metadatatildeling.

  1. I områdekartet for administrasjonssenteret for Copilot-tjenesten,JSON-skjema for kunnskapsartikkelskjema>, kopierer og limer du inn artikkelegenskapene og JSON-skjemaet i feltet du har fått.

  2. Velg Valider JSON.

    Hvis valideringen er vellykket, vises en bekreftelsesmelding. Hvis valideringen mislykkes, vises en feilmelding som identifiserer parameteren som har en feil verdi.

  3. Velg Neste for å gå til neste del. Hvis du vil stoppe og komme tilbake til dette punktet senere, velger du Lagre som utkast.

Neste trinn

Administrer integrerte søkeleverandører