azure openai ha

Benutzerdefinierte Azure OpenAI Conversation-Integration für Home Assistant

Was das ist

Diese benutzerdefinierte Integration fügt einen von Azure OpenAI betriebenen Konversationsagenten in Home Assistant hinzu und basiert auf der ursprünglichen OpenAI Conversation-Integration für Home Assistant.

Was es tut

Dieser Konversationsagent ist nicht in der Lage, Ihr Haus zu kontrollieren. Es können nur Informationen abgefragt werden, die vom Home Assistant bereitgestellt wurden. Um Fragen zu Ihrem Haus beantworten zu können, muss Home Assistant OpenAI die Details Ihres Hauses, einschließlich Bereiche, Geräte und deren Zustände, zur Verfügung stellen.

Einschränkungen

• Unterstützte Azure OpenAI-API-Versionen:

  • 2023-06-01-Vorschau
  • 15.05.2023
  • 2023-03-15-Vorschau
  • 01.12.2022

• Unterstützte Home Assistant-Versionen : Aufgrund der bahnbrechenden Änderungen, die Home Assistant Core für benutzerdefinierte Assistenten eingeführt hat, ist die Azure OpenAI Conversation-Integration mit den folgenden Home Assistant-Versionen kompatibel:

Azure OpenAI Conversation-Version	Home Assistant-Version
0.xy	2023.4.x
1.xy	2023,5+

Unterstützte KI-Modelle:

• gpt-35-turbo
• gpt-4
• gpt-4-32k

Installation und Konfiguration

1. Stellen Sie sicher, dass die Konversationsintegration aktiviert ist. Sie ermöglicht Ihnen die Konversation mit Home Assistant. Fügen Sie die folgende Zeile zu Ihrer configuration.yaml hinzu:

 conversation :

2. Laden Sie die Integration von HACS: Azure OpenAI Conversation herunter und installieren Sie sie
3. Starten Sie Ihre Home Assistant-Instanz neu
4. Gehen Sie zu Einstellungen -> Geräte und Dienste -> Integration hinzufügen -> Azure OpenAI Conversation
5. Geben Sie Ihren API Key , API Base und die verwendete API Version gemäß dem folgenden Beispiel ein und klicken Sie auf „Senden“:

• API-Schlüssel: 1234567890abcdef1234567890abcdef
  
• API-Basis: https://iotlabopenai.openai.azure.com/
  
• API-Version: 2023-03-15-Vorschau
  

Benutzer von Home Assistant 2023.5+

Der benutzerdefinierte Assistent muss über Einstellungen -> Sprachassistenten hinzugefügt werden. Sobald er hinzugefügt wurde, können Sie den benutzerdefinierten Assistenten als Favorit auswählen, der standardmäßig verwendet werden soll:

Optionen

Optionen für Azure OpenAI Conversation können über die Benutzeroberfläche festgelegt werden, indem Sie die folgenden Schritte ausführen:

1. Navigieren Sie zu Ihrer Home Assistant-Instanz.
2. Klicken Sie in der Seitenleiste auf Einstellungen -> Geräte & Dienste.
3. Wenn mehrere Instanzen von OpenAI Conversation konfiguriert sind, wählen Sie die Instanz aus, die Sie ändern möchten, und klicken Sie auf „Konfigurieren“.

Verfügbare Optionen:

• Eingabeaufforderungsvorlage: Der Starttext für das KI-Sprachmodell, aus dem neuer Text generiert wird. Dieser Text kann Informationen über Ihre Home Assistant-Instanz, Geräte und Bereiche enthalten und wird mithilfe von Home Assistant-Vorlagen geschrieben.

• Abschlussmodell: Der Name des GPT-Sprachmodells, das für die Textgenerierung bereitgestellt wird (ie my-gpt35-model ). Weitere Details zu den verfügbaren Modellen finden Sie in der Azure OpenAI-Dokumentation.

• Maximale Anzahl von Token, die als Antwort zurückgegeben werden sollen. Die maximale Anzahl von Wörtern oder „Tokens“, die das KI-Modell bei der Vervollständigung der Eingabeaufforderung generieren sollte. Weitere Informationen finden Sie in der Azure OpenAI-Abschlussdokumentation.

• Temperatur: Ein Wert, der den Grad an Kreativität und Risikobereitschaft bestimmt, den das Modell beim Generieren von Text verwenden sollte. Eine höhere Temperatur bedeutet, dass das Modell mit größerer Wahrscheinlichkeit unerwartete Ergebnisse generiert, während eine niedrigere Temperatur zu deterministischeren Ergebnissen führt. Weitere Informationen finden Sie in der Azure OpenAI-Abschlussdokumentation.

• Top P: Als Alternative zur Temperatur bestimmt top_p den Anteil der wahrscheinlichsten Wortwahlen, die das Modell bei der Textgenerierung berücksichtigen sollte. Ein höherer top_p bedeutet, dass das Modell nur die wahrscheinlichsten Wörter berücksichtigt, während ein niedrigerer top_p bedeutet, dass eine größere Auswahl an Wörtern, einschließlich weniger wahrscheinlicher, berücksichtigt wird. Weitere Informationen finden Sie in der Azure OpenAI-Abschlussdokumentation.

Änderungsprotokoll

Bitte beachten Sie die Veröffentlichungshistorie.

So helfen Sie

Es wäre zwar schön, mehr Entwickler zu haben, aber Sie können einen Beitrag leisten, ohne zu wissen, wie man programmiert. Sie können Fehler/Funktionsanfragen einreichen oder bei anderen Aufgaben wie UI-Übersetzungen und der Aktualisierung der README-Datei helfen.

UI-Übersetzungen

Weitere Sprachen können hier hinzugefügt werden, Beiträge sind willkommen :)

Verfügbare Sprachen:

• Englisch
• Spanisch
• Niederländisch (Quelle: @jobvk)
• Französisch (Credits an: @jobvk)
• Deutsch (Quelle: @jobvk)
• Portugiesisch (Credits an: @ViPeR5000)
• Chinesisch (Quelle: @weiting-tw)

Dokumentation

Die README-Datei wird zur Dokumentation verwendet. Wenn sie in Zukunft um Automatisierungen oder andere Optimierungen erweitert wird, können wir zu diesem Zweck über ein Wiki nachdenken.

Haftungsausschluss: Machen Sie sich keine Sorgen, dass Sie Fehler machen, da wir sie mithilfe des Verlaufs rückgängig machen können.

Finanzierung

GitHub	Kauf mir einen Kaffee

Lizenz

MIT – Durch die Bereitstellung eines Beitrags erklären Sie sich damit einverstanden, dass der Beitrag unter MIT lizenziert ist.