Doğal dili anlayan ve yanıt veren bir Dialogflow CX Google Chat uygulaması derleyin

Bu sayfada, Dialogflow'u kullanarak hem anlayabilen hem de doğal dille yanıt verebilen bir Google Chat uygulamasının nasıl oluşturulacağı açıklanmaktadır. Bu kılavuzda, Google Chat ile doğrudan entegrasyonu olan Dialogflow CX kullanılır. Dialogflow ES Google Chat kılavuzunu izleyerek Dialogflow ES Google Chat uygulaması oluşturmak için Dialogflow ES'i de kullanabilirsiniz.

Örneğin, kullanıcıların araç kiralamasına yardımcı olan bir Chat uygulaması düşünün. Bir kullanıcı "Araç kiralamak istiyorum" yazabilir. Chat uygulaması, "Aracınızı nereden almak istersiniz?" gibi bir soruyla yanıt verebilir. Bu soru, kullanıcıyla insansı bir sohbet başlatır. Chat uygulaması, araç kiralama rezervasyonu yaparken kullanıcının sorularını anlayıp doğal bir konuşma dilinde yanıt verir.

Bu yalnızca bir örnektir. Dialogflow Chat uygulamaları her türlü etkileşimde faydalıdır. Doğal insan konuşması gerektiriyorsa Dialogflow Chat uygulaması gerekir. Önceden oluşturulmuş temsilciler, hızlı bir başlangıç yapmanıza ve Dialogflow'un neler yapabileceğini göstermenize yardımcı olur. Örneğin:

• Uçuş rezervasyonu yapma
• Doktor randevusu alma
• Yemek siparişi verme
• Perakende ürün kataloğuyla ilgili soruları (ör. ürünlerin başka renklerde olup olmadığı) yanıtlama

Hedefler

• Ortamınızı ayarlayın.
• Dialogflow CX aracısı oluşturun ve dağıtın.
• Dialogflow CX aracı 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 Business veya Enterprise Google Workspace hesabı
• Faturalandırmanın etkin olduğu bir Google Cloud projesi. Mevcut bir projede faturalandırmanın etkin olup olmadığını kontrol etmek için Projelerinizin faturalandırma durumunu doğrulama başlıklı makaleyi inceleyin. Proje oluşturmak ve faturalandırmayı ayarlamak için Google Cloud projesi oluşturma başlıklı makaleyi inceleyin.

Mimari

Aşağıdaki şemada, Dialogflow ile oluşturulmuş bir Chat uygulamasının mimarisi gösterilmektedir:

Önceki şemada, Dialogflow Chat uygulamasıyla etkileşimde bulunan bir kullanıcının bilgi akışı aşağıdaki gibidir:

1. Kullanıcı, Chat'te bir Chat uygulamasına doğrudan mesaj veya Chat alanında mesaj gönderir.
2. Google Cloud'da bulunan bir Dialogflow sanal aracı, yanıt oluşturmak için mesajı alır ve işler.
3. İsteğe bağlı olarak, Dialogflow webhook kullanarak Dialogflow aracısı, proje yönetimi sistemi veya destek kaydı aracı gibi harici üçüncü taraf hizmetleriyle etkileşime geçebilir.
4. Dialogflow temsilcisi, Chat'teki Chat uygulaması hizmetine bir yanıt gönderir.
5. Yanıt, Chat alanına gönderilir.

Ortamı ayarlama

1. Google Cloud Console'da Google Chat API ve Dialogflow API'yi etkinleştirin.

   API'leri etkinleştirme

2. API'leri doğru Cloud projesinde etkinleştirdiğinizi onaylayıp İleri'yi tıklayın.

3. Doğru API'leri etkinleştirdiğinizden emin olduktan sonra Etkinleştir'i tıklayın.

Dialogflow CX temsilcisi oluşturma

Dialogflow CX aracısı, son kullanıcılarınızla eşzamanlı sohbetleri yöneten sanal bir aracıdır. İnsan dilinin nüanslarını anlayan bir doğal dil anlama modülüdür. Dialogflow, sohbet sırasında son kullanıcı metnini uygulamalarınızın ve hizmetlerinizin anlayabileceği yapılandırılmış verilere dönüştürür. Sisteminiz için gereken sohbet türlerini işlemek üzere bir Dialogflow aracısı tasarlayıp oluşturursunuz.

Dialogflow temsilcisi, gerçek bir çağrı merkezi temsilcisine benzer. Her ikisini de beklenen konuşma senaryolarını ele almaları için eğitirsiniz ve eğitiminizin çok açık olması gerekmez.

