Comparteix a través de

Configurar l'assignació de l'esquema d'articles de la Knowledge Base

S'aplica a: Dynamics 365 Contact Center, autònom i només al Dynamics 365 Customer Service

Com a part de l'addició d'un proveïdor de cerca integrat al Customer Service, heu d'indicar al servei com ingerir els articles de la Knowledge Base que rep del proveïdor. Per fer-ho, seleccioneu i configureu un esquema d'article de la Knowledge Base. No podeu canviar l'esquema després de desar la configuració.

Si heu aplicat un filtre de llengua a la secció Autenticació i proves , heu de mantenir l'assignació per a la configuració regional de la llengua a l'esquema JSON o a la secció Assignació d'esquema d'article de la Knowledge Base. Obteniu més informació sobre els valors de la configuració regional de la llengua, a: Language (LanguageLocale) referència de taula/entitat.

Seleccioneu una opció a la secció Esquema de l'article de la Knowledge Base:

Assignació de camps

Seleccioneu i carregueu el fitxer per a la selecció de metadades i, a continuació, seleccioneu les metaetiquetes que voleu utilitzar a l'assignació. Amb l'assignació de camps, assigneu un article de la Knowledge Base rebut del proveïdor de cerca (la propietat d'origen) a un atribut de l'entitat de l'article de la Knowledge Base (la destinació), basat en un tipus d'operació.

Seleccioneu i carregueu el fitxer per a la selecció de metadades

  1. Deseu l'article localment com a pàgina web, fitxer només HTML. Assegureu-vos que el nom del fitxer tingui menys de 99 caràcters.

  2. Al mapa del lloc del Centre d'administració del Copilot Service, seccióAssignació de camps de l'esquema > de l'article de la Knowledge Base, carregueu el fitxer seleccionant Tria el fitxer.

    Totes les metaetiquetes que es troben al vostre fitxer HTML es mostren a la secció Configuració de les metaetiquetes.

  3. Seleccioneu Seleccioneu totes les metaetiquetes següents o seleccioneu només les metaetiquetes que necessiteu assignar.

    Les metaetiquetes que seleccioneu aquí es converteixen en atributs que podeu seleccionar com a propietats d'origen a la secció Assignació . Si no en seleccioneu cap, només les propietats d'origen per defecte HTML-Title i HTML-Body estan disponibles per assignar.

  4. Per anar a la secció Assignació, seleccioneu Següent . Si voleu aturar-vos i tornar a aquest punt més endavant, seleccioneu Desa com a esborrany.

Assigna atributs d'article

Utilitzeu un tipus d'operació per assignar la propietat d'origen a la destinació.

  • Atributs de l'article: els valors del camp de destinació de l'article de la Knowledge Base.
  • Tipus d'operació: els patrons d'assignació que assignen l'article d'origen als atributs de l'article de l'entitat de l'article de la Knowledge Base. Obteniu més informació sobre les opcions d'assignació de tipus d'operació.
  • Propietat Source: el valor que definiu per a cada tipus d'operació. Per exemple, si seleccioneu el tipus d'operació directa , heu de seleccionar entre les metaetiquetes seleccionades anteriorment o l'etiqueta HTML-Title .

  1. Al mapa del lloc del Centre d'administració del Copilot Service, secció Assignació , els atributs obligatoris de l'article de la Knowledge Base són Contingut, Identificador de referència externa i Títol. Per a cadascun, seleccioneu un tipus d'operació i una propietat d'origen.

    Assegureu-vos que el valor de l'identificador de referència externa sigui únic.

  2. Per afegir més atributs d'article, seleccioneu Afegeix fila i, a continuació, seleccioneu un atribut d'article, un tipus d'operació iuna propietat d'origen.

    També podeu seleccionar Suprimeix per suprimir un atribut de l'article si cal.

  3. Seleccioneu Valida l'assignació.

    El servei utilitza els valors que heu introduït per determinar els valors dels atributs en el fitxer HTML que heu penjat. Valida les entrades de la taula d'assignació i els patrons Regex. No hi ha validacions per a RegexUrl.

    Si la validació és correcta, veureu un missatge de confirmació. Si la validació falla, veureu un missatge d'error. Depenent del missatge d'error, comproveu les entrades de la taula d'assignació o els patrons d'expressions regulars que heu introduït.

  4. Seleccioneu Següent per anar a la secció següent. Si voleu aturar-vos i tornar a aquest punt més endavant, seleccioneu Desa com a esborrany.

Opcions d'assignació del tipus d'operació

Seleccioneu una de les següents opcions d'assignació de tipus d'operació:

  • Regex: utilitza patrons d'expressions regulars per extreure valors del lloc web d'origen. La propietat source és un camp de text on podeu introduir el patró regex. La cadena de l'HTML del lloc web que coincideix amb aquest patró s'assigna al camp de l'article de la Knowledge Base corresponent.

    Els patrons d'expressions regulars han de tenir un grup de captura entre parèntesis que us permeti extreure una part específica del text coincident. El text s'extreu del primer grup no buit de la primera coincidència.

    Aquests són alguns exemples de patrons d'expressions regulars per extreure contingut d'una etiqueta div específica:

    • Basat en l'identificador de l'etiqueta div: <div\b[^>]*id=\"your-id-name-here\"[^>]*>([\s\S]*?)<\/div>
    • Basat en la classe d'etiquetes div: <div\b[^>]*class=\"your-class-name-here\"[^>]*>([\s\S]*?)<\/div>
    • Per al contingut dins de l'etiqueta body: <body[^>]*>([\s\S]*)<\/body>
    • Per al contingut dins de l'etiqueta head: <head[^>]*>([\s\S]*)<\/head>

  • Directe: assigna el valor de qualsevol metaetiqueta del seu lloc web d'origen directament a qualsevol camp d'article de la Knowledge Base. La llista Propietat d'origen mostra totes les metaetiquetes extretes del lloc web d'exemple juntament amb les propietats d'origen HTML-Title i HTML-Body , que estan disponibles per defecte .

    Si seleccioneu Direct com a tipus d'operació i og: url com a propietat source, el valor de l'etiqueta meta og: url de la propietat source s'assigna a l'atribut d'article de la Knowledge Base corresponent.

  • Constant: introduïu un valor constant en qualsevol camp d'article de la Knowledge Base. La propietat source és un camp de text on podeu introduir el valor constant.

  • RegexUrl: M'agrada Regex, però només cerca coincidències a l'URL del lloc web d'origen. Per assignar tot l'URL del lloc web d'origen a un camp d'atribut de coneixement, seleccioneu Regexurl al tipus d'operació i utilitzeu el patró (. *) a la propietat source.

Aquí teniu un exemple que explica com mapejar els atributs de l'article.

Exemple

Exemple d'HTML:

<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>

Utilitzeu els tipus d'operació següents per assignar la propietat source a la destinació del fitxer html d'exemple:

La captura de pantalla explica l'assignació del fitxer html seleccionat.

on

  • Atribut de l'article: Contingut
  • Tipus d'operació: Regex
  • Propietat font: <body[^>]>([\s\S])</body>

L'expressió regular d'exemple extreu tot el contingut dins de l'etiqueta body del fitxer HTML.

  • Atribut de l'article: ID de referència externa
  • Tipus d'operació: RegexUrl
  • Propietat font: ^https://.? /id/(.?)/.*$

RegexUrl extreu l'id - 2911cacd-efa5-4593-ae22-e09ae14c6698 del fitxer HTML.

  • Atribut de l'article: Títol
  • Tipus d'operació: Directe
  • Propietat font: HTML-Title

Direct extreu el contingut dins del camp Títol del fitxer HTML, per exemple, WSTrustRequestSerializer.CanRead Method (Microsoft.IdentityModel.Protocols.WSTrust) | Microsoft Learn

  • Atribut de l'article: Descripció
  • Tipus d'operació: Regex
  • Propietat font: <div\b[^>]id="ms-descriptionArticle"[^>]>([\s\S]*?)</Div>

La mostra d'expressions regulars extreu contingut d'una etiqueta div específica en funció de l'ID. Aquí, ms-desciptionArticle és l'identificador de l'etiqueta div a l'html.

  • Atribut de l'article: Paraules clau
  • Tipus d'operació: Directe
  • Propietat font: ms.keywords

Direct extreu el contingut dins del camp ms.keywords del fitxer HTML, per exemple XML Reader, WS-Trust.

Esquema JSON

Obteniu més informació sobre els detalls de l'esquema per crear una plantilla d'assignació de metadades.

  1. Al mapa del lloc del Centre d'administració del Copilot Service, secció Esquema >JSON de l'esquema de l'article de la Knowledge Base, copieu i enganxeu les propietats de l'article i el JSON de l'esquema al camp que se us proporciona.

  2. Seleccioneu Valida JSON.

    Si la validació és correcta, veureu un missatge de confirmació. Si la validació falla, veureu un missatge d'error que identifica el paràmetre que té un valor incorrecte.

  3. Seleccioneu Següent per anar a la secció següent. Si voleu aturar-vos i tornar a aquest punt més endavant, seleccioneu Desa com a esborrany.

Passos següents

Gestionar proveïdors de cerca integrats