Contextvariabelen voor bots configureren
Belangrijk
Power Virtual Agents-mogelijkheden en -functies maken nu deel uit van Microsoft Copilot Studio na aanzienlijke investeringen in generatieve AI en verbeterde integraties binnen Microsoft Copilot.
Sommige artikelen en schermopnamen verwijzen mogelijk naar Power Virtual Agents terwijl we de documentatie en trainingsinhoud bijwerken.
In dit artikel worden de contextvariabelen voor Azure en Copilot Studio-bots beschreven en hoe u ze kunt configureren in Omnichannel voor Customer Service. Als u wilt begrijpen hoe u contextvariabelen maakt, bekijkt u: Contextvariabelen beheren.
Contextvariabelen voor Azure-bots
De volgende tabel bevat de lijst met contextvariabelen in Omnichannel voor Customer Service die u kunt gebruiken voor het configureren van Azure-bots.
| Type contextvariabele | Naam contextvariabele | Omschrijving | Wijze van toewijzen in Azure |
|---|---|---|---|
| Onderzoek vóór gesprek | Gebruik het vraagtype dat u in Omnichannel voor Customer Service maakt. | Met de contextvariabelen voor antwoorden vóór gesprekken worden de antwoorden van de klant opgeslagen voor vragen in het onderzoek vóór gesprekken. | Gebruik de volgende informatie om de vraagtypevariabele in Omnichannel voor Customer Service toe te wijzen aan het variabeletype in Azure:
|
| Aangepaste context | Gebruik de variabelenaam die u maakt in Omnichannel voor Customer Service of geef deze door met behulp van de setContextProvider-API. | Dit zijn aangepaste contextvariabelen die kunnen worden gemaakt en doorgegeven via de live chat-SDK. | Wijs de reactie van de gebruiker toe als een JSON om een aangepaste contextvariabele te gebruiken in Omnichannel voor Customer Service. |
| Gesprek | msdyn_ConversationId | Gebruik de contextvariabele die de gespreks-ID bevat voor het lopende gesprek en die bewerkingen kan ophalen en uitvoeren in de record in Microsoft Dataverse. | Tekenreeks: tekenreeks |
| Contactpersoon | msdyn_contact_msdyn_ocliveworkitem_Customer | Gebruik deze contextvariabele die de record-ID bevat voor de klant(contact)record die aan het gesprek is gekoppeld. | JSON parseren om record-ID te extraheren |
| Rekening | msdyn_account_msdyn_ocliveworkitem_Customer | Gebruik deze contextvariabele die de record-ID bevat voor de accountrecord die aan het gesprek is gekoppeld. | JSON parseren om record-ID te extraheren |
| Aanvraag | msdyn_incident_msdyn_ocliveworkitem | Gebruik deze contextvariabele die de record-ID voor de aanvraagrecord bevat die aan het gesprek is gekoppeld. | JSON parseren om record-ID te extraheren |
Notitie
Gebruik de namen van de contextvariabelen zoals gedefinieerd en wijzig ze niet wanneer u stromen schrijft in Azure of Copilot Studio-bots. Zorg ervoor dat u ook een exacte overeenkomst gebruikt om de waarde door te geven aan de contextvariabele omdat deze hoofdlettergevoelig is. Als er een mismatch is, wordt het record niet automatisch geïdentificeerd. Meer informatie: Records automatisch identificeren
Contextvariabelen voor Copilot Studio-bots
De volgende tabel bevat de lijst met contextvariabelen die beschikbaar zijn in Omnichannel voor Customer Service die u kunt gebruiken voor het configureren van Copilot Studio-bots.
Belangrijk
Om de berichten- en spraakvariabelen te kunnen gebruiken, moet u ervoor zorgen dat u eerst de extensieoplossingen installeert.
| Type contextvariabele | Naam contextvariabele | Omschrijving | Wijze van toewijzen in Copilot Studio |
|---|---|---|---|
| Onderzoek vóór gesprek | Gebruik het vraagtype dat u in Omnichannel voor Customer Service maakt. | Met de contextvariabelen voor antwoorden vóór gesprekken worden de antwoorden van de klant opgeslagen voor vragen in het onderzoek vóór gesprekken. | Gebruik de volgende informatie om de vraagtypevariabele in Omnichannel voor Customer Service toe te wijzen aan het variabeletype in Copilot Studio:
|
| Aangepaste context | Gebruik de variabelenaam die u maakt in Omnichannel voor Customer Service of geef deze door met behulp van de setContextProvider-API. | Dit zijn aangepaste contextvariabelen die kunnen worden gemaakt en doorgegeven via de live chat-SDK. | Gebruik de volgende informatie om de aangepaste-contextvariabele in Omnichannel voor Customer Service toe te wijzen aan het variabeletype in Copilot Studio:
|
| Gesprek | msdyn_ConversationId | Gebruik de contextvariabele die de gespreks-ID bevat voor het lopende gesprek en die bewerkingen kan ophalen en uitvoeren in de record in Microsoft Dataverse. | Tekenreeks: volledige respons van de gebruiker. |
| Berichten- en spraakvariabelen | msdyn_CustomerType | Gebruik deze contextvariabele die het klanttype bevat voor de record van account of contactpersoon die aan het gesprek is gekoppeld. | Selecteer de oplossingsvariabele Omnichannel voor Customer Service-extensie. |
| msdyn_CustomerName | Gebruik deze contextvariabele die de klantnaam bevat voor de record van account of contactpersoon die aan het gesprek is gekoppeld. | Selecteer de oplossingsvariabele Omnichannel voor Customer Service-extensie. | |
| msdyn_CustomerId | Gebruik deze contextvariabele die de klant-id bevat voor de record van account of contactpersoon die aan het gesprek is gekoppeld. | Selecteer de oplossingsvariabele Omnichannel voor Customer Service-extensie. | |
| msdyn_CaseId | Gebruik deze contextvariabele die de id bevat voor de caserecord die aan het gesprek is gekoppeld. | Selecteer de oplossingsvariabele Omnichannel voor Customer Service-extensie. | |
| msdyn_CaseTitle | Gebruik deze contextvariabele die de titel bevat voor de caserecord die aan het gesprek is gekoppeld. | Selecteer de oplossingsvariabele Omnichannel voor Customer Service-extensie. | |
| Alleen spraakvariabelen | CustomerPhoneNumber | Gebruik deze contextvariabele voor het telefoonnummer van de klant dat is opgegeven in de activiteit Telefonie. | Selecteer de oplossingsvariabele Omnichannel voor Customer Service-extensie. |
| OrganizationPhoneNumber | Gebruik deze contextvariabele voor het telefoonnummer van de organisatie dat is opgegeven in de activiteit Telefonie. | Selecteer de oplossingsvariabele Omnichannel voor Customer Service-extensie. | |
| Naam van extensiemethode | va_SurveyConsent | Gebruik dit dialoogvenster om tijdens het gesprek te bepalen of een klant heeft ingestemd met deelname aan onderzoeken. | Gebruik deze methode om gespreksdetails te escaleren naar Omnichannel voor Customer Service. |
| va_CustomerLocale | Gebruik dit dialoogvenster om de gebruiker die momenteel met de bot praat, over te zetten naar een andere bot die mogelijk in een andere taal spreekt. | Stel de code in door de invoervariabele te selecteren en de juiste landcode te gebruiken. | |
Contextvariabelen voor Copilot Studio-bots configureren
In Copilot Studio doet u het volgende:
Selecteer Nieuw onderwerp op de pagina Onderwerpen.
Voer in het tabblad Instellen een naam en beschrijving in en sla het onderwerp op.
Selecteer Naar creatiecanvas gaan.
Selecteer Knooppunt toevoegen, en kies de actie Een vraag stellen.
Bewerk het veld Identificeren en selecteer in het dialoogvenster Kies informatie om te identificeren een optie die overeenkomt met het gegevenstype van de contextvariabele. Zie voor informatie over het toewijzen van gegevenstypen de informatie in de voorgaande tabel.
Bewerk Reactie opslaan als en wijzig in het dialoogvenster Variabele eigenschappen de waarde voor Naam in de vereiste contextvariabele van Omnichannel voor Customer Service. Zorg ervoor dat Bot (elk onderwerp heeft toegang) en Externe bronnen kunnen waarden instellen zijn geselecteerd. De optie Externe bronnen kunnen waarden instellen is alleen van toepassing voor het ophalen van de contextvariabele.
Sla de wijzigingen op en publiceer deze.
Tijdens runtime wordt de vereiste informatie vastgelegd in de contextvariabele die vervolgens kan worden gebruikt voor verdere acties op basis van de workflow die u configureert. De bot kan de informatie voor de contextvariabelen instellen om het gesprek en de case te koppelen wanneer de bot het gesprek escaleert naar een agent. Meer informatie: Klant en case aan een gesprek koppelen
U kunt ook het knooppunt Overdragen aan agent in het onderwerp Copilot Studio configureren om tijdens de escalatie een privébericht met relevante contextvariabelen naar de live agent te sturen.
De algemene variabelen die zijn gemaakt in Copilot Studio kunnen worden doorgegeven aan Omnichannel voor Customer Service wanneer een gesprek wordt geëscaleerd. Zie Contextvariabelen die beschikbaar zijn bij overdracht voor de volledige lijst.
JSON-object parseren om record-id te extraheren
Controleer of u de volgende gegevens hebt:
- De Omnichannel voor Customer Service-contextvariabele, zoals msdyn_contact_msdyn_ocliveworkitem_Customer.
- De schemagegevens
Een kopie van de gegevens van het voorbeeldschema is als volgt:
Schema:
{
"type": "array",
"items": {
"type": "object",
"properties": {
"RecordId": {
"type": "string"
},
"PrimaryDisplayValue": {
"type": "string"
}
},
"required": [
"RecordId",
"PrimaryDisplayValue"
]
}
}
PrimaryDisplayValue bevat de waarde van het kenmerk in de Dataverse-entiteiten. De toewijzing voor de entiteitskenmerken is als volgt:
- Aanvragen: Aanvraagtitel
- Contactpersonen: Volledige naam
- Accounts: Naam
Hier is een voorbeeld van een contextrecord.
{
"msdyn_contact_msdyn_ocliveworkitem_Customer": [
{
"RecordId": "<GUID>",
"PrimaryDisplayValue": "<FullName>"
}
],
"msdyn_liveworkitemid": "<GUID>"
}
Zie ook
Een Copilot Studio-bot integreren
Een Azure-bot integreren
Bots configureren om gesprekken te escaleren en te beëindigen
SDK-referentie voor Live chat