Dialogflow CX aracısını oluşturmak için:

1. Dialogflow CX Konsolu'nda Dialogflow CX Konsolu'nu açın. Menü menu > Dialogflow CX'yi tıklayın.

   Dialogflow CX Konsolu'na gidin

2. Bir Google Cloud projesi seçin. Projenizi bulmak için Tümü'nü tıklayıp aramanız gerekebilir.

3. Artık önceden oluşturulmuş bir temsilci seçebilir veya kendi temsilcinizi oluşturabilirsiniz. Temsilci özelleştirmesini daha sonra ayrıntılı olarak incelemeyi tercih ediyorsanız önceden oluşturulmuş temsilcilerden birini seçin. Bu temsilciler, temsilcilerin neler yapabileceği hakkında bilgi edinmenize de yardımcı olur.

   Önceden oluşturulmuş bir temsilci seçmek için aşağıdaki adımları uygulayın:

   1. Önceden oluşturulmuş temsilcileri kullan'ı tıklayın.

   2. Önceden oluşturulmuş bir temsilci seçin. Bu kılavuz için Seyahat: Araç kiralama'yı seçin.

      Temsilciler, kullandıkları özellik sayısına ve sohbet mantığının karmaşıklığına göre başlangıç, orta veya ileri seviye olarak değerlendirilir. Orta veya ileri seviye bir temsilci seçmek, Google Cloud Console'da özellikleri ve API'leri etkinleştirmek de dahil olmak üzere temsilciye özgü özelleştirmeler ve ayarlar gerektirebilir.

   3. Temsilci olarak içe aktar'ı tıklayın.

   Kendi aracınızı oluşturmak için aşağıdaki adımları uygulayın:

   1. Temsilci oluştur'u tıklayın.
   2. Veri deposu aracısı oluşturmak için Otomatik olarak oluştur'u veya başka türde aracılar oluşturmak için Kendi aracınızı oluşturun'u seçin.

   Temsilci oluşturma sürecinin ayrıntılı bir adım adım açıklamalı kılavuzu için Dialogflow CX temsilcisi oluşturma başlıklı makaleyi inceleyin.

4. Temel müşteri temsilcisi ayarlarını yapılandırın:

   1. Görünen ad alanına bir görünen ad girin.
   2. Tercih ettiğiniz konumu seçin. Gelişmiş konum ayarlarını değiştirmek istiyorsanız Düzenle'yi tıklayın.
   3. Tercih ettiğiniz saat dilimini seçin.
   4. Temsilciniz için varsayılan dili seçin. Oluşturulan bir temsilcinin varsayılan dilini değiştiremezsiniz.

5. Oluştur'u tıklayın. Dialogflow CX, aracıyı oluşturmaya başlar ve ardından aracının varsayılan başlangıç akışını gösterir.

6. İsteğe bağlı olarak aracıyı özelleştirin. Temsilci özelleştirme sürecine dair ayrıntılı bir açıklama için Dialogflow CX temsilcisi oluşturma başlıklı makaleyi inceleyin.

7. En iyi uygulama olarak aracıyı test edin:

   1. Test aracısı'nı tıklayın.
   2. Ortamda aracıyı test et'i seçin.
   3. Ortam bölümünde Taslak'ı seçin.
   4. Akış'ta Varsayılan Başlangıç Akışımı seçin.
   5. Sayfa bölümünde Başlangıç Sayfası'nı seçin.
   6. Temsilciyle konuş yazma çubuğuna Hello yazıp Enter tuşuna basın. Müşteri temsilcisi kendini tanıtarak yanıt verir.
   7. Örnek test görüşmesini yaparak testi tamamlayın.

8. Dialogflow CX temsilcisi oluşturulur. Dialogflow CX Konsolu'na dönün. Menü menu > Dialogflow CX'yi tıklayın.

   Dialogflow CX Konsolu'na gidin

9. Temsilciler bölümünde more_vert > Adı kopyala'yı tıklayın. Chat uygulamasını yapılandırırken kullanacağınız için bu adı kaydedin.

Chat uygulaması oluşturup Dialogflow aracısına bağlama

Dialogflow CX temsilcisi oluşturduktan sonra, temsilciyi sohbet uygulamasına dönüştürmek için aşağıdaki adımları uygulayın:

1. Google Cloud Console'da Google Chat API'ye gidin. "Google Chat API"yi arayın ve Google Chat API'yi, ardından Yönet'i tıklayın.

   Chat API'ye gitme

