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íč
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.
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.
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.
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.
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.
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.
Ř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.
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í.
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.