Integrace RichPear Home
AI Task
AI Task je systémová vrstva pro úlohy běžící nad vybranou AI entitou. Nepřipojuje samostatnou službu ani zařízení; funkce zpřístupní až jiná integrace, která umí generovat data, obrázky nebo pracovat s přílohami.
- Doména
ai_task- Přidání v UI
- Nepřidává se ručně
- Akce
generate_data,generate_image- Přílohy
- Podle schopností AI entity
Nepřidávejte AI Task jako běžnou integraci
V Nastavení → Zařízení a služby → Přidat integraci se AI Task po vyhledání nezobrazí jako samostatný průvodce. To je správně: nejdřív musí existovat konkrétní AI integrace, která vytvoří AI Task entitu.
Jakmile taková entita existuje, můžete ji vybrat přímo v akci přes
entity_id, případně nastavit jako preferovanou entitu pro
generování dat nebo obrázků.
Stav AI Task entity není výsledek posledního dotazu. Ukazuje čas, kdy byla daná entita naposledy použitá.
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 a skončí chybou.
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.
ai_task.generate_data v režimu uživatelského rozhraní.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.
Přílohy a kamery
Přílohy se předávají jako výstup Media Selector. Tato část má speciální
zpracování pro camera a image media source, kde si
RichPear Home vytvoří dočasný snímek entity. U ostatních příloh počítejte s
lokálním souborem dostupným přes Media Source.
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: resultBezpeč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.
Lokální adresa systému
RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.