2. Yapılandırma'yı tıklayın ve Chat uygulamasını ayarlayın:

   1. Uygulama adı alanına Dialogflow App yazın.
   2. Avatar URL'si alanına https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png yazın.
   3. Açıklama alanına Responds to real human conversation yazın.
   4. İşlevsellik bölümünde 1:1 mesaj alma ve Alanlara ve grup görüşmelerine katılma'yı seçin.
   5. Bağlantı ayarları bölümünde Dialogflow'u seçin.
   6. Dialogflow ayarları bölümünde Dialogflow CX'i seçin.
   7. Temsilci veya Ortam kaynağı adı alanına, Dialogflow CX temsilcisi oluşturma bölümünde kopyaladığınız Dialogflow CX temsilcisi adını yapıştırın.
   8. Alanınızda bu Chat uygulamasını belirli kişilere ve gruplara sunun ve e-posta adresinizi girin.
   9. Günlükler bölümünde Günlüğe hata kaydet'i seçin.

3. Kaydet'i tıklayın.

Chat uygulaması, Chat'te mesaj almaya ve yanıt vermeye hazırdır.

Chat uygulamasını test etme

Dialogflow CX Chat uygulamasını Google Chat'te mesaj göndererek test edin.

1. Kendinizi güvenilir test kullanıcısı olarak eklerken sağladığınız Google Workspace hesabını kullanarak Google Chat'i açın.

   Google Chat'e gidin

2. add Yeni sohbet'i tıklayın.
3. 1 veya daha fazla kullanıcı ekle alanına Chat uygulamanızın adını yazın.

4. Sonuçlardan Chat uygulamanızı seçin. Doğrudan mesaj açılır.

5. Uygulamayla olan yeni doğrudan mesaja Hello yazın ve enter tuşuna basın.

   Dialogflow Chat uygulaması, kendisini tanıtarak yanıt verir.

6. Örnek test görüşmesini yaparak testi tamamlayın.

Örnek test görüşmesi

Dialogflow CX Chat uygulamasını Dialogflow CX konsolunda veya Google Chat'te test etmek için aşağıdaki görüşmeyi yapın. Açıklama, Dialogflow CX aracısının kullanıcının doğal dilini nasıl yorumladığını ve sohbetin her adımında kendi doğal dil yanıtını nasıl oluşturduğunu anlamanıza yardımcı olur. Bu örnek görüşme, Seyahat: araba kiralama adlı önceden oluşturulmuş temsilciye dayanır.

Dialogflow'dan kart mesajları gönderme

Dialogflow, metin veya kart mesajlarıyla yanıt verebilir. Kart mesajıyla yanıt vermek için sipariş tamamlama işleminde özel yük olarak belirtin.

Aşağıdaki JSON'da, kart mesajının yerine getirme sırasında özel bir yük olarak nasıl gönderileceği gösterilmektedir:

