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

Bu sayfada, Dialogflow kullanarak doğal dili hem anlayabilen hem de doğal dilde 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. Ayrıca, Dialogflow ES Google Chat rehberindeki adımları uygulayarak Dialogflow ES'i kullanarak bir Dialogflow ES Google Chat uygulaması oluşturabilirsiniz.

Örneğin, kullanıcıların araba kiralamasına yardımcı olan bir sohbet uygulamasını ele alalım. Bir kullanıcı, "Araba kiralamak istiyorum" yazabilir. Chat uygulaması, "Aracı nereden almak istersiniz?" gibi bir soruyla yanıt verebilir. Bu soru, kullanıcıyla insan benzeri bir sohbet başlatır. Chat uygulaması, araç kiralama işlemi sırasında hem anlar hem de insan konuşmasıyla yanıt verir.

Bu sadece bir örnektir. Dialogflow Chat uygulamaları her türlü etkileşimde kullanışlıdır. Doğal insan konuşması gerektiren görevler için Dialogflow Chat uygulaması gerekir. Önceden oluşturulmuş aracılar, hızlı bir şekilde başlamanıza yardımcı olur ve Dialogflow'un yapabileceklerini gösterir. Örneğin:

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

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şturun ve 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 bölümüne bakın. Proje oluşturma ve faturalandırmayı ayarlama hakkında bilgi edinmek için Google Cloud projesi oluşturma bölümüne bakın.

Mimari

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

Yukarıdaki diyagramda, bir Dialogflow Chat uygulamasıyla etkileşimde bulunan kullanıcının bilgi akışı şu şekildedir:

1. Bir kullanıcı, bir Chat uygulamasına doğrudan mesaj yoluyla ya da bir Chat alanında mesaj gönderir.
2. Google Cloud'da bulunan bir Dialogflow sanal aracısı, yanıt oluşturmak için mesajı alır ve işler.
3. İsteğe bağlı olarak, Dialogflow webhook'u kullanılarak Dialogflow aracısı, proje yönetimi sistemi veya bilet oluşturma aracı gibi harici üçüncü taraf hizmetleriyle etkileşimde bulunabilir.
4. Dialogflow aracısı, Chat'teki Chat uygulama 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ın ve İleri'yi tıklayın.

3. Doğru API'leri etkinleştirdiğinizden emin olun 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 yöneten bir sanal aracıdır. İnsan dilinin nüanslarını anlayan bir doğal dil anlama modülüdür. Dialogflow, bir görüşme sırasında son kullanıcı metnini uygulamalarınızın ve hizmetlerinizin anlayabileceği yapılandırılmış verilere çevirir. Sisteminiz için gereken türdeki görüşmeleri işlemek üzere bir Dialogflow aracısı tasarlayıp oluşturursunuz.

Dialogflow temsilcisi, insan müşteri hizmetleri temsilcisine benzer. Her ikisini de beklenen görüşme senaryolarını ele alacak şekilde eğitirsiniz ve eğitiminizin aşırı açık olması gerekmez.

Dialogflow CX aracısını oluşturmak için aşağıdaki adımları uygulayın:

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

   Dialogflow CX konsoluna 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 temsilciyi seçebilir veya kendi temsilcinizi oluşturabilirsiniz. Temsilci özelleştirmeyi daha sonra ayrıntılı olarak incelemeyi tercih ederseniz önceden oluşturulmuş temsilcilerden birini seçin. Bu temsilciler, temsilcilerin 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ş aracıları kullan'ı tıklayın.

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

      Temsilciler, kullandıkları özelliklerin sayısı ve sohbet mantıklarının karmaşıklığına göre başlangıç, orta veya ileri düzey olarak derecelendirilir. Orta veya ileri düzey bir aracı seçmek, Google Cloud Console'da özellikleri ve API'leri etkinleştirme de dahil olmak üzere araca özel özelleştirmeler ve ayarlar gerektirebilir.

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

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

   1. Create agent'ı (Ajan oluştur) tıklayın.
   2. Otomatik oluştur'u seçerek veri deposu aracısı oluşturun veya diğer türlerdeki aracıları oluşturmak için Kendiniz oluşturun'u seçin.

   Ajan oluşturma süreciyle ilgili ayrıntılı bir açıklama için Dialogflow CX ajanı oluşturma başlıklı makaleye bakın.

4. Temel temsilci ayarlarını yapılandırın:

   1. Görünen ad bölümüne 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. Bir temsilcinin varsayılan dilini oluşturduktan sonra 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, temsilciyi özelleştirin. Ajan özelleştirme süreciyle ilgili ayrıntılı bir açıklama için Dialogflow CX ajanı oluşturma başlıklı makaleyi inceleyin.

7. En iyi uygulama olarak, aracıyı şu şekilde test edin:

   1. Test agent'ı (Test aracısı) tıklayın.
   2. Test agent in environment (Ortamda aracı test et) seçeneğini belirleyin.
   3. Ortam bölümünde Taslak'ı seçin.
   4. Flow'da Default Start Flow'u (Varsayılan Akış Başlatma) seçin.
   5. Sayfada Başlangıç Sayfası'nı seçin.
   6. Temsilciyle konuşun oluşturma çubuğuna Hello yazıp Enter tuşuna basın. Ajan, kendisini tanıtarak yanıt veriyor.
   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'i tıklayın.

   Dialogflow CX konsoluna gidin

