LinknLink App Agent+ Automation Handoff Guide: Von der Absicht zu Home Assistant Aktionen

Die Steuerung in natürlicher Sprache ist nützlich, wenn das Ziel klar ist, der Gerätepfad jedoch nicht. Eine Anforderung wie die Vorbereitung eines Raums für einen Film kann eine Beleuchtung, einen Mediaplayer, einen Anwesenheitsstatus und einen IR-Controller umfassen. LinknLink App Agent+ kann dabei helfen, diese Absicht in einem vorgeschlagenen Workflow zu organisieren, wenn die relevanten Funktionen und Berechtigungen verfügbar sind.

Dieser Leitfaden konzentriert sich auf die Übergabe zwischen der Anfrage und Home Assistant. Es wird nicht davon ausgegangen, dass jede Integration dieselbe Aktion unterstützt. Überprüfen Sie die vorgeschlagenen Einheiten, Bedingungen und Befehle, bevor Sie eine Szene aktivieren, insbesondere wenn diese das Klima, Schlösser, Zugangsgeräte oder andere Haushaltssysteme steuert.

Was eine Automatisierungsübergabe bedeutet

Absicht

Beschreiben Sie im Klartext das gewünschte Haushaltsergebnis, den Raum und den Zeitpunkt.

Übergabe

Wandeln Sie die Anfrage in sichtbare Auslöser, Bedingungen, Entitäten und Aktionen um.

Zustimmung

Überprüfen Sie den Plan in LinknLink App oder Home Assistant, bevor die Automatisierung ausgeführt wird.

Die Übergabe ist der Punkt, an dem ein Agent ein Haushaltsziel in eine strukturierte Automatisierung umwandelt, die im Zielsystem überprüft werden kann. Die Anforderung, der Raum, der Auslöser, die Bedingungen und die Aktionen sollten sichtbar bleiben, damit eine Person den Umfang korrigieren kann, bevor die Routine ein Gerät ändert.

Bevor Sie beginnen

  • Wählen Sie einen Home Assistant-Bereich aus und benennen Sie die Geräte mit raumbezogenen Beschriftungen.
  • Bestätigen Sie, welche LinknLink App-, Agent+- und Home Assistant-Funktionen im aktuellen Setup verfügbar sind.
  • Listen Sie den beabsichtigten Auslöser, die Anwesenheitsbedingung, das Zielgerät und den erwarteten Endzustand auf.
  • Entscheiden Sie, welche Aktionen schreibgeschützt sind, welche einen Entwurf erstellen und welche eine direkte Bestätigung erfordern.
  • Halten Sie Schlösser, Alarme, Garagentore, Einkäufe und zerstörerische Dateiaktionen von der stillen Ausführung fern.
  • Wählen Sie eine erste Aktion mit geringer Auswirkung aus, z. B. ein Licht, eine Benachrichtigung oder einen Befehl zum Anhalten der Medien.
Kontrollhinweis: Beginnen Sie mit einer schreibgeschützten Rezension oder einem Entwurf. Bestätigen Sie Empfänger, Daten, Dateien, Standorte und Smart-Home-Geräte vor externen oder sensiblen Aktionen.

Erstellen Sie eine überprüfbare Agent+-Automatisierungsübergabe

1. Geben Sie die Haushaltsabsicht an

Beschreiben Sie Ergebnis, Raum und Zeitfenster, anstatt mit einer Liste von Menüklicks zu beginnen.

2. Legen Sie die Grenze fest

Benennen Sie den Bereich Home Assistant, zulässige Geräte und Aktionen, die nicht enthalten sein dürfen.

3. Ordnen Sie den Auslöser zu

Wählen Sie ein Tastenereignis, einen Zeitplan, einen Anwesenheitsübergang oder einen anderen unterstützten Auslöser.

4. Kontext hinzufügen

Verwenden Sie die Anwesenheitsentitäten eMotion Air, eMotion Pro oder eMotion Ultra, wenn die Belegung die Entscheidung ändert.

5. Separate Geräteaktionen

Listen Sie die Befehle Licht, Medien, Klima und IR oder RF als separate überprüfbare Aktionen auf.

6. Bitten Sie um die Übergabe

Fordern Sie eine strukturierte Vorschau an, die den Auslöser, Bedingungen, Entitäten, Dienste und Annahmen enthält.

7. Überprüfen Sie die Identität der Entität

Stellen Sie sicher, dass jede Entität zum richtigen Raum und Gerät gehört, bevor Sie den Plan genehmigen.

8. Führen Sie einen Low-Impact-Test durch

