AI agent

Anthropic

Integrace Anthropic připojí k RichPear Home modely Claude. Můžete je použít jako konverzačního agenta pro dotazy a ovládání povolených entit nebo jako službu pro AI úlohy v automatizacích.

Doména
anthropic
Typ
AI, hlas
Komunikace
Cloudová služba
Vyžaduje
vlastní Anthropic API klíč
01

Co připravit

Připravte účet v Anthropic Console, zapnutou fakturaci nebo předplacené kredity a nový API klíč určený jen pro RichPear Home. API provoz je placený podle používání, proto před nasazením nastavte v účtu rozumné limity a průběžně sledujte spotřebu.

Pro běžné veřejné použití není k dispozici univerzální demo klíč. Nepoužívejte klíče z internetu, sdílené účty ani přístupové údaje jiné osoby.

02

API klíč

V Anthropic Console vytvořte API klíč v části pro správu klíčů. Klíč si zkopírujte hned při vytvoření, uložte ho do správce hesel a vložte ho pouze do průvodce integrací v RichPear Home.

Pokud se klíč dostane mimo správce hesel nebo mimo RichPear Home, v konzoli ho zneplatněte a vytvořte nový. Po změně klíče znovu otevřete nastavení integrace a zadejte aktuální hodnotu.

03

Přidání integrace

Otevřete RichPear Home na http://rphome.local:8123. Pokud tato adresa ve vaší síti neodpoví, použijte http://IP-ADRESA:8123.

Jděte do Nastavení → Zařízení a služby → Přidat integraci, vyhledejte Anthropic a vložte API klíč. RichPear Home při uložení zkontroluje připojení ke službě Anthropic a po úspěšném přidání vytvoří výchozí konverzačního agenta a výchozí AI úlohu.

Integraci Anthropic najdete v dialogu Přidat integraci.
Formulář vyžaduje vlastní API klíč z účtu Anthropic.
04

Možnosti modelu

V možnostech integrace můžete ponechat doporučené nastavení, nebo ručně zvolit model, maximální počet tokenů odpovědi a strategii ukládání promptu do cache. Dostupné modely a maximální hodnoty se řídí vaším účtem Anthropic a schopnostmi konkrétního modelu.

Pokročilé volby se zobrazují podle vybraného modelu. Patří mezi ně thinking budget nebo thinking effort, spuštění kódu v sandboxu, webové vyhledávání, maximální počet webových vyhledání, použití polohy domácnosti pro lokalizaci výsledků a dynamické vyhledávání nástrojů. Každá z těchto voleb může změnit cenu, rychlost i chování odpovědí.

Nižší limit tokenů drží cenu pod kontrolou, ale příliš nízká hodnota může utnout odpověď uprostřed věty nebo zabránit dokončení požadované akce.

05

Oprávnění k entitám

Claude může číst informace a ovládat pouze entity, které mu v RichPear Home vystavíte. Začněte malým rozsahem: například senzory, jednu místnost a jednu bezpečnou lampu. Až poté přidávejte další zařízení.

Citlivé entity jako zámky, brány, alarmy, topení nebo kritické vypínače nevystavujte bez jasných pravidel, dohledatelné historie a možnosti ručního zásahu. Pojmenování entit a jejich aliasy udržujte stručné a jednoznačné, aby agent nepracoval s podobně pojmenovanými zařízeními.

06

Použití

Konverzační agent se hodí pro chat, hlasového asistenta a přirozené dotazy typu „jaká je teplota v obýváku“ nebo „zhasni v kuchyni“. Pokud má agent povolené ovládání domácnosti, použije jen vystavené entity.

Entita typu ai_task slouží pro automatizace, skripty a funkce rozhraní, které potřebují vygenerovat text nebo strukturovaná data. V automatizacích můžete pracovat s akcemi conversation.process a ai_task.generate_data.

Do instrukcí agenta napište jazyk odpovědí, tón, pravidla pro nejisté situace a hranice ovládání domácnosti. Pro každodenní provoz bývá vhodná krátká odpověď s potvrzením provedené akce.

07

Řešení potíží

Integrace nejde přidat: zkontrolujte, že je API klíč aktuální, účet Anthropic má aktivní kredity nebo fakturaci a RichPear Home má přístup k internetu. V části Nastavení → Systém → Logy hledejte chyby podle domény anthropic.

Odpověď končí uprostřed věty: zvyšte maximální počet tokenů odpovědi, případně zkraťte instrukce nebo vstupní text. Krátký limit šetří náklady, ale u složitějších dotazů nemusí stačit.

Agent tvrdí, že něco provedl, ale zařízení se nezměnilo: zkontrolujte, jestli má povolené ovládání domácnosti, jestli je daná entita vystavená agentovi a jestli její název odpovídá tomu, co uživatel říká nebo píše.

Po aktualizaci se objevují chyby klienta Anthropic: znovu načtěte integraci a zkontrolujte logy. Pokud chyba souvisí s knihovnou Anthropic v systému, obvykle pomůže dokončená aktualizace systému nebo návrat na předchozí funkční verzi a následná nová aktualizace.

08

Známá omezení

Integrace nepoužívá spouštěče vět. Některé funkce Anthropic API, například dávkové zpracování, citace v rozhraní, data residency, počítačové ovládání, paměť nebo beta funkce, nejsou pro tento způsob provozu dostupné.

Nové modely se mohou objevit dřív, než jsou všechny jejich nové schopnosti dostupné v RichPear Home. Pokud po změně modelu narazíte na chybu, vraťte se na předchozí funkční model nebo zapněte doporučené nastavení.

AI odpovědi nenahrazují bezpečnostní logiku domácnosti. Kritické scénáře řešte běžnými automatizacemi a fyzickými pojistkami; Claude používejte jako rozhraní, pomocníka nebo zdroj textového zpracování.

09

Odebrání

Integraci odeberete v Nastavení → Zařízení a služby otevřením karty Anthropic a smazáním konkrétní položky. Po odebrání zvažte i zneplatnění API klíče v Anthropic Console, pokud už ho RichPear Home nemá používat.