Проект: AI компонент и интерфейс

Базата от миналия час работи. Днес потребителят въвежда нещо, то минава през модела, отговорът се проверява, записва се в базата и се показва. Грешките не свалят приложението. Това е критерият „AI компонент“ — 25% — и половината от „Интерфейс и тестване“.

Веригата вече сте я строили на части: извикване (урок 19), JSON по схема (урок 20), „разговор с базата“ (урок 23), RAG (урок 26). Днес я сглобявате в една функция, чието име е без значение, а договорът — не: приема входа на потребителя и връща резултат или текст на грешка, но никога не гърми.

Ключът от Google AI Studio е парола. В Colab живее в „Secrets“ (ключето вляво) и се чете с userdata.get("GEMINI_API_KEY"); в C# — в променлива на средата, четена с Environment.GetEnvironmentVariable. Никога в клетка, в низ, в App.config, в екранна снимка.

using System.Net.Http.Json;
using System.Text.Json;

static readonly HttpClient http = new() { Timeout = TimeSpan.FromSeconds(30) };
const string Adres =
    "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent";

static async Task<string> PitayAsync(string sistemno, string vhod)
{
    string klyuch = Environment.GetEnvironmentVariable("GEMINI_API_KEY")
        ?? throw new InvalidOperationException("Липсва GEMINI_API_KEY");

    var zaqvka = new
    {
        system_instruction = new { parts = new[] { new { text = sistemno } } },
        contents = new[] { new { role = "user", parts = new[] { new { text = vhod } } } },
        generationConfig = new { temperature = 0 }
    };

    using var req = new HttpRequestMessage(HttpMethod.Post, Adres);
    req.Headers.Add("x-goog-api-key", klyuch);
    req.Content = JsonContent.Create(zaqvka);

    using var otg = await http.SendAsync(req);
    otg.EnsureSuccessStatusCode();

    using var dok = JsonDocument.Parse(await otg.Content.ReadAsStringAsync());
    return dok.RootElement.GetProperty("candidates")[0]
              .GetProperty("content").GetProperty("parts")[0]
              .GetProperty("text").GetString() ?? "";
}

На защитата ще се случи поне едно от следните. Приложението трябва да го преживее с разбираемо съобщение, а не с червен текст на изключение.

import time

def pitay_sigurno(vhod, opiti=3):
    """Връща (текст, None) при успех или (None, съобщение) при неуспех."""
    for i in range(opiti):
        try:
            return pitay(vhod), None
        except Exception as e:
            print(f"опит {i + 1}: {type(e).__name__}")
            time.sleep(2 ** i)
    return None, "Услугата не отговори. Опитайте отново след малко."

Не губете часа в оформление. Интерфейсът е ползваем, когато човек, който не е писал кода, може да въведе вход и да разбере резултата. Изберете най-простия вариант, който екипът владее:

• Цикъл с input() в Colab — въпрос, отговор, следващ въпрос; празен ред за изход. Готов за пет минути.
• Форма в Colab — поле с #@param и бутон „Run“. Изглежда като приложение, без ред код повече.
• Конзолно приложение на C# — същият цикъл с Console.ReadLine; ако ползвате Windows Forms от модул 4 — бутонът се изключва, докато чака (иначе двойни заявки).
• Прост уеб формуляр — само ако някой в екипа вече го умее. Не е плюс в оценката.

Подгответе точно пет входа за защитата и ги запишете с очаквания резултат:

1. лесен — показва, че работи
2. с други думи или синоним — показва, че моделът не търси по букви
3. без отговор в базата или в документа — показва честното „не знам“
4. граничен — празен вход, дълъг вход, число извън обхвата
5. труден, който се проваля — показва, че познавате границите

• AI функцията е една функция: вход → промпт → извикване → проверка → изход; връща резултат или грешка, никога не гърми.
• Проверката преди изхода е задължителна — моделът дава правдоподобен, не верен отговор.
• Ключът е в userdata на Colab или в променлива на средата; търсене по „AIza“ преди всяко споделяне.
• Шестте типични счупвания имат разбираемо съобщение и се записват в служебната таблица.
• Най-простият ползваем интерфейс с четирите функционални изисквания; оформлението не носи точки.
• Пет входа за защитата, единият нарочно се проваля; екранни снимки за резерва.