Skip to content

Commit c65d9e6

Browse files
author
Jill Grant
authored
Merge pull request #280334 from glorialimicrosoft/main
Add docs for new feature - Message analysis under ACS Advanced Messaging
2 parents 1d129e3 + 69d6e00 commit c65d9e6

16 files changed

+278
-15
lines changed

articles/communication-services/.openpublishing.redirection.communication-services.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -455,6 +455,11 @@
455455
"source_path_from_root": "/articles/communication-services/concepts/troubleshooting-codes.md",
456456
"redirect_url": "/azure/communication-services/resources/troubleshooting/voice-video-calling/troubleshooting-codes",
457457
"redirect_document_id": false
458+
},
459+
{
460+
"source_path_from_root": "/articles/communication-services/concepts/advanced-messaging/message-analysis.md",
461+
"redirect_url": "/articles/communication-services/concepts/advanced-messaging/message-analysis/message-analysis.md",
462+
"redirect_document_id": false
458463
}
459464
]
460465
}
Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
---
2+
title: Message Analysis transparency FAQ
3+
titleSuffix: An Azure Communication Services Advanced Messaging concept
4+
description: Learn about the Message Analysis transparency FAQ
5+
author: gelli
6+
manager: camilo.ramirez
7+
services: azure-communication-services
8+
ms.author: gelli
9+
ms.date: 07/15/2024
10+
ms.topic: conceptual
11+
ms.service: azure-communication-services
12+
---
13+
14+
# Message Analysis: Responsible AI transparency FAQ
15+
16+
[!INCLUDE [Public Preview Notice](../../../includes/public-preview-include-document.md)]
17+
18+
## What is Message Analysis?
19+
20+
Message Analysis is an AI feature that analyses the incoming customer messages to extract insights that help developers enhance customer interactions. It detects the language, determines the intent (like a service question or complaint), and identifies key topics. Message Analysis can help businesses understand how well their communication strategies are working and improve their interactions with customers.
21+
22+
## What can Message Analysis do?
23+
24+
Message Analysis leverages advanced AI capabilities with Azure OpenAI to offer multifaceted functionality for customer interaction. It uses Azure OpenAI services to process messages received through platforms like WhatsApp. Here’s what it does:
25+
26+
* Language Detection: Identifies the language of the message, provides confidence scores, and translate the message into English if the original message isn't in English.
27+
* Intent Recognition: Analyzes the message to determine the customer’s purpose, such as seeking help or providing feedback.
28+
* Key Phrase Extraction: Extracts important terms and names from the message, which can be crucial for context.
29+
30+
This combination of features enables businesses to tailor their responses and better manage customer interactions.
31+
32+
## What are Message Analysis’s intended uses?
33+
34+
* Providing Message Analysis for agents or departments helps businesses resolve issues efficiently and provide a seamless end-user experience.
35+
36+
* Providing immediate feedback to customers by recognizing their needs.
37+
38+
* Enhancing the efficiency of customer service teams by prioritizing messages based on urgency or emotion.
39+
40+
* Improving the quality of customer interactions by understanding the context and nuances of their queries or comments.
41+
42+
## How was Message Analysis evaluated? What metrics are used to measure performance?
43+
44+
* Pre-Deployment Testing:
45+
46+
* Unit Testing: Develop and run unit tests for each component of the system to ensure they function correctly in isolation.
47+
48+
* Integration Testing: Test the integration of different system components, such as the interaction between the webhook receiver, Azure OpenAI API, and Event Grid. Testing helps to identify issues where components interact.
49+
50+
* Validation and Verification:
51+
52+
* Manual Verification: Conduct manual testing sessions where team members simulate real-world use cases to see how well the system processes and analyzes messages.
53+
54+
* Bug Bashing: Organize bug bashing events where team members and stakeholders work together to find as many issues as possible within a short time. These events can help uncover unexpected bugs or usability problems.
55+
56+
* Feedback in Production:
57+
58+
* User Feedback: Collect and analyze feedback from end-users. This direct input can provide insights into how well the feature meets user needs and expectations.
59+
60+
* User Surveys and Interviews: Conduct surveys and interviews with users to gather qualitative data on the system’s performance and the user experience.
61+
62+
## What are the limitations of Message Analysis? How can users minimize the impact of Message Analysis’s limitations when using the system?
63+
64+
* False positives:
65+
66+
* The system may occasionally generate false positive analyses, particularly when dealing with ambiguous, conflicting, or sarcastic content, and culturally specific phrases and idioms from customer messages that it cannot accurately interpret.
67+
68+
* Unsupported languages/ Translation Issues:
69+
70+
* If the model doesn't support the language, it can't be detected correctly or translated properly. There may also be misleading translations in the supported languages that you need to correct or build your own translation models.
71+
72+
73+
74+
## Which operational factors and settings enable effective and responsible use of Message Analysis?
75+
76+
* Explicit Meta-Prompt Components: Enhance the system's prompts with explicit meta-prompt components that guide the AI in understanding the context of the conversation better. This approach can improve the relevance and accuracy of the analysis by providing clearer instructions on what the system should focus on during its assessments.
77+
78+
* Canned Responses for Sensitive Messages: Flags sensitive topics or questions in the analysis response. This helps ensure that replies are respectful and legally compliant, reducing the risk of errors or inappropriate responses generated by the AI.
79+
80+
* Phased Release Plan: To gather feedback and ensure system stability, implement a staged rollout starting with a preview involving a limited user base before a full deployment. This phased approach enables real-time adjustments and risk management based on actual user experiences.
81+
82+
* Update Incident Response Plan: Regularly update the incident response plan to include procedures that address the integration of new features or potential new threats. This strategy ensures the team is prepared to handle unexpected situations effectively and can maintain system integrity and user trust.
83+
84+
* Rollback Plan: Develop a rollback strategy that enables quick reversion to a previous stable state if the new feature leads to unexpected issues. To ensure rapid response capabilities during critical situations, implement this strategy in the deployment pipelines.
85+
86+
* Feedback Analysis: To gather actionable insights, regularly collect and analyze feedback from users, particularly from Contoso. This feedback is crucial for continuous improvement and helps the development team understand the real-world impact of the features, leading to more targeted and effective updates.
87+
88+
## Next steps
89+
- [Enable Message Analysis With Azure OpenAI Quick Start](../../../quickstarts/advanced-messaging/message-analysis/message-analysis-with-azure-openai-quickstart.md)
90+
- [Handle Advanced Messaging events](../../../quickstarts/advanced-messaging/whatsapp/handle-advanced-messaging-events.md)
91+
- [Send WhatsApp template messages](../whatsapp/template-messages.md)

