Aracılığıyla paylaş

.NET AI sohbet uygulamasından verileriniz hakkında içgörüler edinin

  • Makale

OpenAI gpt-3.5-turbo modeline bağlanmak için .NET 8 konsol uygulamasını kullanarak yapay zeka geliştirmeye başlayın. Yürüyüş verilerini analiz etmek ve içgörüler sağlamak için Anlam Çekirdeği'ni kullanarak yapay zeka modeline bağlanacaksınız.

Önkoşullar

  • .NET 8.0 SDK - .NET 8.0 SDK'sını yükleyin.
  • Bu örneği çalıştırabilmeniz için OpenAI'den bir API anahtarı.
  • Windows'da PowerShell v7+ gereklidir. Sürümünüzü doğrulamak için bir terminalde çalıştırın pwsh . Geçerli sürümü döndürmelidir. Hata döndürürse aşağıdaki komutu yürütür: dotnet tool update --global PowerShell.

Azure'da dağıtılan bir OpenAI gpt-3.5-turbo modeline bağlanmak için .NET 8 konsol uygulamasını kullanarak yapay zeka geliştirmeye başlayın. Yürüyüş verilerini analiz etmek ve içgörüler sağlamak için Anlam Çekirdeği'ni kullanarak yapay zeka modeline bağlanacaksınız.

Önkoşullar

  • .NET 8 SDK - .NET 8 SDK'sını yükleyin.
  • Azure aboneliği - Ücretsiz bir abonelik oluşturun.
  • Azure Geliştirici CLI'sı - Azure Geliştirici CLI'sını yükleyin veya güncelleştirin.
  • Azure OpenAI hizmetine erişim.
  • Windows'da PowerShell v7+ gereklidir. Sürümünüzü doğrulamak için bir terminalde çalıştırın pwsh . Geçerli sürümü döndürmelidir. Hata döndürürse aşağıdaki komutu yürütür: dotnet tool update --global PowerShell.

Örnek projeyi alma

Tüm hızlı başlangıçlar için örnek uygulamaları içeren GitHub deposunu kopyalayın:

git clone https://github.com/dotnet/ai-samples.git

Azure OpenAI hizmetini oluşturma

Örnek GitHub deposu, azd Azure OpenAI hizmetini ve modelini sizin için sağlamak için kullanabileceğiniz bir Azure Geliştirici CLI (azd) şablonu olarak yapılandırılmıştır.

  1. Terminal veya komut isteminden örnek deponun src\quickstarts\azure-openai dizinine gidin.

  2. azd up Azure OpenAI kaynaklarını sağlamak için komutunu çalıştırın. Azure OpenAI hizmetinin oluşturulması ve modelin dağıtılması birkaç dakika sürebilir.

    azd up

    azd ayrıca OpenAI erişim anahtarı gibi örnek uygulama için gerekli kullanıcı gizli dizilerini yapılandırıyor.

    Not

    Dağıtım sırasında azd up bir hatayla karşılaşırsanız sorun giderme bölümünü ziyaret edin.

Yürüyüş sohbet örneğini deneyin

  1. Terminalden veya komut isteminden dizine openai\03-ChattingAboutMyHikes gidin.

  2. OpenAI API anahtarınızı örnek uygulama için gizli dizi olarak yapılandırmak için aşağıdaki komutları çalıştırın:

    dotnet user-secrets init
dotnet user-secrets set OpenAIKey <your-openai-key>

  3. dotnet run Uygulamayı çalıştırmak için komutunu kullanın:

    dotnet run

  1. Terminalden veya komut isteminden dizine azure-openai\02-HikerAI gidin.

  2. dotnet run Uygulamayı çalıştırmak için komutunu kullanın:

    dotnet run

    İpucu

    Hata iletisi alırsanız, Azure OpenAI kaynaklarının dağıtımı tamamlanmamış olabilir. Birkaç dakika bekleyin ve yeniden deneyin.

Kodu keşfetme

Uygulama, openAI hizmetine istek göndermek ve almak için paketini kullanır Microsoft.SemanticKernel .

Uygulamanın tamamı Program.cs dosyasının içinde yer alır. Kod kümesinin ilk birkaç satırı yapılandırma değerlerini ayarlar ve önceden komutu kullanılarak dotnet user-secrets ayarlanan OpenAI Anahtarını alır.

var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
string model = "gpt-3.5-turbo";
string key = config["OpenAIKey"];

Hizmet, OpenAIChatCompletionService istekleri ve yanıtları kolaylaştırır.

// Create the OpenAI Chat Completion Service
OpenAIChatCompletionService service = new(model, key);

OpenAIChatCompletionService İstemci oluşturulduktan sonra, uygulama dosyanın hikes.md içeriğini okur ve bir sistem istemi ekleyerek modele daha fazla bağlam sağlamak için bunu kullanır. Bu, konuşma sırasında model davranışını ve oluşturulan tamamlamaları etkiler.