{
  '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 hususlar

• Sohbet etkileşim etkinlikleri sınırlı destek alır ve bazı hususları dikkate almanız gerekir:
  • Aşağıdaki etkileşim etkinliği türleri desteklenir:
    • MESSAGE
    • ADDED_TO_SPACE
    • CARD_CLICKED
  • MESSAGE veya ADDED_TO_SPACE etkinlikleri için Dialogflow temsilcisine gönderilen sorgu girişi, Chat mesajındaki argumentText alanının değerine karşılık gelir. Mesajda eğik çizgi komutu varsa bunun yerine text alanının değeri kullanılır.
  • CARD_CLICKED etkinlikleri için Dialogflow temsilcisine gönderilen sorgu girişi CARD_CLICKED.functionName olarak biçimlendirilir. Burada functionName, etkileşimli kart öğesine (ör. düğme) bağlı İşlem nesnesinin function alanının değerine karşılık gelir.
  • Her Chat etkileşim etkinliğinin tam JSON yük verisi, sorgu parametresinde özel bir yük verisi olarak Dialogflow'a gönderilir ve WebhookRequest.payload alanının değeri sorgulanarak Dialogflow webhook'u ile erişilebilir.
• Eğik çizgi komutlarına yanıt verme ve kartlardan veya iletişim kutularından veri alma ile ilgili dikkat edilmesi gereken noktalar:
  • Dialogflow Chat uygulamaları, eğik çizgi komutu içeren bir mesaj aldığında sorgu girişi yalnızca text alanının değerini içerir. text alanı, eğik çizgi komutunun adıyla başlar (örneğin, /command). Bu alanı, Dialogflow aracısının eğik çizgi komutunu algılayacak şekilde yapılandırmak için kullanabilirsiniz.
  • Dialogflow temsilcisinin sohbet etkileşimi etkinliği JSON yükünü işlemesi gerekiyorsa sorgu parametresindeki özel yükü incelemek için Dialogflow webhook'ı kullanarak bunu yapabilir.
  • Dialogflow aracısından bir iletişim görüntülemek için DIALOG işlem yanıtı içeren bir mesajın yer aldığı tek bir özel JSON yüküyle yanıt verin.
  • Kartlardan girilen verileri işlemek için Dialogflow aracısı, CARD_CLICKED metniyle başlayan intent'leri algılayabilir ve uygun işlemi içeren tek bir özel JSON yükü ile yanıt verebilir.
• Bağlantı önizlemeleri desteklenmez.
• Dialogflow temsilcisi yalnızca bir mesajla yanıt verirse mesaj Google Chat'e eşzamanlı olarak gönderilir. Dialogflow temsilcisi birden fazla mesajla yanıt verirse tüm mesajlar, Chat API'deki spaces.messages kaynağında create yöntemi her mesaj için bir kez çağrılarak Chat'e asynkron olarak gönderilir.
• Chat ile Dialogflow CX entegrasyonu kullanılırken Dialogflow temsilcisi ve Chat uygulaması aynı Google Cloud projesinde ayarlanmalıdır. Dialogflow ve Chat'i farklı Cloud projelerinde ayarlamanız gerekiyorsa bağlantıyı kolaylaştırmak için bir ara sunucu oluşturabilirsiniz. Bunu nasıl yapacağınızı öğrenmek için GitHub'daki Dialogflow CX örneği için Chat entegrasyonu başlıklı makaleyi inceleyin.

Sorun giderme

Bir Google Chat uygulaması veya kartı hata döndürdüğünde Chat arayüzünde "Bir hata oluştu" mesajı gösterilir. veya "İsteğiniz işlenemiyor." Bazen Chat kullanıcı arayüzünde hata mesajı gösterilmez ancak Chat uygulaması veya kartı beklenmedik bir sonuç verir. Örneğin, kart mesajı görünmeyebilir.

Chat kullanıcı arayüzünde hata mesajı gösterilmeyebilir ancak Chat uygulamaları için hata günlüğü etkinleştirildiğinde hataları düzeltmenize yardımcı olacak açıklayıcı hata mesajları ve günlük verileri kullanılabilir. Hataları görüntüleme, hata ayıklama ve düzeltme hakkında yardım için Google Chat hatalarını giderme 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.

1. Google Cloud Console'da Kaynakları yönetin sayfasına gidin. Menü menu > IAM ve Yönetici > Kaynakları Yönet'i tıklayın.

   Resource Manager'a gidin

2. Proje listesinde, silmek istediğiniz projeyi seçin ve ardından Sil'i delete tıklayın.
3. İletişim kutusuna proje kimliğini yazın ve projeyi silmek için Kapat'ı tıklayın.

İlgili konular

• Dialogflow CX, Dialogflow temsilcisi tasarımında durum makinesi yaklaşımını benimser. Bu yaklaşım, sohbet üzerinde net ve açık bir kontrol, daha iyi bir son kullanıcı deneyimi ve daha iyi bir geliştirme iş akışı sağlar. Dialogflow Chat uygulaması oluştururken Dialogflow CX'yi kullanmanızı öneririz.
  • Temsilci oluşturma ve yapılandırma hakkında daha fazla bilgi edinmek için Dialogflow CX Temsilcileri başlıklı makaleyi inceleyin.
  • Temsilcileri nasıl oluşturacağınız ve yapılandıracağınız hakkında ayrıntılı bir açıklamalı kılavuz için Dialogflow CX temsilcisi oluşturma başlıklı makaleyi inceleyin.
  • code Codelab: Dialogflow CX veri mağazası temsilcisinin nasıl oluşturulacağına dair bir örnek için Gemini ile Google Chat için uygulama oluşturma codelab'indeki bilgi Chat uygulamasına bakın.
  • code Codelab: Dialogflow CX etkileşimli aracının nasıl oluşturulacağına dair bir örnek için Gemini ile Google Chat için uygulama oluşturma codelab'indeki geri bildirim Chat uygulamasına bakın.
• Dialogflow'u Chat uygulamasıyla kullanmanın bir diğer yolu da Dialogflow ES'dir.