Using Azure OpenAI Service (GPT-4) in .NET

In this tutorial, we'll see how to call an Azure OpenAI Service GPT model from C#.

Required data from Azure

Key and endpoint: We can find this information in the Keys and Endpoint section in our Azure OpenAI Service resource.

 Azure OpenAI Service resource

Deployment name: This would be the instance of the model to use. In this case, we can go to the Azure OpenAI Service studio, and in the Deployments section specify a new one.

Azure OpenAI Service studio

Azure OpenAI client library for .NET

Azure OpenAI client library for .NET is an adaptation of OpenAI's REST APIs that provides an idiomatic interface and rich integration with the rest of the Azure SDK ecosystem.

This library will allow us to use the GPT model from C#.

NuGet package: Azure. AI.OpenAI

dotnet add package Azure.AI.OpenAI --version 1.0.0-beta.12

Code in C#

With the NuGet package installed, this is a C# class that will allow us to generate new text content using a specified prompt:

using Azure.AI.OpenAI;
using Azure;

namespace GenerativeAI;

public class AzureOpenAIGPT
{
    const string key = "YOUR_KEY";
    const string endpoint = "https://YOUR_RESOURCE_NAME.openai.azure.com/";
    const string deploymentOrModelName = "YOUR_DEPLOYMENT_NAME";

    public async Task<string> GetContent(string prompt)
    {
        var client = new OpenAIClient(new Uri(endpoint), new AzureKeyCredential(key));

        var chatCompletionsOptions = new ChatCompletionsOptions
        {
            DeploymentName = deploymentOrModelName,
            Temperature = (float)0.5,
            MaxTokens = 800,
            NucleusSamplingFactor = (float)0.95,
            FrequencyPenalty = 0,
            PresencePenalty = 0,
        };

        chatCompletionsOptions.Messages.Add(new ChatRequestUserMessage(prompt));
        var response = await client.GetChatCompletionsAsync(chatCompletionsOptions);

        return response.Value.Choices[0].Message.Content;

    }
}

In this code, it is important to mention that there are three types of messages or roles that can be considered for the interaction.

  • ChatRequestSystemMessage: represents instructions or other guidance about how the assistant should behave.
  • ChatRequestUserMessage: represents current or historical input from the end user.
  • ChatRequestAssistantMessage: represents historical responses from the assistant.

Example of a call from the console.

var gpt = new AzureOpenAIGPT();
var gptPrompt = "Generate a definition of Azure OpenAI Service";

Console.WriteLine($"{await gpt.GetContent(gptPrompt)}");

Console

Thanks for reading!

If you have any questions or ideas in mind, it'll be a pleasure to be able to be in communication with you, and together exchange knowledge with each other.

Additional Resources