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ı nereden almak istersiniz?" gibi bir soruyla yanıt verebilir. Bu da, kullanıcıyla insan benzeri bir konuşma başlatır. Bu sohbet uygulaması, araç kiralama rezervasyonu sırasında hem insan konuşmasını anlayıp hem de insan konuşmasına 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 etkinleştirilip etkinleştirilmediğini 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'teki bir Chat uygulamasına doğrudan mesaj veya bir Chat alanında mesaj gönderir.
2. Google Cloud'da bulunan bir Dialogflow sanal aracı, mesajı alır ve yanıt oluşturmak için 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şim kurabilir.
4. Dialogflow aracısı, Chat'te Chat uygulaması hizmetine 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 aracısı 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 aracısı insan çağrı merkezi temsilcisi gibidir. İkisini de beklenen konuşma senaryolarını ele alacak şekilde eğitirsiniz ve eğitiminizin fazla açıklığa kavuşturulması gerekmez.

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

1. Dialogflow CX konsolunda Dialogflow CX Console'u 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. Aracı özelleştirmesini daha sonra ayrıntılı olarak incelemek isterseniz önceden oluşturulmuş aracılardan birini seçin. Bu aracılar, aracıların neler yapabileceğini öğrenmek için de faydalıdır.

   Önceden oluşturulmuş bir aracı 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, temsilcinin kullandığı özellik sayısına ve sohbet mantığının gelişmiş olmasına göre başlangıç, orta ve ileri düzey olarak derecelendirilir. 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 aracı 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. Aracınız için varsayılan dili seçin. Temsilciler oluşturulduktan sonra varsayılan dili 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. Aracı özelleştirme işlemiyle ilgili ayrıntılı bir adım adım açıklamalı kılavuz için Dialogflow CX aracısı 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. Test aracısını ortamda test et'i seçin.
   3. Ortam'da Taslak'ı seçin.
   4. Akışta Varsayılan Başlangıç Akışımı seçin.
   5. Sayfada Başlangıç Sayfası'nı seçin.
   6. Temsilciyle konuş yazma çubuğuna Hello yazıp Enter'a basın. Temsilci kendisini tanıtarak yanıt verir.
   7. Örnek test görüşmesini yaparak testi tamamlayın.

8. Dialogflow CX aracısı oluşturulur. Dialogflow CX konsoluna 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 kullandığınız 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 konsolunda 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ünün sonuna 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, Hataları günlüğe kaydetme'yi 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 git

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çlar arasından Chat uygulamanızı seçin. Doğrudan mesaj açılır.

5. Uygulamayı içeren yeni doğrudan mesajda Hello yazıp enter tuşuna basın.

   Dialogflow Chat uygulaması kendini 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 konuşmayı 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 aracısına 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şimi etkinliğinin tam JSON yükü, sorgu parametresinde özel yük olarak Dialogflow'a gönderilir ve WebhookRequest.payload alanının değerini sorgulayarak Dialogflow webhook 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 sohbet 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ı derlerken Dialogflow CX 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.
  • Aracıları nasıl oluşturacağınızı ve yapılandıracağınızı açıklayan adım adım açıklamalı ayrıntılı bir kılavuz için Dialogflow CX aracısı oluşturma bölümüne bakın.
  • code Codelab: Dialogflow CX veri deposu aracısı derlemeyle ilgili örnek için codelab'deki bilgi Chat uygulamasını inceleyin. Gemini ile Google Chat için uygulama geliştirme başlıklı makaleye göz atı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.