azure openai ha

Integrasi Kustom Percakapan Azure OpenAI untuk Asisten Rumah

Apa Ini

Integrasi kustom ini menambahkan agen percakapan yang didukung oleh Azure OpenAI di Home Assistant, yang didasarkan pada integrasi OpenAI Conversation asli untuk Home Assistant.

Apa Fungsinya

Agen percakapan ini tidak dapat mengendalikan rumah Anda. Itu hanya dapat menanyakan informasi yang telah disediakan oleh Home Assistant. Untuk dapat menjawab pertanyaan tentang rumah Anda, Home Assistant perlu memberi OpenAI detail rumah Anda, yang mencakup area, perangkat, dan statusnya.

Keterbatasan

• Versi API Azure OpenAI yang didukung:

  • Pratinjau 01-06-2023
  • 15-05-2023
  • Pratinjau 15-03-2023
  • 01-12-2022

• Versi Home Assistant didukung: Karena perubahan yang dapat menyebabkan gangguan yang diperkenalkan oleh Home Assistant Core untuk asisten kustom, integrasi Azure OpenAI Conversation kompatibel dengan versi Home Assistant berikut:

Versi Percakapan Azure OpenAI	Versi Asisten Rumah
0.xy	2023.4.x
1.xy	2023.5+

Model AI yang didukung:

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

Instalasi dan Konfigurasi

1. Pastikan integrasi percakapan diaktifkan, ini memungkinkan Anda berkomunikasi dengan Home Assistant, tambahkan baris di bawah ini ke configuration.yaml Anda.yaml :

 conversation :

2. Unduh dan instal integrasi dari HACS: Azure OpenAI Conversation
3. Mulai ulang instans Home Assistant Anda
4. Buka Pengaturan -> Perangkat & Layanan -> Tambahkan Integrasi -> Percakapan Azure OpenAI
5. Ketik API Key Anda, API Base , dan API Version yang digunakan dengan mengikuti contoh di bawah ini dan tekan kirim:

• Kunci API: 1234567890abcdef1234567890abcdef
  
• Basis API: https://iotlabopenai.openai.azure.com/
  
• Versi API: pratinjau 15-03-2023
  

Pengguna Asisten Rumah 2023.5+

Asisten khusus perlu ditambahkan dari Pengaturan -> Asisten suara. Setelah ditambahkan, Anda dapat memilih asisten khusus sebagai favorit untuk digunakan secara default:

Pilihan

Opsi untuk Percakapan Azure OpenAI dapat diatur melalui antarmuka pengguna, dengan melakukan langkah-langkah berikut:

1. Telusuri ke instans Home Assistant Anda.
2. Di sidebar klik Pengaturan -> Perangkat & Layanan.
3. Jika beberapa contoh OpenAI Conversation dikonfigurasi, pilih contoh yang ingin Anda ubah dan klik "Konfigurasi".

Pilihan yang tersedia:

• Template Prompt: Teks awal untuk model bahasa AI untuk menghasilkan teks baru. Teks ini dapat berisi informasi tentang instance, perangkat, dan area Home Assistant Anda dan ditulis menggunakan Templat Home Assistant.

• Model Penyelesaian: Nama model bahasa GPT yang diterapkan untuk pembuatan teks (yaitu- my-gpt35-model ). Anda dapat menemukan detail selengkapnya tentang model yang tersedia di Dokumentasi Azure OpenAI.

• Token Maksimum yang Akan Dikembalikan sebagai Respons Jumlah maksimum kata atau "token" yang harus dihasilkan model AI dalam penyelesaian perintahnya. Untuk informasi selengkapnya, lihat Dokumentasi Penyelesaian Azure OpenAI.

• Suhu: Nilai yang menentukan tingkat kreativitas dan pengambilan risiko yang harus digunakan model saat membuat teks. Temperatur yang lebih tinggi berarti model lebih mungkin memberikan hasil yang tidak diharapkan, sedangkan temperatur yang lebih rendah menghasilkan hasil yang lebih deterministik. Lihat Dokumentasi Penyelesaian Azure OpenAI untuk informasi selengkapnya.

• P Teratas: Alternatif untuk suhu, top_p menentukan proporsi pilihan kata yang paling mungkin dipertimbangkan model saat membuat teks. Top_p yang lebih tinggi berarti model hanya akan mempertimbangkan kata-kata yang paling mungkin, sedangkan top_p yang lebih rendah berarti rentang kata yang lebih luas, termasuk kata-kata yang kemungkinannya kecil, akan dipertimbangkan. Untuk informasi selengkapnya, lihat Dokumentasi Penyelesaian Azure OpenAI.

log perubahan

Silakan rujuk riwayat rilis.

Bagaimana Membantu

Meskipun akan menyenangkan jika memiliki lebih banyak pengembang, Anda dapat berkontribusi tanpa mengetahui cara membuat kode. Anda dapat mengajukan bug/permintaan fitur, atau Anda dapat membantu tugas lain seperti Terjemahan UI dan memperbarui README.

Terjemahan UI

Lebih banyak bahasa dapat ditambahkan di sini, kontribusi dipersilakan :)

Bahasa tersedia:

• Bahasa inggris
• Spanyol
• Belanda (kredit ke: @jobvk)
• Perancis (kredit ke: @jobvk)
• Jerman (kredit ke: @jobvk)
• Portugis (kredit ke: @ViPeR5000)
• Bahasa Mandarin (kredit ke: @weiting-tw)

Dokumentasi

File README akan digunakan untuk Dokumentasi, jika diperluas di masa depan dengan otomatisasi atau penyesuaian lainnya, kita dapat memikirkan wiki untuk tujuan itu.

Penafian: Jangan khawatir membuat kesalahan karena kami dapat kembali menggunakan riwayat?.

Pendanaan

GitHub	Belikan aku kopi

Lisensi

MIT - Dengan memberikan kontribusi, Anda setuju bahwa kontribusi tersebut dilisensikan di bawah MIT.