# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://napoveda.rocketoo.cz/rocketoo/rozsireni/rocketoo-ai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.