Uygulama, Azure'da Microsoft.SemanticKernel dağıtılan bir Azure OpenAI hizmetine istek göndermek ve almak için paketini kullanır.

Uygulamanın tamamı Program.cs dosyasının içinde yer alır. İlk birkaç kod satırı, uygulama sağlama sırasında içinde ayarlanmış dotnet user-secrets olan gizli dizileri ve yapılandırma değerlerini yükler.

// == Retrieve the local secrets saved during the Azure deployment ==========
var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
string endpoint = config["AZURE_OPENAI_ENDPOINT"];
string deployment = config["AZURE_OPENAI_GPT_NAME"];
string key = config["AZURE_OPENAI_KEY"];

Hizmet, AzureOpenAIChatCompletionService istekleri ve yanıtları kolaylaştırır.

// == Create the Azure OpenAI Chat Completion Service  ==========
AzureOpenAIChatCompletionService service = new(deployment, endpoint, key);

OpenAIChatCompletionService İstemci oluşturulduktan sonra, uygulama dosyanın hikes.md içeriğini okur ve bir sistem istemi ekleyerek modele daha fazla bağlam sağlamak için bunu kullanır. Bu, konuşma sırasında model davranışını ve oluşturulan tamamlamaları etkiler.

// Provide context for the AI model
ChatHistory chatHistory = new($"""
    You are upbeat and friendly. You introduce yourself when first saying hello. 
    Provide a short answer only based on the user hiking records below:  

    {File.ReadAllText("hikes.md")}
    """);
Console.WriteLine($"{chatHistory.Last().Role} >>> {chatHistory.Last().Content}");

Aşağıdaki kod, işlevini kullanarak AddUserMessage modele bir kullanıcı istemi ekler. işlevi, GetChatMessageContentAsync modele sistem ve kullanıcı istemlerini temel alan bir yanıt oluşturmasını ister.

// Start the conversation
chatHistory.AddUserMessage("Hi!");
Console.WriteLine($"{chatHistory.Last().Role} >>> {chatHistory.Last().Content}");

chatHistory.Add(
    await service.GetChatMessageContentAsync(
        chatHistory,
        new OpenAIPromptExecutionSettings()
        { 
            MaxTokens = 400 
        }));
Console.WriteLine($"{chatHistory.Last().Role} >>> {chatHistory.Last().Content}");

Uygulama, sohbet geçmişini veya bağlamını korumak için modelin chatHistory yanıtını öğesine ekler.

// Continue the conversation with a question.
chatHistory.AddUserMessage(
    "I would like to know the ratio of the hikes I've done in Canada compared to other countries.");

Console.WriteLine($"{chatHistory.Last().Role} >>> {chatHistory.Last().Content}");

chatHistory.Add(await service.GetChatMessageContentAsync(
    chatHistory,
    new OpenAIPromptExecutionSettings()
    { 
        MaxTokens = 400 
    }));

Console.WriteLine($"{chatHistory.Last().Role} >>> {chatHistory.Last().Content}");

Farklı sorular ve bağlam sağlamak için sistemi veya kullanıcı istemlerini özelleştirin:

  • Yağmur yağarken kaç kez yürüyüş yaptım?
  • 2021'de kaç kez yürüyüş yaptım?

Model, girişlerinize göre her istem için uygun bir yanıt oluşturur.

Kaynakları temizleme

Örnek uygulamaya veya kaynaklara artık ihtiyacınız kalmadığında, ilgili dağıtımı ve tüm kaynakları kaldırın.

azd down

Sorun giderme

Windows'ta, çalıştırdıktan azd upsonra aşağıdaki hata iletilerini alabilirsiniz:

postprovision.ps1 dijital olarak imzalanmamıştır. Betik sistemde yürütülmeyecek

Postprovision.ps1 betiği, uygulamada kullanılan .NET kullanıcı gizli dizilerini ayarlamak için yürütülür. Bu hatayı önlemek için aşağıdaki PowerShell komutunu çalıştırın:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Ardından komutunu yeniden çalıştırın azd up .

Başka bir olası hata:

'pwsh' bir iç veya dış komut, çalıştırılabilir program veya toplu iş dosyası olarak tanınmaz. UYARI: 'postprovision' kancası çıkış koduyla başarısız oldu: '1', Yol: '.\infra\post-script\postprovision.ps1'. : çıkış kodu: 1 ContinueOnError true olarak ayarlandığından yürütme devam edecek.

Postprovision.ps1 betiği, uygulamada kullanılan .NET kullanıcı gizli dizilerini ayarlamak için yürütülür. Bu hatayı önlemek için aşağıdaki PowerShell komutunu kullanarak betiği el ile çalıştırın:

.\infra\post-script\postprovision.ps1

.NET AI uygulamalarında artık kullanıcı gizli dizileri yapılandırılmıştır ve bunlar test edilebilir.

Sonraki adımlar