Home Agent
aradlein
Openen in Home Assistant
Op Home Assistant 2026.11 of nieuwer? Openen in de Marketplace
- Installaties
- 172 die analysegegevens delen
- GitHub-sterren
- 48
- Verbinding
- Gebruikt de cloud van de aanbieder
- Onderhoud
- Bijgewerkt in de afgelopen 6 maanden
- Versie
- v0.9.5,
- Categorie
- AI en spraak, AI-modellen
- Soort
- Marketplace-integratie
- Vereist
- Vereist de Marketplace (HACS op 2026.10 en ouder)
- Domein
home_agent- Problemen
- Probleem melden
Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.
Over dit item
Home Agent is een conversatie-integratie die Home Assistant verbindt met taalmodellen die compatibel zijn met OpenAI. Het werkt met cloudservices of lokale servers zoals Ollama, LocalAI en LM Studio en wordt ingesteld in de UI. Entiteitscontext kan aan het model worden doorgegeven, ofwel vanuit een vaste lijst met entiteiten, ofwel door relevante entiteiten op te halen uit een ChromaDB-vectordatabase. Ingebouwde tools laten het model Home Assistant bedienen en bevragen, en een optioneel tweede extern model kan worden aangeboden voor complexe analyses. De gespreksgeschiedenis kan behouden blijven na herstarts en spraaksessies kunnen worden doorgezet tussen verzoeken van hetzelfde apparaat. Een geheugensysteem haalt na gesprekken feiten en voorkeuren op, met limieten voor het aantal opgeslagen herinneringen en een minimale belangrijkheidsscore. Er zijn acties beschikbaar om entiteiten opnieuw te indexeren en om een gesprek te wissen.
Automatische samenvatting van de README en de code van aradlein/hass-agent-llm, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op
Ondersteunt
Gebruikt de cloud van de aanbieder Heeft een internetverbinding en een account bij de aanbieder nodig.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.
Instellen
Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.
Home Agent instellen
- Naam van de integratieEen herkenbare naam voor deze Home Agent-instantie
- Basis-URL van de LLM-APIAPI-eindpunt dat compatibel is met OpenAI (bijv. api.openai.com/v1 of localhost:11434/v1 voor Ollama)
- API-sleutelAPI-sleutel voor authenticatie (laat leeg als die niet nodig is)
- ModelnaamHet model dat je wilt gebruiken (bijv. gpt-4o-mini, llama3.1, enzovoort)
- TemperatuurBepaalt de willekeur (0.0-2.0). Lager is gerichter, hoger is creatiever.
- Maximaal aantal tokensMaximaal aantal tokens per antwoord
- Keep AliveHoe lang Ollama het model in het geheugen houdt (bijv. 5m, 24h). Gebruik -1 voor onbeperkt.
- Proxy-headersOptionele aangepaste HTTP-headers als JSON, bijv. X-Ollama-Backend: llama-cpp
Contextinjectie
- ContextmodusKies hoe entiteitscontext wordt geïnjecteerd: Direct (altijd de opgegeven entiteiten opnemen) of Vector DB (relevante entiteiten dynamisch ophalen)
- ContextformaatFormaat voor entiteitsgegevens: JSON (gestructureerd) of Natural Language (leesbaar voor mensen)
- Op te nemen entiteitenDoor komma's gescheiden lijst met entiteits-ID's of patronen (bijv. sensor.temperature, light.*, climate.thermostat)
Configuratie van de vectordatabase
- ChromaDB-hostHostnaam of IP-adres van de ChromaDB-server
- ChromaDB-poortPoort van de ChromaDB-server
- Naam van de collectieNaam van de collectie met de embeddings van entiteiten
- Embedding-providerKies tussen OpenAI of Ollama om embeddings te genereren
- Basis-URL van de embedding-APIBasis-URL voor de embedding-API (bijv. localhost:11434 voor Ollama)
- EmbeddingmodelModelnaam (bijv. text-embedding-3-small voor OpenAI, mxbai-embed-large voor Ollama)
- OpenAI-API-sleutelJe OpenAI-API-sleutel (alleen nodig bij gebruik van de OpenAI-provider)
- Top K-resultatenAantal meest relevante entiteiten dat wordt opgehaald
- GelijkenisdrempelMaximale L2-afstandsdrempel (lager = strengere overeenkomst, gebruikelijk bereik: 150-300)
Gespreksgeschiedenis
- Gespreksgeschiedenis inschakelenEerdere gespreksbeurten opnemen in de LLM-context
- Maximaal aantal berichtenMaximaal aantal gespreksbeurten dat wordt bewaard (0 voor onbeperkt)
- Maximaal aantal tokensLimiet op basis van tokens voor de geschiedenis (0 voor onbeperkt)
- Behouden na herstartsDe gespreksgeschiedenis opslaan over herstarts van Home Assistant heen
Systeemprompt
- Standaard systeemprompt gebruikenGebruik de ingebouwde systeemprompt van Home Agent, die het gebruik van tools en richtlijnen uitlegt
- Aangepaste aanvullingen op de promptExtra instructies die aan de systeemprompt worden toegevoegd (bijv. voorkeuren, huisregels)
Toolconfiguratie
- Native tools inschakelenSchakel de tools ha_control en ha_query in voor de integratie met Home Assistant
- Maximaal aantal toolaanroepen per beurtMaximaal aantal tooluitvoeringen per gespreksbeurt
- Time-out van tool (seconden)Maximale uitvoeringstijd voor elke toolaanroep
Externe LLM-tool (optioneel)
- Externe LLM-tool inschakelenStel de tool query_external_llm beschikbaar voor de primaire LLM voor complexe analyses en uitgebreide uitleg
- Basis-URL van externe LLMAPI-eindpunt dat compatibel is met OpenAI voor de externe LLM
- API-sleutel van externe LLMAPI-sleutel voor authenticatie bij de externe LLM
- Model van externe LLMNaam van het externe model (bijv. gpt-4o, claude-3-opus)
- Temperatuur van externe LLMTemperatuur voor antwoorden van de externe LLM
- Maximaal aantal tokens van externe LLMMaximaal aantal tokens voor antwoorden van de externe LLM
- Context automatisch opnemenGespreksgeschiedenis en entiteitscontext automatisch doorgeven aan de externe LLM
Geavanceerde instellingen
- Debuglogging inschakelenSchakel gedetailleerde logging in voor probleemoplossing
- Gebeurtenissen verzendenActiveer Home Assistant-gebeurtenissen voor het bijhouden van gesprekken en voor triggers van automatiseringen
Na het instellen
- LLM-basis-URLOpenAI-compatibel API-eindpunt (bijvoorbeeld api.openai.com/v1 of localhost:11434/v1 voor Ollama)
- API-sleutelAPI-sleutel voor authenticatie
- ModelnaamTe gebruiken model (bijvoorbeeld gpt-4o-mini, llama3.1)
- TemperatuurBepaalt de mate van willekeur (0.0-2.0). Lager is gerichter, hoger is creatiever.
- Maximaal aantal tokensMaximaal aantal tokens per antwoord
- Keep AliveHoe lang Ollama het model in het geheugen houdt (bijvoorbeeld 5m, 24h). Gebruik -1 voor onbeperkt.
- Proxy-headersOptionele aangepaste HTTP-headers als JSON, bijvoorbeeld X-Ollama-Backend: llama-cpp
- Denkmodus inschakelenSta redeneermodellen toe om uitgebreid na te denken. Schakel uit om automatisch /no_think aan prompts toe te voegen voor snellere antwoorden.
- ContextmodusKies hoe de entiteitscontext wordt toegevoegd
- ContextformaatFormaat voor entiteitsgegevens (JSON, natuurlijke taal of hybride)
- Op te nemen entiteitenDoor komma's gescheiden lijst met entiteits-ID's (bijvoorbeeld sensor.temperature,light.*)
- Maximaal aantal contexttokensMaximaal totaal aantal tokens voor context (entiteiten, geschiedenis en prompt). Verhoog dit als je een model met een groot contextvenster hebt. Standaard: 8000.
- ChromaDB-hostHostnaam of IP-adres van de ChromaDB-server
- ChromaDB-poortPoort van de ChromaDB-server
- Naam van de collectieNaam van de collectie met de entiteitsembeddings
- EmbeddingproviderKies tussen OpenAI of Ollama voor het genereren van embeddings
- Basis-URL van de embedding-APIBasis-URL voor de embedding-API (bijvoorbeeld localhost:11434 voor Ollama)
- EmbeddingmodelModelnaam (bijvoorbeeld text-embedding-3-small voor OpenAI, mxbai-embed-large voor Ollama)
- OpenAI-API-sleutelJe OpenAI-API-sleutel (alleen nodig bij gebruik van de OpenAI-provider)
- Top K-resultatenAantal meest relevante entiteiten om op te halen
- GelijkenisdrempelMaximale L2-afstandsdrempel (lager = strengere overeenkomst, typisch bereik: 150-300)
- Gespreksgeschiedenis inschakelenNeem eerdere gespreksbeurten op in de LLM-context
- Maximaal aantal berichtenMaximaal aantal gespreksbeurten dat wordt bewaard
- Maximaal aantal tokensOp tokens gebaseerde limiet voor de geschiedenis
- Persistente spraaksessies inschakelenBehoud de gesprekscontext over meerdere spraakinteracties vanaf hetzelfde apparaat. Als dit is uitgeschakeld, begint elk spraakverzoek een nieuw gesprek.
- Sessietime-out (minuten)Tijd in minuten voordat spraaksessies verlopen en opnieuw beginnen (1-120 minuten)
- Standaard systeemprompt gebruikenGebruik de ingebouwde systeemprompt van Home Agent
- Entiteits- en apparaatlabels opnemenNeem entiteits- en apparaatlabels op in de systeemprompt voor betere context
- Aangepaste promptaanvullingenExtra instructies die aan de systeemprompt worden toegevoegd
- Maximaal aantal toolaanroepen per beurtMaximaal aantal tooluitvoeringen per gespreksbeurt
- Tooltime-out (seconden)Maximale uitvoeringstijd voor elke toolaanroep
- Externe LLM-tool inschakelenStel de tool query_external_llm beschikbaar voor het primaire LLM
- Basis-URL extern LLMOpenAI-compatibel API-eindpunt voor het externe LLM
- API-sleutel extern LLMAPI-sleutel voor authenticatie bij het externe LLM
- Model extern LLMNaam van het externe model
- Temperatuur extern LLMTemperatuur voor antwoorden van het externe LLM
- Maximaal aantal tokens extern LLMMaximaal aantal tokens voor antwoorden van het externe LLM
- ToolbeschrijvingBeschrijving van wanneer het externe LLM moet worden gebruikt
- Context automatisch meesturenGeef context automatisch door aan het externe LLM
- Geheugensysteem inschakelenPrivacyschakelaar: schakel het hele geheugensysteem in of uit
- Automatische geheugenextractie inschakelenHaal na elk gesprek automatisch herinneringen op
- LLM voor geheugenextractieKies welk LLM wordt gebruikt om herinneringen te extraheren (extern is nauwkeuriger, maar vereist dat het externe LLM is ingeschakeld)
- Maximaal aantal opgeslagen herinneringenMaximaal aantal herinneringen dat wordt opgeslagen (de oudste of minst belangrijke worden verwijderd zodra de limiet is bereikt)
- Minimaal belang (0.0-1.0)Filter herinneringen op de belangscore die het LLM toekent. Lagere waarden (0.2-0.3) houden de meeste herinneringen vast, ook terloopse vermeldingen. Gemiddelde waarden (0.4-0.5) filteren kleine details weg. Hogere waarden (0.6-0.8) houden alleen belangrijke voorkeuren en feiten over. De standaardwaarde 0.4 zorgt voor een evenwichtige filtering.
- Minimaal aantal woordenMinimaal aantal betekenisvolle woorden (meer dan 2 tekens) dat nodig is om een herinnering op te slaan. Helpt korte herinneringen met weinig waarde eruit te filteren.
- Herinneringen om in de context op te nemenHoeveel relevante herinneringen in elk gesprek worden opgenomen
- Naam van de ChromaDB-collectieNaam van de ChromaDB-collectie voor het indexeren van herinneringen
Teksten uit de code van aradlein/hass-agent-llm. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.
Acties
- Entiteiten opnieuw indexerenForceer een volledige herindexering van alle Home Assistant-entiteiten in de vectordatabase.
- Entiteit indexerenIndexeer een specifieke entiteit in de vectordatabase.Velden: Entiteits-ID
- Gesprek wissenWis de gesprekssessie en begin opnieuw zonder eerdere context. Hiermee kunnen gebruikers spraakgesprekken resetten voor een specifieke gebruiker of een specifiek apparaat, of alle gesprekken tegelijk.
Uit de README
A highly customizable Home Assistant custom component that provides intelligent conversational AI capabilities with advanced tool calling, context injection, and conversation history management.
- LLM Integration - Works with OpenAI, Azure OpenAI, Ollama, LocalAI, LM Studio, or any OpenAI-compatible endpoint
- Entity Context - Automatically provides relevant entity states to the LLM
- Conversation History - Maintains context across multiple interactions with persistent storage
- Native Tools - Built-in ha_control and ha_query tools for home automation
- Custom Tools - Define REST API and Home Assistant service tools in configuration
- Event System - Rich events for automation triggers and monitoring
- Streaming Responses - Low-latency streaming for voice assistant integration (~10x faster)
Informatie
- Installaties
- 172 die analysegegevens delen
- GitHub-sterren
- 48
- Verbinding
- Gebruikt de cloud van de aanbieder
- Onderhoud
- Bijgewerkt in de afgelopen 6 maanden
- Versie
- v0.9.5,
- Categorie
- AI en spraak, AI-modellen
- Soort
- Marketplace-integratie
- Vereist
- Vereist de Marketplace (HACS op 2026.10 en ouder)
- Domein
home_agent- Problemen
- Probleem melden
