Samenvatting van gesprekken gebruiken
Belangrijk
Onze preview-regio, Zweden - centraal, toont onze nieuwste en voortdurend ontwikkelende LLM-verfijningstechnieken op basis van GPT-modellen. U bent van harte welkom om ze uit te proberen met een taalresource in de regio Zweden - centraal.
Samenvatting van gesprekken is alleen beschikbaar met:
- REST-API
- Python
- C#
Aspecten van gesprekssamenvatting
Hoofdstuktitel en verhaal (algemeen gesprek) zijn ontworpen om een gesprek samen te vatten in hoofdstuktitels en een samenvatting van de inhoud van het gesprek. Dit overzichtsaspect werkt aan gesprekken met een willekeurig aantal partijen.
Probleem en oplossing (callcenter gericht) is ontworpen om tekstchatlogboeken tussen klanten en klantenservicemedewerkers samen te vatten. Deze functie kan zowel problemen als oplossingen bieden die aanwezig zijn in deze logboeken, die zich tussen twee partijen voordoen.
Het verhaal is ontworpen om het verhaal van een gesprek samen te vatten.
Samenvatten is ontworpen om lange vergaderingen of gesprekken te verkorten tot een beknopt overzicht van één alinea om een kort overzicht te bieden.
Opvolgingstaken zijn ontworpen om actie-items en taken samen te vatten die zich tijdens een vergadering voordoen.
De AI-modellen die door de API worden gebruikt, worden door de service verschaft. U hoeft alleen maar inhoud voor analyse te verzenden.
Voor eenvoudigere navigatie zijn hier koppelingen naar de bijbehorende secties voor elke service:
| Aspect | Sectie |
|---|---|
| Probleem en oplossing | Probleem en oplossing |
| Titel van hoofdstuk | Titel van hoofdstuk |
| Verhaal | Verhaal |
| Samenvatting en opvolging | Samenvatten en opvolgen |
Functies
De samenvattings-API voor gesprekken maakt gebruik van technieken voor verwerking van natuurlijke taal om gesprekken samen te vatten in kortere samenvattingen per aanvraag. Samenvatting van gesprekken kan samenvatten voor problemen en oplossingen die worden besproken in een gesprek tussen twee partijen of een lang gesprek samenvatten in hoofdstukken en een kort verhaal voor elk hoofdstuk.
Er is een andere functie in Azure AI Language met de naam documentsamenvatting die geschikter is om documenten samen te vatten in beknopte samenvattingen. Houd rekening met de volgende punten wanneer u besluit tussen documentsamenvatting en gesprekssamenvatting:
- Invoerindeling: Samenvatting van gesprekken kan worden uitgevoerd op zowel chattekst als spraaktranscripties, die sprekers en hun uitingen hebben. Samenvatting van documenten werkt met eenvoudige tekst- of Word-, PDF- of PowerPoint-indelingen.
- Doel van samenvatting: bijvoorbeeld gespreksprobleem en oplossingssamenvatting retourneert een reden en de oplossing voor een chat tussen een klant en een klantenserviceagent.
Gegevens verzenden
Notitie
Zie het Language Studio-artikel voor informatie over het opmaken van gesprekstekst die u wilt verzenden met Behulp van Language Studio.
U verzendt documenten naar de API als tekenreeksen met tekst. Analyse wordt uitgevoerd na ontvangst van de aanvraag. Omdat de API asynchroon is, kan er een vertraging optreden tussen het verzenden van een API-aanvraag en het ontvangen van de resultaten. Zie de onderstaande gegevenslimieten voor informatie over de grootte en het aantal aanvragen dat u per minuut en seconde kunt verzenden.
Wanneer u deze functie gebruikt, zijn de API-resultaten gedurende 24 uur beschikbaar vanaf het moment dat de aanvraag is opgenomen en wordt aangegeven in het antwoord. Na deze periode worden de resultaten opgeschoond en zijn ze niet meer beschikbaar voor het ophalen.
Wanneer u gegevens verzendt naar een samenvatting van gesprekken, raden we u aan om één chatlogboek per aanvraag te verzenden voor een betere latentie.
Samenvattingen ophalen uit tekstchats
U kunt gespreksprobleem en oplossingssamenvatting gebruiken om samenvattingen op te halen die u nodig hebt. Zie het quickstart-artikel voor een voorbeeld met behulp van tekstchats.
Samenvattingen ophalen uit spraaktranscripties
Met samenvatting van gespreksprobleem en oplossing kunt u ook samenvattingen van spraaktranscripties ophalen met behulp van de spraak-naar-tekstfunctie van de Speech-service. In het volgende voorbeeld ziet u een kort gesprek dat u kunt opnemen in uw API-aanvragen.
"conversations":[
{
"id":"abcdefgh-1234-1234-1234-1234abcdefgh",
"language":"en",
"modality":"transcript",
"conversationItems":[
{
"modality":"transcript",
"participantId":"speaker",
"id":"12345678-abcd-efgh-1234-abcd123456",
"content":{
"text":"Hi.",
"lexical":"hi",
"itn":"hi",
"maskedItn":"hi",
"audioTimings":[
{
"word":"hi",
"offset":4500000,
"duration":2800000
}
]
}
}
]
}
]
Hoofdstuktitels ophalen
Samenvatting van de titel van het gesprekshoofdstuk kunt u hoofdstuktitels ophalen uit invoergesprekken. Hieronder vindt u een begeleid voorbeeldscenario:
- Kopieer de onderstaande opdracht naar een teksteditor. In het BASH-voorbeeld wordt het vervolgteken voor de
\regel gebruikt. Als in de console of terminal een ander regelvoortzettingsteken wordt gebruikt, gebruikt u dat teken.
curl -i -X POST https://<your-language-resource-endpoint>/language/analyze-conversations/jobs?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-language-resource-key>" \
-d \
'
{
"displayName": "Conversation Task Example",
"analysisInput": {
"conversations": [
{
"conversationItems": [
{
"text": "Hello, you’re chatting with Rene. How may I help you?",
"id": "1",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "Hi, I tried to set up wifi connection for Smart Brew 300 espresso machine, but it didn’t work.",
"id": "2",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "I’m sorry to hear that. Let’s see what we can do to fix this issue. Could you please try the following steps for me? First, could you push the wifi connection button, hold for 3 seconds, then let me know if the power light is slowly blinking on and off every second?",
"id": "3",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "Yes, I pushed the wifi connection button, and now the power light is slowly blinking.",
"id": "4",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "Great. Thank you! Now, please check in your Contoso Coffee app. Does it prompt to ask you to connect with the machine? ",
"id": "5",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "No. Nothing happened.",
"id": "6",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "I’m very sorry to hear that. Let me see if there’s another way to fix the issue. Please hold on for a minute.",
"id": "7",
"role": "Agent",
"participantId": "Agent_1"
}
],
"modality": "text",
"id": "conversation1",
"language": "en"
}
]
},
"tasks": [
{
"taskName": "Conversation Task 1",
"kind": "ConversationalSummarizationTask",
"parameters": {
"summaryAspects": [
"chapterTitle"
]
}
}
]
}
'
Breng waar nodig de volgende wijzigingen in de opdracht aan:
- Vervang de waarde van
your-value-language-keydoor uw sleutel. - Vervang het eerste deel van de aanvraag-URL
your-language-resource-endpointdoor uw eindpunt-URL.
- Vervang de waarde van
Open een opdrachtpromptvenster (bijvoorbeeld: BASH).
Plak de opdracht uit de teksteditor in het opdrachtpromptvenster en voer de opdracht uit.
Haal de
operation-locationantwoordheader op. De waarde ziet er ongeveer als volgt uit:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- Gebruik de volgende cURL-opdracht om de resultaten van de aanvraag op te halen. Zorg ervoor dat u vervangt door
<my-job-id>de GUID-waarde die u hebt ontvangen van de vorigeoperation-locationantwoordheader:
curl -X GET https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/<my-job-id>?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-language-resource-key>"
Voorbeeld van een samenvatting van de titel van het hoofdstuk JSON-antwoord:
{
"jobId": "b01af3b7-1870-460a-9e36-09af28d360a1",
"lastUpdatedDateTime": "2023-11-15T18:24:26Z",
"createdDateTime": "2023-11-15T18:24:23Z",
"expirationDateTime": "2023-11-16T18:24:23Z",
"status": "succeeded",
"errors": [],
"displayName": "Conversation Task Example",
"tasks": {
"completed": 1,
"failed": 0,
"inProgress": 0,
"total": 1,
"items": [
{
"kind": "conversationalSummarizationResults",
"taskName": "Conversation Task 1",
"lastUpdateDateTime": "2023-11-15T18:24:26.3433677Z",
"status": "succeeded",
"results": {
"conversations": [
{
"summaries": [
{
"aspect": "chapterTitle",
"text": "\"Discussing the Problem of Smart Blend 300 Espresso Machine's Wi-Fi Connectivity\"",
"contexts": [
{
"conversationItemId": "1",
"offset": 0,
"length": 53
},
{
"conversationItemId": "2",
"offset": 0,
"length": 94
},
{
"conversationItemId": "3",
"offset": 0,
"length": 266
},
{
"conversationItemId": "4",
"offset": 0,
"length": 85
},
{
"conversationItemId": "5",
"offset": 0,
"length": 119
},
{
"conversationItemId": "6",
"offset": 0,
"length": 21
},
{
"conversationItemId": "7",
"offset": 0,
"length": 109
}
]
}
],
"id": "conversation1",
"warnings": []
}
],
"errors": [],
"modelVersion": "latest"
}
}
]
}
}
Voor een lang gesprek kan het model het segment in meerdere samenhangende delen segmenteren en elk segment samenvatten. Er is ook een lang contexts veld voor elke samenvatting, waarmee wordt aangegeven vanaf welk bereik van het invoergesprek we de samenvatting hebben gegenereerd.
Samenvatting van verhalen ophalen
Met gesprekssamenvatting krijgt u ook verhalende samenvattingen van invoergesprekken. Hieronder vindt u een begeleid voorbeeldscenario:
- Kopieer de onderstaande opdracht naar een teksteditor. In het BASH-voorbeeld wordt het vervolgteken voor de
\regel gebruikt. Als in de console of terminal een ander regelvoortzettingsteken wordt gebruikt, gebruikt u dat teken.
curl -i -X POST https://<your-language-resource-endpoint>/language/analyze-conversations/jobs?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-language-resource-key>" \
-d \
'
{
"displayName": "Conversation Task Example",
"analysisInput": {
"conversations": [
{
"conversationItems": [
{
"text": "Hello, you’re chatting with Rene. How may I help you?",
"id": "1",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "Hi, I tried to set up wifi connection for Smart Brew 300 espresso machine, but it didn’t work.",
"id": "2",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "I’m sorry to hear that. Let’s see what we can do to fix this issue. Could you please try the following steps for me? First, could you push the wifi connection button, hold for 3 seconds, then let me know if the power light is slowly blinking on and off every second?",
"id": "3",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "Yes, I pushed the wifi connection button, and now the power light is slowly blinking.",
"id": "4",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "Great. Thank you! Now, please check in your Contoso Coffee app. Does it prompt to ask you to connect with the machine? ",
"id": "5",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "No. Nothing happened.",
"id": "6",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "I’m very sorry to hear that. Let me see if there’s another way to fix the issue. Please hold on for a minute.",
"id": "7",
"role": "Agent",
"participantId": "Agent_1"
}
],
"modality": "text",
"id": "conversation1",
"language": "en"
}
]
},
"tasks": [
{
"taskName": "Conversation Task 1",
"kind": "ConversationalSummarizationTask",
"parameters": {
"summaryAspects": [
"narrative"
]
}
}
]
}
'
Breng waar nodig de volgende wijzigingen in de opdracht aan:
- Vervang de waarde van
your-language-resource-keydoor uw sleutel. - Vervang het eerste deel van de aanvraag-URL
your-language-resource-endpointdoor uw eindpunt-URL.
- Vervang de waarde van
Open een opdrachtpromptvenster (bijvoorbeeld: BASH).
Plak de opdracht uit de teksteditor in het opdrachtpromptvenster en voer de opdracht uit.
Haal de
operation-locationantwoordheader op. De waarde ziet er ongeveer als volgt uit:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- Gebruik de volgende cURL-opdracht om de resultaten van een aanvraag op te halen. Zorg ervoor dat u vervangt door
<my-job-id>de GUID-waarde die u hebt ontvangen van de vorigeoperation-locationantwoordheader:
curl -X GET https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/<my-job-id>?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-language-resource-key>"
Voorbeeld van een samenvatting van JSON-antwoord:
{
"jobId": "d874a98c-bf31-4ac5-8b94-5c236f786754",
"lastUpdatedDateTime": "2022-09-29T17:36:42Z",
"createdDateTime": "2022-09-29T17:36:39Z",
"expirationDateTime": "2022-09-30T17:36:39Z",
"status": "succeeded",
"errors": [],
"displayName": "Conversation Task Example",
"tasks": {
"completed": 1,
"failed": 0,
"inProgress": 0,
"total": 1,
"items": [
{
"kind": "conversationalSummarizationResults",
"taskName": "Conversation Task 1",
"lastUpdateDateTime": "2022-09-29T17:36:42.895694Z",
"status": "succeeded",
"results": {
"conversations": [
{
"summaries": [
{
"aspect": "narrative",
"text": "Agent_1 helps customer to set up wifi connection for Smart Brew 300 espresso machine.",
"contexts": [
{ "conversationItemId": "1", "offset": 0, "length": 53 },
{ "conversationItemId": "2", "offset": 0, "length": 94 },
{ "conversationItemId": "3", "offset": 0, "length": 266 },
{ "conversationItemId": "4", "offset": 0, "length": 85 },
{ "conversationItemId": "5", "offset": 0, "length": 119 },
{ "conversationItemId": "6", "offset": 0, "length": 21 },
{ "conversationItemId": "7", "offset": 0, "length": 109 }
]
}
],
"id": "conversation1",
"warnings": []
}
],
"errors": [],
"modelVersion": "latest"
}
}
]
}
}
Voor een lang gesprek kan het model het segment in meerdere samenhangende delen segmenteren en elk segment samenvatten. Er is ook een lang contexts veld voor elke samenvatting, waarmee wordt aangegeven vanaf welk bereik van het invoergesprek we de samenvatting hebben gegenereerd.
Samenvatting van taken ophalen en opvolgen
Met gesprekssamenvatting kunt u ook samenvattingen en opvolgingstaken krijgen van invoergesprekken. Hieronder vindt u een begeleid voorbeeldscenario:
- Kopieer de onderstaande opdracht naar een teksteditor. In het BASH-voorbeeld wordt het vervolgteken voor de
\regel gebruikt. Als in de console of terminal een ander regelvoortzettingsteken wordt gebruikt, gebruikt u dat teken.
curl -i -X POST https://<your-language-resource-endpoint>/language/analyze-conversations/jobs?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-language-resource-key>" \
-d \
'
{
"displayName": "Conversation Task Example",
"analysisInput": {
"conversations": [
{
"conversationItems": [
{
"text": "Hello, you’re chatting with Rene. How may I help you?",
"id": "1",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "Hi, I tried to set up wifi connection for Smart Brew 300 espresso machine, but it didn’t work.",
"id": "2",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "I’m sorry to hear that. Let’s see what we can do to fix this issue. Could you please try the following steps for me? First, could you push the wifi connection button, hold for 3 seconds, then let me know if the power light is slowly blinking on and off every second?",
"id": "3",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "Yes, I pushed the wifi connection button, and now the power light is slowly blinking.",
"id": "4",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "Great. Thank you! Now, please check in your Contoso Coffee app. Does it prompt to ask you to connect with the machine? ",
"id": "5",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "No. Nothing happened.",
"id": "6",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "I’m very sorry to hear that. Let me see if there’s another way to fix the issue. Please hold on for a minute.",
"id": "7",
"role": "Agent",
"participantId": "Agent_1"
}
],
"modality": "text",
"id": "conversation1",
"language": "en"
}
]
},
"tasks": [
{
"taskName": "Conversation Task 1",
"kind": "ConversationalSummarizationTask",
"parameters": {
"summaryAspects": [
"recap",
"follow-up tasks"
]
}
}
]
}
'
Breng waar nodig de volgende wijzigingen in de opdracht aan:
- Vervang de waarde van
your-language-resource-keydoor uw sleutel. - Vervang het eerste deel van de aanvraag-URL
your-language-resource-endpointdoor uw eindpunt-URL.
- Vervang de waarde van
Open een opdrachtpromptvenster (bijvoorbeeld: BASH).
Plak de opdracht uit de teksteditor in het opdrachtpromptvenster en voer de opdracht uit.
Haal de
operation-locationantwoordheader op. De waarde ziet er ongeveer als volgt uit:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- Gebruik de volgende cURL-opdracht om de resultaten van een aanvraag op te halen. Zorg ervoor dat u vervangt door
<my-job-id>de GUID-waarde die u hebt ontvangen van de vorigeoperation-locationantwoordheader:
curl -X GET https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/<my-job-id>?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-language-resource-key>"
Voorbeeld van samenvatting en vervolgsamenvatting van JSON-antwoord:
{
"jobId": "e585d097-c19a-466e-8f99-a9646e55b1f5",
"lastUpdatedDateTime": "2023-11-15T18:19:56Z",
"createdDateTime": "2023-11-15T18:19:53Z",
"expirationDateTime": "2023-11-16T18:19:53Z",
"status": "succeeded",
"errors": [],
"displayName": "Conversation Task Example",
"tasks": {
"completed": 1,
"failed": 0,
"inProgress": 0,
"total": 1,
"items": [
{
"kind": "conversationalSummarizationResults",
"taskName": "Conversation Task 1",
"lastUpdateDateTime": "2023-11-15T18:19:56.1801785Z",
"status": "succeeded",
"results": {
"conversations": [
{
"summaries": [
{
"aspect": "recap",
"text": "The customer contacted the service agent, Rene, regarding an issue with setting up a wifi connection for their Smart Brew 300 espresso machine. The agent guided the customer through several steps, including pushing the wifi connection button and checking if the power light was blinking. However, the customer reported that no prompts were received in the Contoso Coffee app to connect with the machine. The agent then decided to look for another solution.",
"contexts": [
{
"conversationItemId": "1",
"offset": 0,
"length": 53
},
{
"conversationItemId": "2",
"offset": 0,
"length": 94
},
{
"conversationItemId": "3",
"offset": 0,
"length": 266
},
{
"conversationItemId": "4",
"offset": 0,
"length": 85
},
{
"conversationItemId": "5",
"offset": 0,
"length": 119
},
{
"conversationItemId": "6",
"offset": 0,
"length": 21
},
{
"conversationItemId": "7",
"offset": 0,
"length": 109
}
]
},
{
"aspect": "Follow-Up Tasks",
"text": "@Agent_1 will ask the customer to push the wifi connection button, hold for 3 seconds, then check if the power light is slowly blinking on and off every second."
},
{
"aspect": "Follow-Up Tasks",
"text": "@Agent_1 will ask the customer to check in the Contoso Coffee app if it prompts to connect with the machine."
},
{
"aspect": "Follow-Up Tasks",
"text": "@Agent_1 will investigate another way to fix the issue."
}
],
"id": "conversation1",
"warnings": []
}
],
"errors": [],
"modelVersion": "latest"
}
}
]
}
}
Voor een lang gesprek kan het model het segment in meerdere samenhangende delen segmenteren en elk segment samenvatten. Er is ook een lang contexts veld voor elke samenvatting, waarmee wordt aangegeven vanaf welk bereik van het invoergesprek we de samenvatting hebben gegenereerd.
Samenvattingsresultaten van gespreksprobleem en oplossing ophalen
De volgende tekst is een voorbeeld van inhoud die u kunt indienen voor gespreksprobleem en samenvatting van de oplossing. Dit is slechts een voorbeeld, de API kan langere invoertekst accepteren. Zie gegevenslimieten voor meer informatie.
Agent: "Hallo, hoe kan ik je helpen?"
Klant: "Hoe kan ik mijn Contoso-abonnement upgraden? Ik heb de hele dag geprobeerd.'
Agent: "Druk op de upgradeknop en meld u aan en volg de instructies."
Samenvatting wordt uitgevoerd na ontvangst van de aanvraag door een taak voor de API-back-end te maken. Als de taak is geslaagd, wordt de uitvoer van de API geretourneerd. De uitvoer is 24 uur beschikbaar voor ophalen. Na deze tijd wordt de uitvoer leeggemaakt. Vanwege meertalige ondersteuning voor emoji's kan het antwoord tekstverschuivingen bevatten. Zie Verschuivingen verwerken voor meer informatie.
In het bovenstaande voorbeeld kan de API de volgende samengevatte zinnen retourneren:
| Samengevatte tekst | Aspect |
|---|---|
| "De klant wil een upgrade uitvoeren van zijn of haar abonnement. De klant weet niet hoe. | Probleem |
| "De klant moet op de knop Upgrade drukken en zich aanmelden." | Resolutie |