# =============================================================
# GEMINI INTEGRĀCIJA — Uzstādīšanas Instrukcija
# =============================================================


## SOLIS 1 — Iegūsti Gemini API Atslēgu (BEZMAKSAS)

1. Atver: https://aistudio.google.com/app/apikey
2. Klikšķini "Create API Key"
3. Izvēlies projektu vai izveido jaunu
4. Kopē atslēgu (izskatās kā: AIzaSy...)


## SOLIS 2 — Pievieno .env failā

Atver cPanel File Manager → agent_backend/.env
Pievieno:

GEMINI_API_KEY=AIzaSy_tava_atslega_šeit


## SOLIS 3 — Aizstāj failus agent_backend/telegram_bot/

Aizstāj TIKAI šos 3 failus:
  handlers.py   ← galvenā loģika ar Gemini
  views.py      ← atjaunoti callback dati
  gemini_client.py  ← JAUNS fails (pievieno)

Pievieno JAUNU failu:
  knowledge_base/es_ai_akts.md  ← ES AI Akts


## SOLIS 4 — Pievieno 'requests' requirements.txt

Pārbaudi vai agent_backend/requirements.txt satur:
  requests>=2.31.0

Ja nav — pievieno un nospied "Run Pip Install" cPanel Python App.


## SOLIS 5 — Restartē Python App

cPanel → Python App → ⟳ Restart


## SOLIS 6 — Pārbaude

Telegram → /start → uzraksti jautājumu brīvā formā
Piem: "Kas ir LLM modelis un kā to izmantot biznesā?"

Vajadzētu saņemt detalizētu, gudru atbildi no Gemini!


## JAUNĀS KOMANDAS

/jauns      ← notīra sarunu vēsturi (jauna sesija)
/aiakts     ← ES AI Akts kopsavilkums
(+ visas vecās komandas)


## IZMAKSAS (Gemini 1.5 Pro)

Cenas uz 2024. gada oktobri:
- Input:  $3.50 / 1M tokeni (konteksts ar knowledge base ~2000 tokeni/ziņa)
- Output: $10.50 / 1M tokeni (~300 tokeni/atbilde)

Aptuvens izmaksu aprēķins:
- 100 ziņas/dienā ≈ ~$0.80/dienā ≈ ~$24/mēnesī
- 1000 ziņas/dienā ≈ ~$8/dienā ≈ ~$240/mēnesī

Ietaupīšanai var pārslēgties uz gemini-1.5-flash (10x lētāks):
→ Mainīt gemini_client.py: GEMINI_MODEL = "gemini-1.5-flash"


## PROBLĒMU NOVĒRŠANA

Ja Gemini neatbild:
1. Pārbaudi GEMINI_API_KEY .env failā
2. Pārbaudi passenger.log kļūdu ziņojumus
3. Pārbaudi vai requests ir instalēts

Ja 429 kļūda (rate limit):
→ Gemini bezmaksas plānam ir limits: 2 pieprasījumi/sekundē
→ Risinājums: uzgaidi vai jaunina uz maksas plānu

Ja atbilde ir angliski:
→ System prompt liek atbildēt latviski
→ Pārbaudi vai GEMINI_API_KEY ir derīgs
