internal HttpMessage CreateQueryRequest(string projectName, QueryKnowledgeBaseOptions knowledgeBaseQueryOptions, string deploymentName)
{
var message = _pipeline.CreateMessage();
var request = message.Request;
request.Method = RequestMethod.Post;
var uri = new RawRequestUriBuilder();
uri.Reset(endpoint);
uri.AppendRaw("/language", false);
uri.AppendPath("/:query-knowledgebases", false);
uri.AppendQuery("projectName", projectName, true);
if (deploymentName != null)
{
uri.AppendQuery("deploymentName", deploymentName, true);
}
uri.AppendQuery("api-version", apiVersion, true);
request.Uri = uri;
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Content-Type", "application/json");
var content = new Utf8JsonRequestContent();
content.JsonWriter.WriteObjectValue(knowledgeBaseQueryOptions);
request.Content = content;
return(message);
}
/// <summary>Answers the specified question using your knowledge base.</summary>
/// <param name="options">
/// An <see cref="QueryKnowledgeBaseOptions"/> containing the <see cref="QueryKnowledgeBaseOptions.ProjectName"/>,
/// <see cref="QueryKnowledgeBaseOptions.DeploymentName"/>, <see cref="QueryKnowledgeBaseOptions.Question"/>, and other options to answer a question.</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 <KnowledgeBaseAnswers> QueryKnowledgeBase(QueryKnowledgeBaseOptions options, CancellationToken cancellationToken = default)
{
Argument.AssertNotNull(options, nameof(options));
using DiagnosticScope scope = Diagnostics.CreateScope($"{nameof(QuestionAnsweringClient)}.{nameof(QueryKnowledgeBase)}");
scope.AddAttribute("projectName", options.ProjectName);
scope.AddAttribute("deploymentName", options.DeploymentName);
scope.Start();
try
{
return(_knowledgebaseRestClient.Query(options.ProjectName, options.DeploymentName, options, cancellationToken));
}
catch (Exception ex)
{
scope.Failed(ex);
throw;
}
}
/// <summary>Answers the specified question using your knowledge base.</summary>
/// <param name="projectName">The name of the project to use.</param>
/// <param name="options">The question to ask along with other options to query for answers.</param>
/// <param name="deploymentName">The optional deployment name of the project to use, such as "test" or "prod". If not specified, the "prod" knowledge base will be queried.</param>
/// <param name="cancellationToken">An optional <see cref="CancellationToken"/> to cancel the request.</param>
/// <exception cref="ArgumentNullException"><paramref name="projectName"/> or <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 async Task <Response <KnowledgeBaseAnswers> > QueryKnowledgeBaseAsync(string projectName, QueryKnowledgeBaseOptions options, string deploymentName = null, CancellationToken cancellationToken = default)
{
Argument.AssertNotNull(projectName, nameof(projectName));
Argument.AssertNotNull(options, nameof(options));
using DiagnosticScope scope = Diagnostics.CreateScope($"{nameof(QuestionAnsweringClient)}.{nameof(QueryKnowledgeBase)}");
scope.AddAttribute("project", projectName);
scope.Start();
try
{
return(await _knowledgebaseRestClient.QueryAsync(projectName, options, deploymentName, cancellationToken).ConfigureAwait(false));
}
catch (Exception ex)
{
scope.Failed(ex);
throw;
}
}
public async Task <Response <KnowledgeBaseAnswers> > QueryAsync(string projectName, QueryKnowledgeBaseOptions knowledgeBaseQueryOptions, string deploymentName = null, CancellationToken cancellationToken = default)
{
if (projectName == null)
{
throw new ArgumentNullException(nameof(projectName));
}
if (knowledgeBaseQueryOptions == null)
{
throw new ArgumentNullException(nameof(knowledgeBaseQueryOptions));
}
using var message = CreateQueryRequest(projectName, knowledgeBaseQueryOptions, deploymentName);
await _pipeline.SendAsync(message, cancellationToken).ConfigureAwait(false);
switch (message.Response.Status)
{
case 200:
{
KnowledgeBaseAnswers value = default;
using var document = await JsonDocument.ParseAsync(message.Response.ContentStream, default, cancellationToken).ConfigureAwait(false);
value = KnowledgeBaseAnswers.DeserializeKnowledgeBaseAnswers(document.RootElement);
return(Response.FromValue(value, message.Response));
}