======
Gemini
======

Aceasta sectiune este dedicata mecanismului de conectare la produsul de inteligenta artificiala **Gemini AI / Vertex AI** (Google), prin intermediul **API-ului Gemini**.

Configurarile definite aici permit aplicatiei EMSYS sa comunice cu serviciile Gemini AI / Vertex AI in vederea utilizarii functionalitatilor de inteligenta artificiala integrate in sistem.

.. note::
   Disponibil incepand cu versiunea **ERP 8.1.0**.

.. note::
   Aceasta pagina este dedicata **administratorilor de sistem** si persoanelor care cunosc mecanismele si uneltele de configurare **Google Gemini** si **Vertex AI**.

Salvare configurari
===================

Permite incarcarea sau restaurarea fisierului de configurare aferent conexiunii Gemini.

Pentru a salva configurarea, parcurgeti urmatorii pasi:

     **1.** In panoul **Functii** din stanga, selectati **Gemini**;

     **2.** Din lista derulanta afisata in dreapta, alegeti optiunea **Salvare configurari**;

     **3.** La campul **Fisier setari**, apasati **Choose File** si selectati fisierul de configurare de pe disc;

.. note::
   Fisierul de configurare trebuie sa fie in format **ZIP**. In caz contrar, operatiunea va fi respinsa cu eroare.

   Arhiva ZIP trebuie sa contina urmatoarele fisiere la radacina:

   **key.json** *(obligatoriu)*
      Fisierul de credentiale Google de tip `Service Account Key <https://cloud.google.com/iam/docs/keys-create-delete>`_, descarcabil din Google Cloud Console.
      Este utilizat pentru autentificarea OAuth2 cu scopurile:

      - ``https://www.googleapis.com/auth/generative-language``
      - ``https://www.googleapis.com/auth/cloud-platform``

   **configuration.properties** *(obligatoriu)*
      Fisier de configurare Java ``.properties``.

**4.** Apasati butonul **Executa** pentru a aplica configurarea.

Parametri de configurare
========================

Parametrii de mai jos pot fi specificati in doua moduri echivalente:

- in fisierul ``configuration.properties`` din arhiva ZIP incarcata prin consola;
- ca **variabile de mediu** la configurarea containerului aplicatiei (ex: Docker), fara a fi necesara incarcarea unui fisier ZIP.

.. list-table::
   :widths: 28 10 12 50
   :header-rows: 1

   * - Parametru
     - Obligatoriu
     - Implicit
     - Descriere
   * - ``PROJECT_ID``
     - Da
     -
     - ID-ul proiectului Google Cloud (ex: ``745974909199``)
   * - ``LOCATION``
     - Da
     -
     - Region-ul Vertex AI (ex: ``europe-central2`` pentru Warsaw)
   * - ``TIMEOUT_MINUTES``
     - Nu
     - ``15``
     - Timeout per apel API, in minute
   * - ``MAX_CONNECTIONS``
     - Nu
     - ``50``
     - Numarul maxim de conexiuni HTTP catre Vertex AI
   * - ``HTTP_PROXY``
     - Nu
     -
     - Proxy HTTP in formatul ``http://host:port``
   * - ``GEMINI_TIMEOUT_MINUTES``
     - Nu
     - ``15``
     - Timeout implicit la nivel de aplicatie, in minute (suprascris de ``TIMEOUT_MINUTES`` daca este prezent)
   * - ``GEMINI_CACHE_SECONDS``
     - Nu
     - ``3600``
     - Durata de cache a raspunsurilor Gemini, in secunde

Testare configuratie
====================

Permite verificarea functionalitatii conexiunii Gemini prin trimiterea unei interogari de test si validarea raspunsului asteptat.

Pentru a testa configurarea, parcurgeti urmatorii pasi:

     **1.** In panoul **Functii** din stanga, selectati **Gemini**;

     **2.** Din lista derulanta, alegeti optiunea **Testare configurari**;

     **3.** Apasati butonul **Executa**.

In cazul in care configurarea este corecta si conexiunea la Gemini AI / Vertex AI functioneaza, se va afisa mesajul:

.. note::
   *Testul a fost efectuat cu succes*

In cazul in care nu exista o configurare Gemini salvata in sistem, operatiunea va fi respinsa cu eroarea:

.. warning::
   *Nu exista salvate configurarile pentru Gemini*

Stergere configurari curente
============================

Apel pentru stergerea configurarilor curente din sistemul Gemini.

Dupa executie, conexiunea Gemini AI / Vertex AI nu va mai fi disponibila pana la incarcarea unei noi configurari prin optiunea **Salvare configurari**.

Pentru a sterge configurarea curenta, parcurgeti urmatorii pasi:

     **1.** In panoul **Functii** din stanga, selectati **Gemini**;

     **2.** Din lista derulanta, alegeti optiunea **Stergere configurari curente**;

     **3.** Apasati butonul **Executa**.

In cazul in care nu exista o configurare Gemini salvata in sistem, operatiunea va fi respinsa cu eroarea:

.. warning::
   *Nu exista salvate configurarile pentru Gemini*

Reincarcare configurari
=======================

Permite fortarea reincarcarii configurarii Gemini pe toate nodurile din cluster, prin invalidarea cache-ului existent.

Se utilizeaza dupa modificarea configurarii, pentru a se asigura ca toate nodurile aplicatiei preiau imediat configurarea actualizata din baza de date, fara a fi necesara repornirea serviciului.

Pentru a reincarca configurarea, parcurgeti urmatorii pasi:

     **1.** In panoul **Functii** din stanga, selectati **Gemini**;

     **2.** Din lista derulanta, alegeti optiunea **Actiune reincarcare configurari**;

     **3.** Apasati butonul **Executa**.

In cazul in care configurarea este corecta, se va afisa mesajul de succes. In cazul in care nu exista o configurare Gemini salvata in sistem, operatiunea va fi respinsa cu eroarea:

.. warning::
   *Nu exista salvate configurarile pentru Gemini*