# Rocketoo AI

{% hint style="warning" %}
Pouze pro klienty **Rocketoo MAX**.
{% endhint %}

Modul Rocketoo AI vám umožňuje využívat umělou inteligenci přímo v administraci e-shopu pro:

* Generování popisů produktů
* Zkracování textů
* Opravy pravopisu
* Překlady do cizích jazyků
* Rozšiřování názvů o parametry produktu

## Kde najdu AI funkce

{% hint style="info" %}
Modul je nutné nejprve nainstalovat ve **Správci rozšíření**. 
{% endhint %}

AI funkce najdete přímo u formulářových polí při editaci produktu. U polí **Název**, **Krátký popis** a **Dlouhý popis** se zobrazí tlačítko **AI** s nabídkou dostupných akcí.

### Požadavky

Pro fungování modulu potřebujete:

* Účet na [OpenAI](https://platform.openai.com/)
* API klíč z OpenAI
* Kredit na OpenAI účtu

### Registrace účtu OpenAI

Pro přístup k OpenAI API je nejprve nutné vytvořit si účet:

{% stepper %}
{% step %}
Otevřete stránku [https://platform.openai.com/signup](https://platform.openai.com/signup?utm_source=chatgpt.com)
{% endstep %}

{% step %}
Vyberte způsob registrace – buď přes e-mail, nebo pomocí účtu Google, Microsoft či Apple.
{% endstep %}

{% step %}
Po registraci ověřte svou e-mailovou adresu kliknutím na odkaz, který dorazí do schránky.
{% endstep %}

{% step %}
Přihlaste se do účtu na <https://platform.openai.com>
{% endstep %}
{% endstepper %}

### Nastavení platebních údajů

Pro používání API je třeba mít aktivovaný účet s platební metodou:

{% stepper %}
{% step %}
V administraci přejděte do sekce **Billing**.
{% endstep %}

{% step %}
Zadejte údaje o platební kartě nebo jiném způsobu platby.
{% endstep %}

{% step %}
Po aktivaci účtu získáte přístup ke správě API klíčů.
{% endstep %}
{% endstepper %}

### Vytvoření API klíče

Po aktivaci účtu je možné vygenerovat vlastní API klíč:

{% stepper %}
{% step %}
V levém menu klikněte na **API Keys**.
{% endstep %}

{% step %}
Zvolte možnost **Create new secret key**.
{% endstep %}

{% step %}
Zadejte název klíče (pro vlastní orientaci) a potvrďte vytvoření.
{% endstep %}

{% step %}
Zobrazí se vygenerovaný API klíč – **okamžitě si jej zkopírujte a bezpečně uložte**, protože po zavření okna již nebude možné jej znovu zobrazit.
{% endstep %}

{% step %}
Vytvořený klíč zkopírujte do nastavení Rocketoo AI ve vašem e-shopu Rocketoo.
{% endstep %}
{% endstepper %}

### Dobití kreditu

{% stepper %}
{% step %}
Přejděte na <https://platform.openai.com/account/billing>
{% endstep %}

{% step %}
Dobijte kredit (doporučujeme začít s $5-10).
{% endstep %}
{% endstepper %}

## Nastavení modulu

V hlavním menu klikněte na **Nastavení**. V sekci **Rozšíření** vyberte **Rocketoo AI**.

### Nastavení persony

Persona je základní popis, který ovlivňuje styl komunikace AI. Například:

```
Jsem copywriter pro e-shop s nábytkem. Píšu profesionálně, ale přátelsky. 
Zákazníkům vykám. Zaměřuji se na praktické vlastnosti a kvalitu produktů.
```

#### Tipy pro personu:

* Popište charakter vašeho e-shopu
* Určete, zda zákazníkům tykáte nebo vykáte
* Zmiňte, na co se zaměřujete (kvalita, cena, design...)

### Výběr AI modelu

| Model                | Popis                   | Doporučení                  |
| -------------------- | ----------------------- | --------------------------- |
| **GPT-4o Mini**      | Rychlý a levný          | Pro běžné použití           |
| **GPT-4o**           | Kvalitnější výstupy     | Pro náročnější texty        |
| **GPT-4.5 Preview**  | Nejnovější funkce       | Pro testování novinek       |
| **GPT-5.2**          | Nová generace           | Pro nejlepší kvalitu        |
| **GPT-5.2 Thinking** | S pokročilým uvažováním | Pro složité úlohy           |
| **GPT-5.2 Pro**      | Nejvyšší přesnost       | Pro kritické texty (dražší) |

{% hint style="info" %}
**Doporučení:** Začněte s **GPT-4o Mini** - je nejlevnější a pro většinu úloh dostačující.
{% endhint %}

### Nastavení max tokenů

Tokeny určují maximální délku odpovědi AI:

* **1000 tokenů** ≈ krátký text (1-2 odstavce)
* **2000 tokenů** ≈ střední text (doporučeno)
* **4000 tokenů** ≈ dlouhý text

### Nastavení temperature

Temperature ovlivňuje kreativitu AI:

* **0.3** - konzervativní, předvídatelné odpovědi
* **0.7** - vyvážené (doporučeno)
* **1.2** - kreativnější, méně předvídatelné

### Jazyky pro překlad

Zde si můžete nastavit jazyky, které budete chtít v e-shopu používat pro překlady.

Například: pokud máte do slovenského e-shopu naimportované české texty, stačí přidat slovenštinu. U nově doplněných textů u produktů pak můžete využít automatický překlad do slovenštiny.

{% stepper %}
{% step %}
Klikněte na **Přidat jazyk**.
{% endstep %}

{% step %}
Vyberte jazyk z nabídky.
{% endstep %}

{% step %}
Zadejte název jazyka (zobrazí se v menu).
{% endstep %}
{% endstepper %}

## Práce s AI u produktů

### Kde najdu AI tlačítko?

Při editaci produktu uvidíte u některých polí tlačítko **AI**. Kliknutím se rozbalí nabídka dostupných akcí.

#### Dostupné akce pro název produktu

| Akce         | Co dělá                     | Příklad                                                                   |
| ------------ | --------------------------- | ------------------------------------------------------------------------- |
| **Zkrátit**  | Zkrátí dlouhý název         | "Dětská patrová postel Monika s úložným prostorem" → "Patrová postel Leo" |
| **Rozšířit** | Přidá parametry k názvu     | "Postel Monika" → "Postel Monika 90x200 cm, bílá, masiv"                  |
| **Přeložit** | Přeloží do zvoleného jazyka | "Dětská postel" → "Children's bed"                                        |

#### Dostupné akce pro krátký popis

| Akce                      | Co dělá                         |
| ------------------------- | ------------------------------- |
| **Zkrátit**               | Zkrátí text na 2-3 věty         |
| **Vytvořit krátký popis** | Vytvoří perex z dlouhého popisu |
| **Přeložit**              | Přeloží do zvoleného jazyka     |

#### Dostupné akce pro dlouhý popis

| Akce                        | Co dělá                                           |
| --------------------------- | ------------------------------------------------- |
| **Opravit pravopis**        | Opraví gramatické a pravopisné chyby              |
| **Zkrátit**                 | Zkrátí text, zachová důležité informace           |
| **Vytvořit popis produktu** | Vygeneruje kompletní popis z názvu a parametrů    |
| **Přeložit**                | Přeloží do zvoleného jazyka (zachová formátování) |

## Úprava promptů

Klikněte na **ikonu ozubeného kolečka** ⚙️ vedle akce. Upravte text promptu podle potřeby. Klikněte **Uložit**.

Pro obnovení výchozího promptu klikněte na **Obnovit výchozí**.

## Generování popisu produktu

Akce **Vytvořit popis produktu** vytvoří strukturovaný popis:

{% stepper %}
{% step %}

### Úvodní odstavec

Představení produktu.
{% endstep %}

{% step %}

### Hlavní vlastnosti

Klíčové parametry a benefity.
{% endstep %}

{% step %}

### Pro koho je vhodný

Cílová skupina.
{% endstep %}

{% step %}

### Závěr

Shrnutí a výzva k akci.
{% endstep %}
{% endstepper %}

AI automaticky použije parametry produktu (rozměry, barva, materiál...) pro vytvoření realistického popisu.

## Orientační ceník

### Jak se počítá cena?

OpenAI účtuje podle počtu **tokenů**:

* 1 token ≈ 3-4 znaky textu
* Platíte za vstupní text (váš dotaz) i výstupní text (odpověď AI)

#### Příklady cen (GPT-4o Mini)

| Operace      | Cena za 1 položku | Cena za 100 položek |
| ------------ | ----------------- | ------------------- |
| Krátký popis | \~0,005 Kč        | \~0,50 Kč           |
| Dlouhý popis | \~0,015 Kč        | \~1,50 Kč           |
| Překlad      | \~0,010 Kč        | \~1,00 Kč           |

#### Srovnání modelů

| Model       | Relativní cena | Kvalita     |
| ----------- | -------------- | ----------- |
| GPT-4o Mini | $              | Dobrá       |
| GPT-4o      | $$$            | Velmi dobrá |
| GPT-5.2     | $$             | Výborná     |
| GPT-5.2 Pro | $$$$$$         | Nejlepší    |

{% hint style="info" %}
**Tip:** Pro běžné použití (popisy, překlady) je GPT-4o Mini plně dostačující a velmi levný.
{% endhint %}

#### Sledování spotřeby

Svou spotřebu můžete sledovat na <https://platform.openai.com/usage>.

## Často kladené otázky

<details>

<summary>Nastavení</summary>

**Q: Je API klíč bezpečný?**\
A: Ano, klíč je uložen šifrovaně v databázi e-shopu a nikdy se nezobrazuje v čitelné podobě.

**Q: Co když mi dojde kredit?**\
A: AI funkce přestanou fungovat a zobrazí se chybová hláška. Stačí dobít kredit na OpenAI.

**Q: Mohu používat svůj existující OpenAI účet?**\
A: Ano, stačí vygenerovat nový API klíč pro e-shop.

</details>

<details>

<summary>Používání</summary>

**Q: Jak dlouho trvá vygenerování textu?**\
A: Obvykle 2-10 sekund, záleží na délce textu a vytíženosti OpenAI.

**Q: Mohu upravit vygenerovaný text?**\
A: Ano, vygenerovaný text se vloží do pole a můžete ho libovolně upravit před uložením.

**Q: Co když se mi výsledek nelíbí?**\
A: Můžete akci spustit znovu - AI pokaždé vygeneruje trochu jiný text. Nebo text ručně upravte.

**Q: Funguje AI i pro varianty produktů?**\
A: Ano, AI akce jsou dostupné i při editaci variant.

</details>

<details>

<summary>Překlady</summary>

**Q: Zachová překlad formátování?**\
A: Ano, u dlouhého popisu se zachovají všechny HTML tagy (odstavce, seznamy, nadpisy).

**Q: Do kolika jazyků mohu překládat?**\
A: Můžete přidat libovolný počet jazyků v nastavení modulu.

**Q: Je překlad kvalitní?**\
A: GPT modely poskytují velmi kvalitní překlady, ale doporučujeme kontrolu rodilým mluvčím pro důležité texty.

</details>

<details>

<summary>Problémy</summary>

**Q: Zobrazuje se chyba "API klíč není nastaven"**\
A: Přejděte do nastavení modulu a zadejte platný API klíč.

**Q: Zobrazuje se chyba "Nedostatečný kredit"**\
A: Dobijte kredit na <https://platform.openai.com/account/billing>.

**Q: AI tlačítko se nezobrazuje**\
A: Zkontrolujte, zda máte nastaven API klíč a zda máte oprávnění k používání AI funkcí.

**Q: Generování trvá příliš dlouho**\
A: Může být přetížení OpenAI serverů. Zkuste to za chvíli znovu nebo použijte rychlejší model (GPT-4o Mini).

</details>

## Tipy a triky

#### Pro nejlepší výsledky

* Vyplňte parametry produktu - AI je použije pro generování popisů
* Nastavte personu - texty budou konzistentní s vaším stylem
* Kontrolujte výstupy - AI může občas udělat chybu
* Experimentujte s temperature - najděte ideální míru kreativity

#### Úspora nákladů

* Používejte **GPT-4o Mini** pro běžné úlohy
* Generujte popisy **hromadně** - je to efektivnější
* **Upravujte** existující texty místo generování nových
* Sledujte **spotřebu** na OpenAI dashboardu

#### Workflow pro nové produkty

{% stepper %}
{% step %}

### Vyplňte základní údaje

Vyplňte název a parametry produktu.
{% endstep %}

{% step %}

### Vytvoření dlouhého popisu

Použijte **Vytvořit popis produktu** pro dlouhý popis.
{% endstep %}

{% step %}

### Vytvoření krátkého popisu

Použijte **Vytvořit krátký popis** z dlouhého popisu.
{% endstep %}

{% step %}

### Kontrola a uložení

Zkontrolujte výstupy a uložte produkt.
{% endstep %}
{% endstepper %}