/// <summary>Analyzes a conversational utterance.</summary>
/// <param name="utterance">The conversation utterance to be analyzed.</param>
/// <param name="project">The <see cref="ConversationsProject"/> used for conversation analysis.</param>
/// <param name="options">Optional <see cref="AnalyzeConversationOptions"/> with additional query options.</param>
/// <param name="cancellationToken">An optional <see cref="CancellationToken"/> to cancel the request.</param>
/// <exception cref="ArgumentException"><paramref name="utterance"/> is an empty string.</exception>
/// <exception cref="ArgumentNullException"><paramref name="utterance"/> or <paramref name="project"/> or is null.</exception>
/// <exception cref="RequestFailedException">The service returned an error. The exception contains details of the service error.</exception>
public virtual Response <AnalyzeConversationTaskResult> AnalyzeConversation(string utterance, ConversationsProject project, AnalyzeConversationOptions options = null, CancellationToken cancellationToken = default)
{
Argument.AssertNotNullOrEmpty(utterance, nameof(utterance));
Argument.AssertNotNull(project, nameof(project));
CustomConversationTaskParameters customConversationTaskParameters = new CustomConversationTaskParameters(project.ProjectName, project.DeploymentName)
{
Verbose = options?.Verbose,
};
TextConversationItem textConversationItem = new TextConversationItem("1", "1", utterance);
options ??= new AnalyzeConversationOptions(textConversationItem);
CustomConversationalTask customConversationalTask = new CustomConversationalTask(options, customConversationTaskParameters);
using DiagnosticScope scope = Diagnostics.CreateScope($"{nameof(ConversationAnalysisClient)}.{nameof(AnalyzeConversation)}");
scope.AddAttribute("projectName", project.ProjectName);
scope.AddAttribute("deploymentName", project.DeploymentName);
scope.Start();
try
{
return(_analysisRestClient.AnalyzeConversation(customConversationalTask, cancellationToken));
}
catch (Exception ex)
{
scope.Failed(ex);
throw;
}
}
/// <summary>Analyzes a conversational utterance.</summary>
/// <param name="options">
/// An <see cref="AnalyzeConversationOptions"/> containing the <see cref="AnalyzeConversationOptions.ProjectName"/>,
/// <see cref="AnalyzeConversationOptions.DeploymentName"/>, <see cref="AnalyzeConversationOptions.Query"/>, and other options to analyze.</param>
/// <param name="cancellationToken">An optional <see cref="CancellationToken"/> to cancel the request.</param>
/// <exception cref="ArgumentNullException"><paramref name="options"/> is null.</exception>
/// <exception cref="RequestFailedException">The service returned an error. The exception contains details of the service error.</exception>
public virtual Response <AnalyzeConversationResult> AnalyzeConversation(AnalyzeConversationOptions options, CancellationToken cancellationToken = default)
{
Argument.AssertNotNull(options, nameof(options));
using DiagnosticScope scope = Diagnostics.CreateScope($"{nameof(ConversationAnalysisClient)}.{nameof(AnalyzeConversation)}");
scope.AddAttribute("projectName", options.ProjectName);
scope.AddAttribute("deploymentName", options.DeploymentName);
scope.Start();
try
{
return(_analysisRestClient.AnalyzeConversation(options.ProjectName, options.DeploymentName, options, cancellationToken));
}
catch (Exception ex)
{
scope.Failed(ex);
throw;
}
}
/// <summary>Analyzes a conversational utterance.</summary>
/// <param name="utterance">The conversation utterance to be analyzed.</param>
/// <param name="project">The <see cref="ConversationsProject"/> used for conversation analysis.</param>
/// <param name="options">Optional <see cref="AnalyzeConversationOptions"/> with additional query options.</param>
/// <param name="cancellationToken">An optional <see cref="CancellationToken"/> to cancel the request.</param>
/// <exception cref="ArgumentNullException"><paramref name="project"/> or <paramref name="utterance"/> is null.</exception>
/// <exception cref="RequestFailedException">The service returned an error. The exception contains details of the service error.</exception>
public virtual Response <AnalyzeConversationResult> AnalyzeConversation(string utterance, ConversationsProject project, AnalyzeConversationOptions options = null, CancellationToken cancellationToken = default)
{
Argument.AssertNotNull(project, nameof(project));
Argument.AssertNotNull(utterance, nameof(utterance));
options = options ?? new();
options.Utterance = utterance;
using DiagnosticScope scope = Diagnostics.CreateScope($"{nameof(ConversationAnalysisClient)}.{nameof(AnalyzeConversation)}");
scope.AddAttribute("projectName", project.ProjectName);
scope.AddAttribute("deploymentName", project.DeploymentName);
scope.Start();
try
{
return(_analysisRestClient.AnalyzeConversation(project.ProjectName, project.DeploymentName, options, cancellationToken));
}
catch (Exception ex)
{
scope.Failed(ex);
throw;
}
}