Bu rehberde ne öğreneceksin?
Robot erişim kanalı, bir Giizo AI asistanını fiziksel bir cihaz üzerinden sesli veya ekranlı kullanmak için tasarlanmıştır. Bu rehberde robot hesabı oluşturmayı, Raspberry Pi cihazını hazırlamayı, kurulum komutunu çalıştırmayı ve bağlantının gerçekten aktif olduğunu doğrulamayı öğreneceksin.
Ön koşullar
- Düzenleme yetkin olan bir Giizo AI asistanın olmalı.
- API Key, Agent ID ve Robot Hesap ID değerlerini kullanabilecek durumda olmalısın.
- Raspberry Pi 4 veya daha yeni bir cihaz, Raspberry Pi OS Lite 64-bit, USB mikrofon ve hoparlör önerilir.
- Cihaza SSH ile bağlanabiliyor olmalısın.
Adım adım talimatlar
1. Robot hesabı oluştur
Asistan detayına gir ve Erişim Kanalları sekmesini aç. Robot kanalını seçtiğinde robot yönetim ekranı görünür.Yeni Robot butonuyla bir kayıt oluştur. Robot adı, üretici, model ve cihaz yeteneklerini gir. Ses girişi ve ses çıkışı çoğu kurulum için açık kalmalıdır; ekran, kamera veya fiziksel kontrol varsa bunları ayrıca işaretle.
Kaydettiğinde robot kartı listede görünür. Bu kartta Robot Hesap ID değeri oluşur. Bu değer fiziksel cihazın dashboard tarafındaki kimliğidir.
2. Gerekli bilgileri topla
Kurulum scripti üç ana bilgi ister:
- API Key: Ayarlar veya API Key bölümünden oluşturduğun anahtar.
- Agent ID: Asistan detay sayfasının URL adresindeki asistan kimliği.
- Robot Hesap ID: Robot kartında görünen UUID.
Bu değerleri terminale yapıştırmadan önce doğru asistan için aldığından emin ol. Yanlış Agent ID, cihazın başka bir asistanla konuşmasına neden olabilir.
3. Raspberry Pi cihazını hazırla
Raspberry Pi OS Lite 64-bit kur, SSH erişimini aç ve cihazı internete bağla. USB mikrofon ve hoparlörü bağladıktan sonra cihazı yeniden başlatmak iyi bir kontroldür. Ses cihazı USB-Audio olarak görünüyorsa kurulum scripti varsayılan ALSA cihazını otomatik ayarlayabilir.
4. Kurulum komutunu çalıştır
Raspberry Pi'ye SSH ile bağlan ve robot ekranındaki kurulum komutunu çalıştır:
curl -sSL https://raw.githubusercontent.com/giizoai/robot/main/install.sh -o install.sh && sudo bash install.sh
Komut paketleri kurar, robot yazılımını indirir, ortam dosyasını oluşturur ve servisi başlatır. API Base URL ve WebSocket Base URL sorularında özel bir ortam kullanmıyorsan varsayılan değerleri kabul edebilirsin.
5. Bağlantıyı doğrula
Kurulum tamamlandıktan sonra robot kartındaki Son Bağlantı zamanı güncellenmelidir. Robot pasif görünüyorsa karttan aktifleştir ve cihazdaki servisi yeniden başlat.
Sonuç / Doğrulama
Mikrofona konuştuğunda robot, bağlı olduğu Giizo AI asistanına mesaj göndermeli ve ses çıkışıyla yanıt vermelidir. Cihaz tarafında log görmek için şu komutu kullanabilirsin:
sudo journalctl -u giizo-robot -f
İpuçları ve sık karşılaşılan sorunlar
- Son bağlantı güncellenmiyorsa API Key ve Robot Hesap ID değerlerini kontrol et.
- Ses gelmiyorsa mikrofon/hoparlörün işletim sistemi tarafından görüldüğünü doğrula.
- Yanlış asistan cevap veriyorsa Agent ID değerini yeniden gir.
- Script güncelleme için tekrar çalıştırılabilir; mevcut değerleri kontrol ederek ilerle.