Testen Sie eine sichtbare und reversible Aktion und beobachten Sie dabei den Auslöser und den daraus resultierenden Zustand.

9. Gerätesteuerung hinzufügen

Wenn eine Klimaanlage oder ein Fernseher beteiligt ist, verwenden Sie einen kompatiblen IR-Controller wie eRemote HA und testen Sie den Befehl unabhängig.

10. Definieren Sie das Fallback-Verhalten

Legen Sie fest, was passiert, wenn der Sensor nicht verfügbar ist, der Raum leer ist oder ein Gerät nicht reagiert.

Beispielaufforderungen und was Sie überprüfen sollten

Anwendungsfall Beispielanfrage Überprüfen Sie vor der Aktion
Filmmodus Bereiten Sie eine Wohnzimmerfilmszene vor, wenn der Raum belegt ist, und zeigen Sie vor der Genehmigung alle Licht- und Medienaktionen. Bereich, Präsenzstatus, Mediaplayer und Lichteinheiten
Arbeitsmodus Stellen Sie während der Arbeitszeit eine Schreibtischbeleuchtung für das Büro bereit, regeln Sie aber noch nicht das Klima. Zeitfenster, Büropräsenz und ein Licht
Kühlanfrage Wenn das Schlafzimmer belegt ist, bereiten Sie einen Kühlbefehl vor und zeigen Sie das Ziel IR an, bevor Sie ihn ausführen. Kompatibler IR-Controller, Gerät und Handbetätigung
Leerstandswächter Wenn der Raum frei ist, wandeln Sie die Anfrage in eine Benachrichtigung um, anstatt die gesamte Szene zu starten. Leerstandsverzögerung und Ersatzmaßnahmen
Medienpause Wenn niemand im Raum bleibt, schlagen Sie eine Medienpause-Aktion vor und halten Sie sie überprüfbar. Präsenzübergang, Spieler und Verzögerung
Manuelle Ausnahme Wenn der Benutzer das Licht manuell geändert hat, zeigen Sie den Unterschied an und warten Sie auf die Bestätigung. Aktueller Stand, vorgeschlagener Stand und Genehmigung
Eingabeaufforderungsmuster: Geben Sie das Ziel an, definieren Sie den zulässigen Umfang, fügen Sie Einschränkungen hinzu, benennen Sie verbotene Aktionen und fordern Sie vor der Ausführung eine Vorschau an.

Verwenden Sie die Phasen „Lesen“, „Vorbereiten“, „Genehmigen“ und „Ausführen“.

Bühne Agentenaufgabe Benutzerkontrolle
Lesen Überprüfen Sie nur die zulässige Quelle. Wählen Sie die App, den Datumsbereich, den Raum, den Ordner oder das Konto.
Bereiten Sie sich vor Extrahieren Sie Entitäten und erstellen Sie einen Entwurf oder Planvorschlag. Überprüfen Sie Annahmen, fehlende Informationen und betroffene Ressourcen.
Genehmigen Präsentieren Sie die Aktion und das Ziel. Vor der Ausführung bestätigen oder überarbeiten.
Ausführen Führen Sie die unterstützte Aktion nach der Genehmigung aus. Überprüfen Sie das Ergebnis und behalten Sie nach Möglichkeit einen Umkehrpfad bei.

Überprüfen Sie die Checkliste

  • Werden in der Anfrage der richtige Raum und das erwartete Ergebnis genannt?
  • Werden der Auslöser und die Anwesenheitsbedingung den beabsichtigten Entitäten zugeordnet?
  • Sind Licht-, Medien-, Klima- und IR- oder RF-Aktionen zur Überprüfung getrennt?
  • Beinhaltet die vorgeschlagene Übergabe das Verhalten bei nicht verfügbaren und leeren Zimmern?
  • Sind sensible Geräte von der stillen Ausführung ausgeschlossen?
  • Kann jede Aktion unabhängig getestet und rückgängig gemacht werden?
  • Zeigt die Zielautomatisierung Home Assistant dieselben Entitäten an wie die Agentenvorschau?
  • Wurde die kleinste nützliche Aktion vor der Erweiterung der Szene getestet?

Datenschutz, Berechtigungen und sicherere Standardeinstellungen

App-übergreifende Aufgaben können persönliche Kommunikation, Kalender, Dateien, Fotos, Standorte und Haushaltsgeräte betreffen. Erteilen Sie die kleinste nützliche Berechtigung, halten Sie irrelevante Daten außerhalb des Geltungsbereichs und vermeiden Sie die Weitergabe von Anmeldeinformationen, Passwörtern, Einmalcodes oder privaten Kontodaten.