9. Aracılar bölümünde more_vert > Adı kopyala'yı tıklayın. Bu adı kaydedin. Chat uygulamasını yapılandırırken bu adı kullanırsınız.

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

Dialogflow CX ajanı oluşturduktan sonra, bu ajanı bir 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" araması yapı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 bölümüne https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png girin.
   3. Açıklama bölümüne Responds to real human conversation girin.
   4. İşlevsellik bölümünde 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. Agent or Environment resource name (Ajan veya Ortam kaynak adı) bölümüne, Dialogflow CX ajanı oluşturma bölümünün sonunda kopyaladığınız Dialogflow CX ajan adını yapıştırın.
   8. Alanınızdaki belirli kişilerin ve grupların bu Chat uygulamasını kullanmasına izin verin ve e-posta adresinizi girin.
   9. Günlükler bölümünde Günlüğe kaydetme işlemine günlük hataları'nı seçin.

3. Kaydet'i tıklayın.

Chat uygulaması, Chat'teki mesajları almaya ve yanıtlamaya hazırdır.

Chat uygulamasını test etme

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

1. Kendinizi güvenilir test kullanıcıları arasına 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 kişi 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 mesajda Hello yazıp 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 görüşmenin 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ş aracıya dayanmaktadır.

Dialogflow'dan kart mesajları gönderme

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

Aşağıdaki JSON, karşılama sırasında kart mesajının nasıl özel yük olarak gönderileceğini gösterir:

{
  '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ı destek sunar ve bazı hususları göz önünde bulundurmanız gerekir:
  • Aşağıdaki etkileşim etkinlik türleri desteklenir:
    • MESSAGE
    • ADDED_TO_SPACE
    • CARD_CLICKED
  • MESSAGE veya ADDED_TO_SPACE etkinliklerinde, Dialogflow aracısına gönderilen sorgu girişi, sohbet 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 etkinliklerinde, Dialogflow aracısına gönderilen sorgu girişi CARD_CLICKED.functionName olarak biçimlendirilir. Burada functionName, etkileşimli kart öğesine (ör. düğme) eklenen Action nesnesinin function alanının değerine karşılık gelir.
  • Her Chat etkileşimi etkinliğinin tam JSON yükü, sorgu parametresindeki özel bir yük 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 (örneğin, /command) başlar. Bu adı, Dialogflow aracısının niyetini eğik çizgi komutunu algılayacak şekilde yapılandırmak için kullanabilirsiniz.
  • Dialogflow aracısının Chat interaction event JSON payload'u işlemesi gerekiyorsa sorgu parametresindeki özel yükü incelemek için Dialogflow webhook'u kullanabilir.
  • Dialogflow aracısından iletişim kutusu göstermek için DIALOG işlem yanıtı içeren bir mesajı içeren 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 niyetleri algılayabilir ve uygun işlemi içeren tek bir özel JSON yüküyle yanıt verebilir.
• Bağlantı önizlemeleri desteklenmez.
• Dialogflow aracısı yalnızca tek bir mesajla yanıt verirse mesaj, Google Chat'e senkron olarak gönderilir. Dialogflow aracısı 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 eşzamansız olarak gönderilir.
• Chat ile Dialogflow CX entegrasyonunu kullanırken Dialogflow aracısı 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 ara sunucu ayarlayabilirsiniz. Nasıl yapılacağını öğrenmek için GitHub'daki Dialogflow CX için Chat entegrasyonu örneğine bakın.

Sorun giderme

Bir Google Chat uygulaması veya kartı hata döndürdüğünde Chat arayüzünde "Bir hata oluştu" veya "İsteğiniz işlenemiyor" 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üğü kaydı 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 konusunda yardım için Google Chat hatalarını giderme ve düzeltme başlıklı makaleyi inceleyin.

Temizleme

Bu eğitimde kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini önlemek istiyorsanız Cloud projesini silmenizi öneririz.

1. Google Cloud Console'da Kaynakları yönetin sayfasına gidin. Şunu tıklayın: Menü menu > IAM & Admin > Kaynakları Yönetin.

   Resource Manager'a gidin

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

İlgili konular

• Dialogflow CX, Dialogflow aracı tasarımında durum makinesi yaklaşımını benimser. Bu yaklaşım, sohbet ü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ı oluştururken Dialogflow CX'i kullanmanızı öneririz.
  • Ajan oluşturma ve yapılandırma hakkında daha fazla bilgi edinmek için Dialogflow CX Ajanları başlıklı makaleyi inceleyin.
  • Ajan oluşturma ve yapılandırma konusunda ayrıntılı bir açıklama için Dialogflow CX ajanı oluşturma başlıklı makaleyi inceleyin.
  • code Codelab: Dialogflow CX veri deposu aracısı oluşturma örneği için codelab'deki bilgi sohbeti uygulamasına bakın: Gemini ile Google Chat için uygulama geliştirme.
  • code Codelab: Dialogflow CX etkileşimli ajanı oluşturma örneği için codelab'deki geri bildirim Chat uygulamasına bakın: Gemini ile Google Chat için uygulama geliştirme.
• Dialogflow ES, Dialogflow'u bir sohbet uygulamasıyla kullanmanın başka bir yoludur.