Bu sayfada, Dialogflow'u kullanarak doğal dili anlayıp ona yanıt verebilecek bir Google Chat uygulamasının nasıl oluşturulacağı açıklanmaktadır. Bu kılavuzda, Google Chat ile doğrudan entegrasyonu olan ve Developer Preview üzerinden kullanılabilen Dialogflow CX kullanılmaktadır. Dilerseniz Dialogflow ES Google Chat rehberindeki talimatları uygulayarak Dialogflow ES Google Chat uygulaması derlemek amacıyla Dialogflow ES'yi de kullanabilirsiniz.
Örneğin, kullanıcıların araba kiralamalarına yardımcı olan bir Chat uygulamasını düşünün. Kullanıcı, "Araba kiralamak istiyorum" yazabilir. Chat uygulaması, "Aracı nereden almak istersiniz?" gibi bir soruyla yanıt verebilir. Bu soru, kullanıcı ile gerçek kişi benzeri bir konuşma başlatır. Bu görüşmede Chat uygulaması, araç kiralama işlemi sırasında gerçek kişi tarafından konuşulanları anlayıp yanıt verir.
Bu, yalnızca bir örnektir. Dialogflow Chat uygulamaları her türlü etkileşim için kullanışlıdır. Doğal insan konuşması gerekiyorsa bir Dialogflow Chat uygulaması gerektirir. Önceden oluşturulmuş aracılar hızlı bir şekilde çalışmaya başlamanıza yardımcı olur ve Dialogflow'un neler yapabileceğini gösterir. Örneğin:
- Uçuş rezervasyonu
- Doktor randevularını planlama
- Eve yemek siparişi ver
- Perakende ürün kataloğuyla ilgili soruları yanıtlayın. Örneğin, ürünlerin başka renklerde olup olmadığı
-
Şekil 2. Aracının mantığının ve yapılandırmasının istenen şekilde çalıştığından emin olmak için aracıyı Dialogflow CX'te test etme. Bu diyagram, görüşmedeki belirli adımlarla (örneğin, kiralık bir araba için teslim alma ve iade konumu ayarlamak) ilgili konuları içeren sıralı bir dizi konu içerir ve bunları birbirine bağlayan mantığı yapılandırır. Konuşma, simülatörde test edilir. -
Şekil 3. Google Cloud Console'daki Chat API yapılandırma sayfasında Dialogflow CX aracısını kullanarak yanıtları işlemek için Chat uygulaması yapılandırma. -
Şekil 4. Google Chat'teki Dialogflow Chat uygulamasını kullanarak araç kiralama hakkında sohbet etme.
Hedefler
- Ortamınızı ayarlayın.
- Dialogflow CX aracısı oluşturma ve dağıtma.
- Dialogflow CX aracısı tarafından desteklenen bir Chat uygulaması oluşturup dağıtın.
- Chat uygulamasını test edin.
Ön koşullar
- Google Chat'e erişimi olan bir Google Workspace hesabı.
- Bir Google Cloud projesi.
- Cloud projeniz için faturalandırmayı etkinleştirdiğinizden emin olun. Projelerinizin faturalandırma durumunu nasıl doğrulayacağınızı öğrenin.
Mimari
Aşağıdaki şemada, Dialogflow ile derlenen bir Chat uygulamasının mimarisi gösterilmektedir:
Yukarıdaki şemada, Dialogflow Chat uygulamasıyla etkileşime giren bir kullanıcı aşağıdaki bilgi akışına sahiptir:
- Kullanıcı, Chat'te bir Chat uygulamasına doğrudan mesaj yoluyla veya bir Chat alanında mesaj gönderir.
- Google Cloud'da bulunan bir Dialogflow sanal aracısı, yanıt oluşturmak için mesajı alır ve işler.
- İsteğe bağlı olarak, Dialogflow aracısı Dialogflow webhook kullanarak proje yönetim sistemi veya bilet işlemleri aracı gibi harici üçüncü taraf hizmetlerle etkileşime geçebilir.
- Dialogflow aracısı, Chat'teki Chat uygulaması hizmetine bir yanıt gönderir.
- Yanıt Chat alanına gönderilir.
Ortamı ayarlama
Google API'lerini kullanmadan önce bunları bir Google Cloud projesinde etkinleştirmeniz gerekir. Tek bir Google Cloud projesinde bir veya daha fazla API etkinleştirebilirsiniz.Google Cloud konsolunda Google Chat API ve Dialogflow API'yi etkinleştirin.
API'leri doğru Cloud projesinde etkinleştirdiğinizi onaylayın ve İleri'yi tıklayın.
Doğru API'leri etkinleştirmekte olduğunuzu onaylayın ve Etkinleştir'i tıklayın.
Dialogflow CX aracısı oluşturma
Dialogflow CX aracısı, son kullanıcılarınızla eşzamanlı görüşmeleri işleyen sanal aracıdır. İnsan dilinin nüanslarını anlayan doğal bir dil anlama modülü. Dialogflow, bir görüşme sırasındaki son kullanıcı metnini, uygulamalarınızın ve hizmetlerinizin anlayabileceği yapılandırılmış verilere çevirir. Sisteminiz için gereken ileti dizisi türlerini işleyecek bir Dialogflow aracısı tasarlayıp derlersiniz.
Dialogflow aracısı, gerçek bir çağrı merkezi temsilcisi gibidir. İkisini de beklenen konuşma senaryolarını ele alacak şekilde eğitirsiniz ve eğitiminizin aşırı açık olmasına gerek yoktur.
Dialogflow CX aracısını aşağıdaki gibi oluşturabilirsiniz:
Dialogflow CX konsolunda Dialogflow CX Konsolu'nu açın. Menü > Dialogflow CX'i tıklayın.
Bir Google Cloud projesi seçin. Projenizi bulmak için Tümü'nü tıklayıp ardından arama yapmanız gerekebilir.
Artık önceden oluşturulmuş bir aracı seçebilir veya kendi aracınızı oluşturabilirsiniz. Aracı özelleştirmesini daha sonra ayrıntılı olarak incelemeyi tercih ederseniz önceden oluşturulmuş aracılardan birini seçin. Bu, aracıların neler yapabileceğini öğrenmenize de yardımcı olur.
Önceden oluşturulmuş bir aracı seçmek için aşağıdaki adımları uygulayın:
- Önceden oluşturulmuş aracıları kullan'ı tıklayın.
Önceden oluşturulmuş bir aracı seçin. Bu rehber için Seyahat: Araç kiralama'yı seçin.
Aracılar, kullandığı özellik sayısına ve ileti dizisi mantığının gelişmiş özelliklerine bağlı olarak başlangıç, orta veya ileri düzey olarak derecelendirilir. Ara veya gelişmiş aracı seçmek için aracıya özel özelleştirmeler ve ayarlar (Google Cloud Console'da özellikleri ve API'leri etkinleştirmek dahil) gerekebilir.
Aracı olarak içe aktar'ı tıklayın.
Kendi aracınızı oluşturmak için aşağıdaki adımları uygulayın:
- Temsilci oluştur'u tıklayın.
- Bir veri deposu aracısı oluşturmak için Otomatik oluştur'u veya başka türlerde aracılar oluşturmak için Kendi aracınızı derle'yi seçin.
Aracı oluşturma işlemiyle ilgili ayrıntılı bir adım adım açıklamalı kılavuz için Dialogflow CX aracısı oluşturma sayfasına göz atın.
Temel aracı ayarlarını yapılandırın:
- Görünen ad alanına bir görünen ad girin.
- Tercih ettiğiniz konumu seçin. Gelişmiş konum ayarlarını değiştirmek istiyorsanız Düzenle'yi tıklayın.
- Tercih ettiğiniz saat dilimini seçin.
- Aracınız için varsayılan dili seçin. Temsilciler oluşturulduktan sonra varsayılan dili değiştiremezsiniz.
Create'i (Oluştur) tıklayın. Dialogflow CX aracı oluşturmaya başlar ve ardından aracının varsayılan başlangıç akışını görüntüler.
İsteğe bağlı olarak aracıyı özelleştirin. Aracı özelleştirme işleminin ayrıntılı adım adım açıklamalı kılavuzu için Dialogflow CX aracısı oluşturma bölümünü inceleyin.
En iyi uygulama olarak temsilciyi test edin:
- Test aracı'nı tıklayın.
- Aracıda test et'i seçin.
- Ortam'da Taslak'ı seçin.
- Akış bölümünde Varsayılan Akış Başlat'ı seçin.
- Sayfa'da Başlangıç Sayfası'nı seçin.
- Temsilciyle konuş yazma çubuğuna
Hello
yazıp Enter'a basın. Temsilci kendini tanıtarak yanıt verir. - Örnek test görüşmesini kullanarak testi tamamlayın.
Dialogflow CX aracısı oluşturulur. Dialogflow CX konsoluna dönün. Menü > Dialogflow CX'i tıklayın.
Agents (Aracılar) altında, > Copy name'i (Adı kopyala) tıklayın. Bu adı, Chat uygulamasını yapılandırırken kullandığınız şekilde kaydedin.
Chat uygulaması oluşturma ve uygulamayı Dialogflow aracısına bağlama
Dialogflow CX aracısı oluşturduktan sonra bu aracı bir Chat uygulamasına dönüştürmek için aşağıdaki adımları uygulayın:
Google Cloud konsolunda Google Chat API'ye gidin. "Google Chat API" araması yapın ve Google Chat API'yi, ardından Yönet'i tıklayın.
Yapılandırma'yı tıklayın ve Chat uygulamasını ayarlayın:
- Uygulama adı alanına
Dialogflow App
yazın. - Avatar URL'sine
https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
girin. - Açıklama alanına
Responds to real human conversation
girin. - İşlevler bölümünde Bire bir mesaj al ve Alanlara ve grup görüşmelerine katıl'ı seçin.
- Bağlantı ayarları bölümünde Dialogflow'u seçin.
- Dialogflow ayarları bölümünde Dialogflow CX'i seçin.
- Aracı veya Ortam kaynağı adı alanına, Dialogflow CX aracısı oluşturma bölümünün sonunda kopyaladığınız Dialogflow CX aracısı adını yapıştırın.
- Bu Chat uygulamasını alanınızdaki belirli kişiler ve grupların kullanımına sunun ve e-posta adresinizi girin.
- Günlükler bölümünde Hataları Logging'e kaydet'i seçin.
- Uygulama adı alanına
Kaydet'i tıklayın.
Chat uygulaması, Chat'te mesaj almaya ve mesajları yanıtlamaya hazırdır.
Chat uygulamasını test etme
Dialogflow CX Chat uygulamasını Google Chat'te mesaj göndererek test edin.
Kendinizi güvenilir test kullanıcısı olarak eklerken sağladığınız Google Workspace hesabını kullanarak Google Chat'i açın.
- Yeni sohbet'i tıklayın.
- 1 veya daha fazla kişi ekle alanına Chat uygulamanızın adını yazın.
Sonuçlardan Chat uygulamanızı seçin. Bir doğrudan mesaj açılır.
Uygulamayla olan yeni doğrudan mesajda
Hello
yazıpenter
tuşlarına basın.Dialogflow Chat uygulaması, kendisini tanıtarak yanıt verir.
- Örnek test görüşmesini yaparak testi tamamlayın.
Örnek test görüşmesi
Dialogflow CX Chat uygulamasını test etmek için Dialogflow CX konsolunda veya Google Chat'te aşağıdaki görüşmeyi gerçekleştirin. Açıklama, Dialogflow CX aracısının kullanıcının doğal dilini nasıl yorumladığını ve sohbetteki her adımda kendi doğal dil yanıtını nasıl oluşturduğunu anlamanıza yardımcı olur. Bu örnek görüşme, Seyahat: araç kiralama adlı önceden oluşturulmuş aracıya dayanmaktadır.
Dialog | Açıklama |
---|---|
Son kullanıcı: Merhaba Temsilci: Merhaba. Sanal araç kiralama acentesiyim. Yeni bir araba kiralama rezervasyonu başlatmanıza yardımcı olabilirim. Bugün size nasıl yardımcı olabilirim? |
|
Son kullanıcı: Araba kiralamak istiyorum. Müşteri temsilcisi: Aracı nereden almak istersiniz? |
|
Son kullanıcı: Las Vegas Müşteri temsilcisi: Tamam, sizi alacağınız yer Las Vegas'ta olacak. Temsilci: Teslim etme konumunuz, teslim alma konumunuzdan farklı mı? |
|
Son kullanıcı: Evet. Arabayı Los Angeles'a bırakacağım. Müşteri temsilcisi: Tamam, teslim noktası Los Angeles'ta olacak. Temsilci: Aracı hangi tarih ve saatte almak istiyorsunuz? |
|
Son kullanıcı: Arabayı 5 Mart günü öğlen teslim almak istiyorum. Temsilci: Aracı hangi tarih ve saatte bırakmak istiyorsunuz? |
|
Son kullanıcı: 15 Mart öğlen. Temsilci: Onaylamak amacıyla soruyorum: Aracınızı Las Vegas'tan 05.03.2024 12:00:00'dan Los Angeles'a bırakacak 2024.03.15 12:00:00 Sizin için uygun mu? |
|
Son kullanıcı: Evet, teşekkürler. Müşteri temsilcisi: Harika! Şimdi bir araç seçelim. Müşteri temsilcisi: Tercihiniz ekonomik araç mı yoksa lüks bir araç mı? |
|
Son kullanıcı: Ekonomi lütfen. Müşteri temsilcisi: Cymbal Car'ı mı yoksa Cymbal Truck'ı mı istersiniz? |
|
Son kullanıcı: Cymbal Truck. Temsilci: Cymbal Truck'ın günlük ücreti 50,33 ABD dolarıdır. 4 kişi kapasiteli bu cihaz, AM/FM radyoyla birlikte geliyor. Ödeme işlemine devam etmek istiyor musunuz? Son kullanıcı: Evet, lütfen. |
|
Müşteri temsilcisi: Hangi kart türünü kullanacaksınız? Son kullanıcı: Altostrat Temsilci: Lütfen kart numarasını girin. Son kullanıcı: 1234 1234 1234 1234 Temsilci: Kartın üzerindeki ad nedir? Son kullanıcı: Charlie Temsilci: Fatura açık adresi nedir? Son kullanıcı: 1800 Amphibious Blvd. Mountain View, CA Temsilci: Faturalandırma adresinin posta kodu nedir? Son kullanıcı: 94045 Temsilci: Cymbal Car'ı Las Vegas'tan 05.03.2024 12:00:00'da teslim alacaksınız, 15.03.2024 12:00:00. Bu seyahatin toplam maliyeti 175,38 ABD doları olacaktır. Müşteri temsilcisi: Bizimle kiraladığınız için teşekkür eder iyi günler dilerim. |
|
Dialogflow'dan kart mesajları gönderme
Dialogflow, metin veya kart mesajlarla yanıt verebilir. Kart mesajıyla yanıt vermek için bunu sipariş karşılama bölümünde özel yük olarak belirtin.
Aşağıdaki JSON'da, sipariş karşılama işleminde kart mesajının özel yük olarak nasıl gönderileceği gösterilmektedir:
json
{
'cardsV2': [{
'cardId': 'createCardMessage',
'card': {
'header': {
'title': 'A card message!',
'subtitle': 'Sent from Dialogflow',
'imageUrl': 'https://developers.google.com/chat/images/chat-product-icon.png',
'imageType': 'CIRCLE'
},
'sections': [
{
'widgets': [
{
'buttonList': {
'buttons': [
{
'text': 'Read the docs!',
'onClick': {
'openLink': {
'url': 'https://developers.google.com/workspace/chat'
}
}
}
]
}
}
]
}
]
}
}]
}
Sınırlar ve dikkat edilmesi gereken noktalar
- Sohbet etkileşimi etkinlikleri
sınırlı desteğe sahiptir ve dikkat edilmesi gereken bazı noktalar vardır:
- Aşağıdaki etkileşim etkinliği türleri desteklenir:
MESSAGE
ADDED_TO_SPACE
- Dialogflow aracısına gönderilen sorgu girişi, Chat mesajındaki
argumentText
alanının değerine karşılık gelir. Mesajda bir eğik çizgi komutu varsa bunun yerinetext
alanının değeri kullanılır. - Her Chat etkileşim etkinliğinin tam JSON yükü, sorgu parametresinde özel bir yük olarak Dialogflow'a gönderilir ve
WebhookRequest.payload
alanının değeri sorgulanarak Dialogflow webhook ile erişilebilir.
- Aşağıdaki etkileşim etkinliği türleri desteklenir:
- Eğik çizgi komutları için sınırlı destek sunulur:
- İletişim kutularını açan eğik çizgi komutları Dialogflow Chat uygulamaları tarafından desteklenmez.
- Dialogflow Chat uygulamaları eğik çizgi komutu içeren bir mesaj aldığında, sorgu girişi yalnızca
text
alanındaki değeri içerir.text
alanı, eğik çizgi komutunun adıyla başlar (ör./command
). Bu adı, Dialogflow aracısının amacını eğik çizgi komutu algılayacak şekilde yapılandırmak için kullanabilirsiniz. - Dialogflow aracısının eğik çizgi komutunun Chat etkileşim etkinliği JSON yükünü işlemesi gerekiyorsa bunu, sorgu parametresindeki özel yükü incelemek için bir Dialogflow webhook kullanarak yapabilir.
- Bağlantı önizlemeleri desteklenmez.
- Dialogflow aracısı tek bir mesajla yanıt veriyorsa mesaj, Google Chat'e eşzamanlı olarak gönderilir. Dialogflow aracısı birden çok mesajla yanıt verirse her mesaj için Chat API'deki
spaces.messages
kaynağında bulunancreate
yöntemini bir kez çağırarak tüm mesajlar Chat'e eşzamansız olarak gönderilir.
Sorun giderme
Bir Google Chat uygulaması veya kart hata döndürdüğünde Chat arayüzünde "Bir sorun oluştu." veya "İsteğiniz işleme alınamıyor" mesajı gösterilir. Bazen Chat kullanıcı arayüzünde hata mesajı gösterilmez ancak Chat uygulaması veya kartı beklenmedik bir sonuç üretir. Örneğin, kart mesajı görünmeyebilir.
Chat kullanıcı arayüzünde hata mesajı gösterilmese de, Chat uygulamaları için hata günlük kaydı etkinken hataları düzeltmenize yardımcı olacak açıklayıcı hata mesajları ve günlük verileri mevcuttur. Hataları görüntüleme, hata ayıklama ve düzeltme konusunda yardım için Google Chat hatalarını giderme ve düzeltme başlıklı makaleyi inceleyin.
Temizleme
Bu eğiticide kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini istemiyorsanız Cloud projesini silmenizi öneririz.
- Google Cloud konsolunda Kaynakları yönetin sayfasına gidin. Menü > IAM ve Yönetici > Kaynakları Yönet'i tıklayın.
- Proje listesinden silmek istediğiniz projeyi seçin ve Sil'i tıklayın.
- İletişim kutusuna proje kimliğini yazın, ardından projeyi silmek için Kapat'ı tıklayın.
İlgili konular
- Dialogflow CX, Dialogflow aracı tasarımına bir durum makinesi yaklaşımı uygular. Bu yaklaşım size bir konuşma üzerinde net ve açık kontrol, daha iyi bir son kullanıcı deneyimi ve daha iyi bir geliştirme iş akışı sağlar. Dialogflow Chat uygulaması derlerken Dialogflow CX kullanmanızı öneririz.
- Aracıları oluşturma ve yapılandırma hakkında daha fazla bilgi edinmek için Dialogflow CX Aracıları bölümüne bakın.
- Aracıları oluşturma ve yapılandırmayla ilgili ayrıntılı bir adım adım açıklamalı kılavuz için Dialogflow CX aracısı oluşturma bölümüne bakın.
- Dialogflow ES, Dialogflow'u Chat uygulamasıyla kullanmanın başka bir yoludur.