RichPearHOME DOCSZačít
02

Najděte akce ve Vývojářských nástrojích

Otevřete Nastavení → Vývojářské nástroje → Akce. V českém UI jsou dostupné akce Vygenerovat data (ai_task.generate_data) a Vygenerovat obrázek (ai_task.generate_image).

Pokud nezadáte entity_id, RichPear Home použije preferovanou AI Task entitu pro daný typ úlohy. Když preferovaná entita nastavená není, akce nemá nad čím běžet.

AI Task akce jsou dostupné v českých Vývojářských nástrojích.
03

Generování dat

Akce ai_task.generate_data používá AI k vytvoření textu nebo strukturovaných dat. Povinné jsou task_name a instructions. Volitelně přidejte entity_id, structure a attachments.

Odpověď obsahuje data a conversation_id. Pokud zadáte structure, data má odpovídat zadaným polím se selektory, popisem a volitelnou povinností pole.

Formulář akce ai_task.generate_data v režimu uživatelského rozhraní.
04

Generování obrázků

Akce ai_task.generate_image používá task_name, instructions, volitelné entity_id a volitelné attachments. Odpověď může obsahovat media_source_id, url, revised_prompt, model, mime_type, width, height a conversation_id.

Vygenerovaný obrázek se ukládá do prvního dostupného adresáře médií a dá se procházet přes Media Source. Dočasná URL v odpovědi je bez hostitele a platí jednu hodinu.

Názvy souborů

RichPear Home používá formát podle data, času a očištěného názvu úkolu, například 2025-01-19_123456_home-security-camera.png.

05

Přílohy a kamery

Přílohy se předávají jako výstup Media Selector. Zdroj integrace má speciální zpracování pro camera a image media source, kde si RichPear Home vytvoří dočasný snapshot entity. U ostatních příloh aktuální implementace očekává lokální soubor v media source.

06

Použití v automatizaci nebo skriptu

V automatizaci uložte výsledek do response_variable a teprve potom použijte jeho obsah. U textových odpovědí pracujte s result.data; u obrázků typicky s generated_image.url nebo generated_image.media_source_id. 

action: ai_task.generate_data
data:
  task_name: "shrnutí domu"
  instructions: "Shrň aktuální stav domu podle dostupných senzorů."
response_variable: result

Bezpečný vzor

AI výstup berte jako návrh. Pro odemykání, alarm, topení nebo platby vždy přidejte běžné podmínky a ručně ověřitelné limity.

Řešení problémů

Když AI úloha nevrací výsledek

Akce nemá vybranou entitu

Zadejte konkrétní entity_id AI Task entity nebo nastavte preferovanou entitu pro daný typ úlohy. Bez entity akce skončí chybou.

Model nepodporuje požadovaný typ úlohy

Entita musí podporovat generování dat nebo obrázků podle použité akce. Pokud přidáváte přílohy, musí entita podporovat i přílohy.

Obrázek se nevygeneruje nebo nejde otevřít

Ověřte, že je nastavený alespoň jeden adresář médií. AI Task media source ukládá obrázky do prvního dostupného media adresáře a URL odpovědi je podepsaná jen na jednu hodinu.