ChatWithAI_Server/Services/ILmStudioService.cs - master - ilyakos/ChatWithAI

ChatWithAI_Server/Services/ILmStudioService.cs

32 строки2 KB

ilyakos

новые энд поинты

15 июн 2026, 20:32

15 июн 2026, 20:3215ab71c

using ChatWithAI.Database.Models;

namespace ChatWithAI_Server.Services;

/// <summary>
/// Сервис для взаимодействия с языковой моделью через OpenAI-совместимый API LM Studio.
/// </summary>
public interface ILmStudioService
{
    /// <summary>
    /// Отправляет сообщение пользователя в LM Studio вместе с историей диалога и системным промтом.
    /// Возвращает текст ответа языковой модели.
    /// </summary>
    /// <param name="systemPrompt">Системная инструкция для модели (текст промта чата).</param>
    /// <param name="history">
    /// История предыдущих сообщений чата в хронологическом порядке.
    /// Не включает текущее сообщение пользователя.
    /// </param>
    /// <param name="userText">Текст нового сообщения пользователя.</param>
    /// <param name="userImageBase64">
    /// Изображение в формате Base64, приложенное к сообщению.
    /// <c>null</c> — если изображение не приложено.
    /// </param>
    /// <returns>Текст ответа языковой модели.</returns>
    /// <exception cref="HttpRequestException">LM Studio недоступен или вернул ошибку HTTP.</exception>
    /// <exception cref="InvalidOperationException">Ответ LM Studio имеет неожиданный формат.</exception>
    Task<string> CompleteChatAsync(
        string systemPrompt,
        IEnumerable<Message> history,
        string userText,
        string? userImageBase64 = null);
}