Create a Gemini Realtime Voice Agent

Giriş

3CX’te Çağrı Komut Dosyası Oluşturun

Gemini ve Komut Dosyasını Yapılandırın

Nasıl Çalışır

Komut Dosyasını Test Edin

Sorun Giderme

Ayrıca Bakınız

Giriş

geminivoiceagent.cs örneği, gelen bir 3CX çağrısını Google Gemini Live’a bağlar. Temsilci, arayanları karşılayabilir, izin verilen rehber nesnelerini kullanabilir, çağrıları yönlendirebilir, sesli posta veya sohbet seçeneği sunabilir ve yapılandırılmışsa, arayanla ilgili yararlı bilgileri kaydedebilir.

Bu komut dosyası, güvenli bir AI tarafından çağrılabilir işlevin nasıl kaydedileceğini gösteren, devre dışı bırakılmış bir get_department_hours özel aracı içerir.

Bu komut dosyası için 3CX AI Edition lisansı, PBX Update 10 sürümü ve bir Gemini API hesabı gereklidir.

3CX’te Komut Dosyası Oluşturun

• 3CX Yönetici Konsolu’na giriş yapın.
• Entegrasyonlar > Çağrı Komut Dosyaları’na gidin.
• +Mağazadan Ekle‘yi seçin

• geminivoiceagent.cs.’yi seçin.

• Boşluk olmadan küçük harflerle bir isim girin, örneğin geminireception.
• Komut dosyasının nasıl çalışacağını seçin ve gerekli DID’yi, trunk rotasını ya da dahili hedefi seçin.
• Sorumlu bölümü seçin.
• Kod düzenleyiciye devam edin.

Gemini ve Komut Dosyasını Yapılandırın

Aşağıdaki korunan parametreleri PBX’e ekleyin:

• GEMINI_API_KEY - Google AI projenizin API anahtarı
• GEMINI_REALTIME_MODEL - Gemini Realtime modeli.

Komut dosyasında ApiKeyOverride ve ModelOverride alanlarını boş bırakın. Bu değerler boş olduğunda, komut dosyası API anahtarını ve modeli PBX parametrelerinden otomatik olarak okur.

Özellikle komut dosyası paylaşılacak, dışa aktarılacak veya yayınlanacaksa, Gemini API anahtarını komut dosyasına doğrudan girmeyin. ApiKeyOverride veya ModelOverride alanlarında yapılandırılan bir değer, ilgili PBX parametresine göre önceliklidir.

Ardından, komut dosyasının üst kısmında yer alan şu müşteri ayarlarını gözden geçirin:

Üretim ortamına geçmeden önce AllowAllVisibilityForTesting ayarını false olarak belirleyin ve uygulanabilir en küçük görünürlük listesini yapılandırın.

İsteğe bağlı example işlevini etkinleştirmek için, ilgili verileri inceleyin ve şu satırın yorum işaretini kaldırın:

RegisterExampleCustomTool();



“Kaydet” seçeneğini seçin ve derlemenin başarılı olduğunu kontrol edin.

Nasıl Çalışır

1. Gelen bir çağrı, komut dosyası yönlendirme noktasına ulaşır.
2. Komut dosyası, Gemini’nin 3CX dizininde izin verilen görünürlüğünü sıfırlar ve yeniden oluşturur.
3. 3CX, medya kanalını hazırlar.
4. Komut dosyası, yapılandırılmış talimatlar, ses, temsilci adı, API anahtarı ve model ile Gemini Live ses oturumunu başlatır.
5. Onaylanmış araçlar, rehber, aktarma, sesli posta, sohbet ve bağlam eylemlerini gerçekleştirir.
6. Hata durumlarında, yapılandırılmış yedek rotaya yönlendirilir ve yönlendirme kullanılamıyorsa ERROR uyarısı kullanılır.

Komut Dosyasını Test Edin

• Seçilen Gemini ses ve arayanın diline göre davranışını doğrulayın.
• İzin verilen rehber nesnelerini arayın.
• Gizli hedeflerin seçilemediğini doğrulayın.
• Aktarım onayı, sesli mesaj ve sohbeti test edin.
• Doğal bir veda mesajını test edin.
• Sağlayıcı arızasını simüle edin ve yedek yönlendirmeyi doğrulayın.

Sorun Giderme

• Gemini oturumu başarısız: Gemini API anahtarını, desteklenen canlı modeli, lisansı, PBX sürümünü ve dış bağlanabilirliği onaylayın.
• Ses reddedildi: Yapılandırılmış Gemini modeli tarafından desteklenen bir ses kullanın.
• Dizin sonuçları eksik: Numara, bölüm ve rol görünürlüğünü kontrol edin.
• Aşırı sayıda nesne açığa çıkmış: AddAll() işlevini devre dışı bırakın.
• Yedekleme veya sesli uyarı başarısız: Hedefi ve etkin ERROR sesli uyarısını doğrulayın.

Ayrıca Bakınız

• Arama İşleme Komut Dosyası Oluşturun
• PIN için Örnek Arama İşleme Komut Dosyası
• 3CX Yönetim Kılavuzu

Son Güncelleme

Bu belge en son 31 Temmuz 2026’da güncellenmiştir.

https://www.3cx.com.tr/docs/gemini-voice-agent/