Verwenden Sie Entwürfe für Nachrichten und Anhänge. Nutzen Sie Szenenvorschauen für Smart-Home-Änderungen. Sorgen Sie dafür, dass Einkäufe, Zugriffskontrolle, Sicherheitsvorrichtungen und zerstörerische Dateiaktionen der ausdrücklichen menschlichen Bestätigung unterliegen.

Fehlerbehebung

Der Agent wählt den falschen Raum aus

Verwenden Sie die genauen Bereichs- und Entitätsnamen Home Assistant und fordern Sie dann eine neue Vorschau an, bei der der alte Bereich ausgeschlossen ist.

Die Anwesenheit ist nicht Teil der Übergabe

Bestätigen Sie, dass die relevante Sensorentität der Integration ausgesetzt ist, und fügen Sie die Belegungsregel explizit hinzu.

Der Plan enthält zu viele Aktionen

Teilen Sie die Anfrage in die Phasen Lesen, Vorbereiten, Genehmigen und Ausführen auf, beginnend mit einem Gerät.

Die Appliance IR reagiert nicht

Testen Sie den kompatiblen IR-Controller und -Befehl manuell, bevor Sie ihn zur Agentenübergabe hinzufügen.

Nachdem das Zimmer frei ist, läuft eine Routine ab

Überprüfen Sie die Leerstandsverzögerung, den Automatisierungsmodus und den Ausweichpfad und testen Sie dann einen Übergang von besetzt zu frei.

Der vorgeschlagene Status unterscheidet sich von Home Assistant

Vergleichen Sie Entitäts-IDs, Dienste, Geräteverfügbarkeit und den aktuellen Status, anstatt sich nur auf Anzeigenamen zu verlassen.

Verwandte LinknLink-Produkte

  • eMotion Air: batteriebetriebener mmWave Präsenzkontext für Raumautomatisierungen.
  • eMotion Pro: mmWave Anwesenheitserkennung für unterstützte Home Assistant-Workflows.
  • eMotion Ultra: 60-GHz-Präsenz, Unterstützung für Temperatur- und Feuchtigkeitssensorkabel und integriertes IR.
  • eRemote HA: Kompatible IR Gerätesteuerung für Home Assistant.
  • HomeClaw: ein lokaler Home Assistant und AI-Gateway-Pfad.

Verwandte LinknLink App- und Home Assistant-Anleitungen

Häufig gestellte Fragen

Was ist eine Agent+-Automatisierungsübergabe?

Es handelt sich um einen überprüfbaren Übergang von einem Haushaltsziel in natürlicher Sprache zu einem strukturierten Home Assistant-Plan mit Auslösern, Bedingungen, Entitäten und Aktionen.

Ersetzt Agent+ Home Assistant?

Nein. Home Assistant bleibt die Zielautomatisierungsumgebung, wenn die Integration unterstützt wird. Agent+ hilft bei der Organisation der Anfrage und der Vorbereitung der vorgeschlagenen Arbeit.

Können Präsenzsensoren Teil der Übergabe sein?

Sie können Raumkontext bereitstellen, wenn die Integration ihre Entitäten verfügbar macht. Überprüfen Sie den Bereich, den Status und die Verfügbarkeit, bevor Sie die Automatisierung genehmigen.

Kann die Übergabe eine Klimaanlage steuern?

Für die unterstützte Gerätesteuerung Home Assistant ist ein kompatibler IR-Controller wie eRemote HA erforderlich. Testen Sie den Befehl separat und behalten Sie eine manuelle Überschreibung bei.

Was sollte die erste Agent+-Automatisierung sein?

Beginnen Sie mit einem Raum und einer reversiblen Aktion wie einem Licht, einer Benachrichtigung oder einer Medienpause. Fügen Sie nach dem ersten Test Klima- und Multi-Geräte-Verhalten hinzu.

Wie soll mit sensiblen Handlungen umgegangen werden?

Schlösser, Alarme, Zugangsgeräte, Käufe, Nachrichten und destruktive Aktionen sollten einer direkten menschlichen Überprüfung und nicht einer stillen Ausführung bedürfen.

Beginnen Sie mit einem Raum und einer umkehrbaren Aktion

Wählen Sie einen Raum, einen Auslöser und eine Aktion mit geringer Auswirkung. Bitten Sie Agent+, die vorgeschlagene Home Assistant-Übergabe anzuzeigen, die Entitäten zu überprüfen und die Szene erst dann zu erweitern, wenn der erste Durchlauf klar ist.