Beszélgetések összegzésének használata
Fontos
Az előzetes verziójú régiónk, a Svédország középső régiója bemutatja a legújabb és folyamatosan fejlődő LLM finomhangolási technikákat GPT-modellek alapján. Szívesen kipróbálja őket egy nyelvi erőforrással a svédországi középső régióban.
A beszélgetések összegzése csak a következő használatával érhető el:
- REST API
- Python
- C#
A beszélgetések összegzésének szempontjai
A fejezetcím és az elbeszélés (általános beszélgetés) úgy lett kialakítva, hogy a beszélgetéseket fejezetcímekbe foglalja össze, és összefoglalja a beszélgetés tartalmát. Ez az összegzési szempont bármilyen számú féllel folytatott beszélgetéseken működik.
A probléma- és megoldási (call center-központú) szolgáltatás célja az ügyfelek és az ügyfélszolgálati ügynökök közötti szöveges csevegési naplók összegzése. Ez a funkció képes a naplókban szereplő problémák és megoldások biztosítására, amelyek két fél között fordulnak elő.
A narratíva egy beszélgetés narratíváját foglalja össze.
A Recap célja a hosszú értekezletek vagy beszélgetések tömör, egy bekezdésből áll, és gyors áttekintést nyújt.
A követő tevékenységek az értekezletek során felmerülő műveletelemek és feladatok összegzésére szolgálnak.
Az API által használt AI-modelleket a szolgáltatás biztosítja, csak elemzés céljából kell tartalmat küldenie.
A könnyebb navigálás érdekében az alábbi hivatkozások az egyes szolgáltatások megfelelő szakaszaira mutatnak:
| Szempont | Section |
|---|---|
| Probléma és megoldás | Probléma és megoldás |
| Fejezet címe | Fejezet címe |
| Beszámoló | Elbeszélő |
| Összegzés és nyomon követés | Összegzés és nyomon követés |
Funkciók
A beszélgetés-összefoglaló API természetes nyelvi feldolgozási technikákat használ a beszélgetések kérésenként rövidebb összegzésekbe való összegzéséhez. A beszélgetések összegzése összefoglalhatja a két fél által folytatott beszélgetésekben tárgyalt problémákat és megoldásokat, vagy egy hosszú beszélgetést fejezetekbe és egy rövid elbeszélésbe foglalhat minden fejezethez.
Az Azure AI Language egy másik funkciója, a szövegösszesítés , amely alkalmasabb a dokumentumok tömör összegzésekbe való összegzésére. Amikor a szövegösszesítés és a beszélgetés összegzése között dönt, vegye figyelembe a következő szempontokat:
- Bemeneti formátum: A beszélgetések összegzése a csevegőszövegen és a beszéd átiratán is működik, amelyek hangszórókkal és kimondott szövegekkel rendelkeznek. A szövegösszesítés egyszerű szöveg- vagy Word-, PDF- vagy PowerPoint-formátumokkal működik.
- Az összegzés célja: a beszélgetési probléma és a megoldás összegzése például egy ügyfél és egy ügyfélszolgálati ügynök közötti csevegés okát és megoldását adja vissza.
Adatok beküldése
Feljegyzés
A Language Studio cikkében további információt talál a Language Studio használatával elküldendő beszélgetési szövegek formázásáról.
A dokumentumokat szöveges sztringekként küldi el az API-nak. Az elemzés a kérelem megkapásakor történik meg. Mivel az API aszinkron, előfordulhat, hogy az API-kérés küldése és az eredmények fogadása között késés tapasztalható. A percenként és másodpercenként küldhető kérelmek méretével és számával kapcsolatos információkért tekintse meg az alábbi adatkorlátokat.
A funkció használatakor az API-eredmények a kérelem betöltésétől számítva 24 órán át érhetők el, és a válasz jelzi. Ez után az idő elteltével az eredmények törlődnek, és már nem érhetők el a lekéréshez.
Amikor adatokat küld a beszélgetések összegzésére, javasoljuk, hogy kérésenként küldjön egy csevegőnaplót a jobb késés érdekében.
Összefoglalók lekérése szöveges csevegésekből
A beszélgetési probléma és a megoldás összegzésével igény szerint lekérheti az összegzéseket. Ha szöveges csevegéseket használó példát szeretne látni, tekintse meg a rövid útmutatót.
Összefoglalók lekérése beszédátiratokból
A beszélgetési probléma és a megoldás összegzése lehetővé teszi az összefoglalók lekérését a beszéd átirataiból a Speech service beszédről szövegre funkciójával. Az alábbi példa egy rövid beszélgetést mutat be, amelyet belefoglalhat az API-kérelmekbe.
"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
}
]
}
}
]
}
]
Fejezetcímek lekérése
A beszélgetés fejezetcímének összegzése lehetővé teszi a fejezetcímek lekérését a bemeneti beszélgetésekből. Az alábbiakban egy irányított példaforgatókönyvet talál:
- Másolja az alábbi parancsot egy szövegszerkesztőbe. A BASH-példa a sor folytatási karakterét
\használja. Ha a konzol vagy a terminál más vonal folytatási karaktert használ, használja ezt a karaktert.
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"
]
}
}
]
}
'
Hajtsa végre a következő módosításokat a parancs megfelelő területein:
- Cserélje le az értéket
your-value-language-keya kulcsra. - Cserélje le a kérelem URL-címének
your-language-resource-endpointelső részét a végpont URL-címére.
- Cserélje le az értéket
Nyisson meg egy parancssori ablakot (például: BASH).
Illessze be a parancsot a szövegszerkesztőből a parancssori ablakba, majd futtassa a parancsot.
operation-locationA válasz fejlécének lekérése. Az érték a következő URL-címhez hasonló:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- A kérés eredményeinek lekéréséhez használja a következő cURL-parancsot. Mindenképpen cserélje le
<my-job-id>az előzőoperation-locationválaszfejlécből kapott GUID-értéket:
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>"
Példa fejezetcím összegző JSON-válasz:
{
"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"
}
}
]
}
}
Hosszú beszélgetés esetén a modell több összetartó részre szegmentálta, és összegezheti az egyes szegmenseket. Minden összegzéshez tartozik egy hosszú contexts mező is, amely azt jelzi, hogy a bemeneti beszélgetés melyik tartományából hoztuk létre az összegzést.
Narratív összegzés lekérése
A beszélgetések összegzése azt is lehetővé teszi, hogy narratív összegzéseket kapjon a bemeneti beszélgetésekből. Az alábbiakban egy irányított példaforgatókönyvet talál:
- Másolja az alábbi parancsot egy szövegszerkesztőbe. A BASH-példa a sor folytatási karakterét
\használja. Ha a konzol vagy a terminál más vonal folytatási karaktert használ, használja ezt a karaktert.
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"
]
}
}
]
}
'
Hajtsa végre a következő módosításokat a parancs megfelelő területein:
- Cserélje le az értéket
your-language-resource-keya kulcsra. - Cserélje le a kérelem URL-címének
your-language-resource-endpointelső részét a végpont URL-címére.
- Cserélje le az értéket
Nyisson meg egy parancssori ablakot (például: BASH).
Illessze be a parancsot a szövegszerkesztőből a parancssori ablakba, majd futtassa a parancsot.
operation-locationA válasz fejlécének lekérése. Az érték a következő URL-címhez hasonló:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- A kérés eredményeinek lekéréséhez használja a következő cURL-parancsot. Mindenképpen cserélje le
<my-job-id>az előzőoperation-locationválaszfejlécből kapott GUID-értéket:
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>"
Példa narratív összegzés JSON-válaszra:
{
"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"
}
}
]
}
}
Hosszú beszélgetés esetén a modell több összetartó részre szegmentálta, és összegezheti az egyes szegmenseket. Minden összegzéshez tartozik egy hosszú contexts mező is, amely azt jelzi, hogy a bemeneti beszélgetés melyik tartományából hoztuk létre az összegzést.
Feladat összegzésének és nyomon követésének lekérése
A beszélgetések összegzése lehetővé teszi a bemeneti beszélgetések újrabefoglalását és nyomon követését is. Az alábbiakban egy irányított példaforgatókönyvet talál:
- Másolja az alábbi parancsot egy szövegszerkesztőbe. A BASH-példa a sor folytatási karakterét
\használja. Ha a konzol vagy a terminál más vonal folytatási karaktert használ, használja ezt a karaktert.
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"
]
}
}
]
}
'
Hajtsa végre a következő módosításokat a parancs megfelelő területein:
- Cserélje le az értéket
your-language-resource-keya kulcsra. - Cserélje le a kérelem URL-címének
your-language-resource-endpointelső részét a végpont URL-címére.
- Cserélje le az értéket
Nyisson meg egy parancssori ablakot (például: BASH).
Illessze be a parancsot a szövegszerkesztőből a parancssori ablakba, majd futtassa a parancsot.
operation-locationA válasz fejlécének lekérése. Az érték a következő URL-címhez hasonló:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- A kérés eredményeinek lekéréséhez használja a következő cURL-parancsot. Mindenképpen cserélje le
<my-job-id>az előzőoperation-locationválaszfejlécből kapott GUID-értéket:
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>"
Példa a JSON-válaszok összegzésére és nyomon követésére:
{
"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"
}
}
]
}
}
Hosszú beszélgetés esetén a modell több összetartó részre szegmentálta, és összegezheti az egyes szegmenseket. Minden összegzéshez tartozik egy hosszú contexts mező is, amely azt jelzi, hogy a bemeneti beszélgetés melyik tartományából hoztuk létre az összegzést.
Beszélgetési probléma és a megoldás összegzési eredményeinek lekérése
Az alábbi szöveg egy példa a beszélgetéssel kapcsolatos problémákra és a megoldás összegzésére beküldhet tartalmakra. Ez csak egy példa, az API hosszabb bemeneti szöveget is elfogad. További információért tekintse meg az adatkorlátokat .
Ügynök: "Hello, hogyan segíthetek?"
Ügyfél: "Hogyan frissíthetem a Contoso-előfizetésemet? Egész nap próbálkoztam."
Ügynök: "Nyomja le a frissítés gombot, majd jelentkezzen be, és kövesse az utasításokat."
Az összegzés a kérelem beérkezésekor történik, és létrehoz egy feladatot az API-háttérrendszer számára. Ha a feladat sikeres volt, a rendszer visszaadja az API kimenetét. A kimenet 24 órán keresztül kérhető le. Ezután a kimenet törlődik. A többnyelvű és emoji támogatás miatt a válasz szövegeltolásokat tartalmazhat. További információkért tekintse meg az eltolások feldolgozásának módját.
A fenti példában az API a következő összegzett mondatokat adja vissza:
| Összegzett szöveg | Szempont |
|---|---|
| "Az ügyfél frissíteni szeretné az előfizetését. Az ügyfél nem tudja, hogyan." | kiad |
| "Az ügyfélnek le kell nyomnia a frissítés gombot, és be kell jelentkeznie." | felbontás |