Dela via


Chatta med en lokal AI-modell med hjälp av .NET

I den här snabbstarten lär du dig hur du skapar en konversationsbaserad .NET-konsolchattapp med hjälp av en OpenAI- eller Azure OpenAI-modell. Appen använder Microsoft.Extensions.AI biblioteket så att du kan skriva kod med ai-abstraktioner i stället för ett specifikt SDK. MED AI-abstraktioner kan du ändra den underliggande AI-modellen med minimala kodändringar.

Förutsättningar

Kör den lokala AI-modellen

Utför följande steg för att konfigurera och köra en lokal AI-modell på enheten. Många olika AI-modeller är tillgängliga för att köras lokalt och tränas för olika uppgifter, till exempel att generera kod, analysera bilder, generativ chatt eller skapa inbäddningar. I den här snabbstarten använder du modellen för generell användning phi3:mini , som är en liten men kapabel generativ AI som skapats av Microsoft.

  1. Öppna ett terminalfönster och kontrollera att Ollama är tillgängligt på enheten:

    ollama
    

    Om Ollama är tillgängligt visas en lista över tillgängliga kommandon.

  2. Starta Ollama:

    ollama serve
    

    Om Ollama körs visas en lista över tillgängliga kommandon.

  3. phi3:mini Hämta modellen från Ollama-registret och vänta tills den har laddats ned:

    ollama pull phi3:mini
    
  4. När nedladdningen är klar kör du modellen:

    ollama run phi3:mini
    

    Ollama startar phi3:mini modellen och uppmanar dig att interagera med den.

Skapa .NET-appen

Slutför följande steg för att skapa en .NET-konsolapp som ansluter till din lokala phi3:mini AI-modell:

  1. I ett terminalfönster navigerar du till en tom katalog på enheten och skapar en ny app med dotnet new kommandot :

    dotnet new console -o LocalAI
    
  2. Lägg till paketen Microsoft.Extensions.AI.Ollama i din app:

    dotnet add package Microsoft.Extensions.AI.Ollama --prerelease
    
  3. Öppna den nya appen i valfri redigerare, till exempel Visual Studio Code.

    code .
    

Ansluta till och chatta med AI-modellen

Semantic Kernel SDK tillhandahåller många tjänster och funktioner för att ansluta till AI-modeller och hantera interaktioner. I stegen framåt skapar du en enkel app som ansluter till den lokala AI:n och lagrar konversationshistorik för att förbättra chattupplevelsen.

  1. Öppna filen Program.cs och ersätt innehållet i filen med följande kod:

    using Microsoft.Extensions.AI;
    
    IChatClient chatClient = 
        new OllamaChatClient(new Uri("http://localhost:11434/"), "phi3:mini");
    
    // Start the conversation with context for the AI model
    List<ChatMessage> chatHistory = new();
    
    while (true)
    {
        // Get user prompt and add to chat history
        Console.WriteLine("Your prompt:");
        var userPrompt = Console.ReadLine();
        chatHistory.Add(new ChatMessage(ChatRole.User, userPrompt));
    
        // Stream the AI response and add to chat history
        Console.WriteLine("AI Response:");
        var response = "";
        await foreach (var item in
            chatClient.CompleteStreamingAsync(chatHistory))
        {
            Console.Write(item.Text);
            response += item.Text;
        }
        chatHistory.Add(new ChatMessage(ChatRole.Assistant, response));
        Console.WriteLine();
    }
    

    Föregående kod åstadkommer följande:

    • Skapar en OllamaChatClient som implementerar IChatClient-gränssnittet.
      • Det här gränssnittet ger en löst kopplad abstraktion som du kan använda för att chatta med AI-modeller.
      • Du kan senare ändra implementeringen av den underliggande chattklienten till en annan modell, till exempel Azure OpenAI, utan att ändra någon annan kod.
    • Skapar ett ChatHistory objekt för att lagra meddelandena mellan användaren och AI-modellen.
    • Hämtar en uppmaning från användaren och lagrar den i ChatHistory.
    • Skickar chattdata till AI-modellen för att generera ett svar.

    Kommentar

    Ollama körs på port 11434 som standard, varför AI-modellslutpunkten är inställd http://localhost:11434på .

  2. Kör appen och ange en uppmaning i konsolen för att ta emot ett svar från AI:n, till exempel följande:

    Your prompt:
    Tell me three facts about .NET.
    
    AI response:
    1. **Cross-Platform Development:** One of the significant strengths of .NET,
    particularly its newer iterations (.NET Core and .NET 5+), is cross-platform support.
    It allows developers to build applications that run on Windows, Linux, macOS,
    and various other operating systems seamlessly, enhancing flexibility and
    reducing barriers for a wider range of users.
    
    2. **Rich Ecosystem and Library Support:** .NET has a rich ecosystem,
    comprising an extensive collection of libraries (such as those provided by the
    official NuGet Package Manager), tools, and services. This allows developers
    to work on web applications (.NET for desktop apps and ASP.NET Core
    for modern web applications), mobile applications (.NET MAUI),
    IoT solutions, AI/ML projects, and much more with a vast array of prebuilt
    components available at their disposal.
    
    3. **Type Safety:** .NET operates under the Common Language Infrastructure (CLI)
    model and employs managed code for executing applications. This approach inherently
    offers strong type safety checks which help in preventing many runtime errors that
    are common in languages like C/C++. It also enables features such as garbage collection,
    thus relieving developers from manual memory management. These characteristics enhance
    the reliability of .NET-developed software and improve productivity by catching
    issues early during development.
    
  3. Svaret från AI:n är korrekt, men också utförligt. Med den lagrade chatthistoriken kan AI:n ändra sitt svar. Instruera AI:n att förkorta listan som den angav:

    Your prompt:
    Shorten the length of each item in the previous response.
    
    AI Response:
     **Cross-platform Capabilities:** .NET allows building for various operating systems
    through platforms like .NET Core, promoting accessibility (Windows, Linux, macOS).
    
    **Extensive Ecosystem:** Offers a vast library selection via NuGet and tools for web
    (.NET Framework), mobile development (.NET MAUI), IoT, AI, providing rich
    capabilities to developers.
    
    **Type Safety & Reliability:** .NET's CLI model enforces strong typing and automatic
    garbage collection, mitigating runtime errors, thus enhancing application stability.
    

    Det uppdaterade svaret från AI:n är mycket kortare andra gången. På grund av den tillgängliga chatthistoriken kunde AI:n utvärdera det tidigare resultatet och ge kortare sammanfattningar.

Nästa steg