articles/communication-services/concepts/advanced-messaging/message-analysis.md renamed to articles/communication-services/concepts/advanced-messaging/message-analysis/message-analysis.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -12,12 +12,10 @@ services: azure-communication-services
1212

1313
# Connect Azure Communication Services to Azure OpenAI services for Message Analysis
1414

15-
[!INCLUDE [Public Preview Notice](../../includes/public-preview-include-document.md)]
15+
[!INCLUDE [Public Preview Notice](../../../includes/public-preview-include-document.md)]
1616

17-
Azure Communication Services Advanced Messaging empowers developers to create essential workflows for incoming messages within Azure Communication Services using event triggers. These triggers can initiate actions rooted in tailored business logic. Developers can analyze and gain insights from inbound messages to enhance customer service experience. With the integration of our AI-driven event trigger, Developers can utilize AI analysis to bolster customer support. Content analysis is streamlined using Azure OpenAI Services, which also supports various AI model preferences.
18-
In addition, there's no need for developers and businesses to handle credentials themselves. When linking your Azure AI services, managed identities are utilized to access resources owned by you.
19-
20-
Developers can also use managed identities to authenticate with any service that accepts Microsoft Entra authentication.
17+
Azure Communication Services Advanced Messaging enables developers to create workflows for incoming messages within Azure Communication Services using event triggers. These triggers can initiate actions rooted in tailored business logic. Developers can analyze and gain insights from inbound messages to enhance customer service experience. With the integration of the AI-driven event trigger, developers can utilize AI analysis to bolster customer support. Content analysis is streamlined using Azure OpenAI Services, which also supports various AI model preferences.
18+
In addition, there's no need for developers and businesses to handle credentials themselves. When linking your Azure AI services, managed identities are utilized to access resources owned by you.
2119
You can incorporate Azure OpenAI capabilities into your app's messaging system by activating the Message Analysis feature within your Communication Service resources on the Azure portal. When enabling the feature, you're going to configure an Azure OpenAI endpoint, and selecting the preferred model. This efficient method empowers developers to meet their needs and scale effectively for meeting analytical objectives without the need to invest considerable time and effort into developing and maintaining a custom AI solution for interpreting message content.
2220

2321
> [!NOTE]
@@ -64,7 +62,7 @@ This integration between Azure Communication Services and Azure AI services is o
6462
- brazilsouth
6563
- uaenorth
6664

67-
6865
## Next steps
69-
- [Handle Advanced Messaging events](../../quickstarts/advanced-messaging/whatsapp/handle-advanced-messaging-events.md)
70-
- [Send WhatsApp template messages](./whatsapp/template-messages.md)
66+
- [Enable Message Analysis With Azure OpenAI Quick Start](../../../quickstarts/advanced-messaging/message-analysis/message-analysis-with-azure-openai-quickstart.md)
67+
- [Handle Advanced Messaging events](../../../quickstarts/advanced-messaging/whatsapp/handle-advanced-messaging-events.md)
68+
- [Send WhatsApp template messages](../whatsapp/template-messages.md)
Loading
Loading
Loading
Loading
Loading
Loading
Loading

0 commit comments

Comments
 (0)