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

Bu sayfada, Dialogflow'u 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 kılavuzunu izleyerek Dialogflow ES'i kullanarak Dialogflow ES Google Chat uygulaması oluşturabilirsiniz.

Örneğin, kullanıcıların araba kiralamasına yardımcı olan bir Chat uygulamasını ele alalım. Kullanıcılar "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 faydalıdır. Doğal insan konuşması gerekiyorsa Dialogflow Chat uygulaması gerekir. Önceden oluşturulmuş aracılar, hızlı bir başlangıç yapmanı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ş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 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şturulmuş bir sohbet uygulamasının mimarisi gösterilmektedir:

Önceki şemada, 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 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ın ve İleri'yi tıklayın.

3. Doğru API'leri etkinleştirdiğinizi onaylayın ve Etkinleştir'i tıklayın.

Dialogflow CX temsilcisi 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 sohbet türlerini işlemek üzere bir Dialogflow ajanı tasarlayıp oluşturursunuz.

Dialogflow temsilcisi, insan olan bir çağrı merkezi 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 temsilcisini oluşturmak için:

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. Ajan özelleştirmeyi daha sonra ayrıntılı olarak incelemeyi tercih ederseniz önceden oluşturulmuş ajanlardan birini seçin. Bu ajanlar, ajanların neler yapabileceği hakkında bilgi edinmek için de faydalıdır.

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

   1. Hazır temsilcileri 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ığı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 bir veri deposu aracısı oluşturun veya diğer aracı türlerini 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ı makaleyi inceleyin.

4. Temel temsilci 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. Ajanınızın varsayılan dilini seçin. Oluşturulduktan sonra bir temsilcinin varsayılan dilini değiştiremezsiniz.

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

6. İsteğe bağlı olarak, aracıyı ö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ı test edin:

   1. Test agent'ı (Test aracısı) tıklayın.
   2. Test agent in environment'ı (Ortamda aracı test et) seçin.
   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 sohbetini yaparak testi tamamlayın.

8. Dialogflow CX temsilcisi 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. Chat uygulamasını yapılandırırken bu adı kullanacağınız için kaydedin.

Sohbet uygulaması oluşturma ve Dialogflow aracısıyla 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 git

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 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ı kullanabilmesini sağlayın ve e-posta adresinizi girin.
   9. Günlükler bölümünde Günlük hatalarını günlüğe kaydetme'yi 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 yeni doğrudan mesajda Hello yazıp enter tuşuna basın.

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

6. Örnek test sohbetini 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 sohbeti yapın. Açıklama, Dialogflow CX temsilcisinin 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ş ajana 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 bunu fulfillment içinde özel yük olarak belirtin.

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

{ "hostAppDataAction": { "chatDataAction": { "createMessageAction": {
  "message": { "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

• Google Chat uygulamalarını Dialogflow ile kullanırken, Chat etkinlik nesneleri aşağıdaki sınırlamalara ve dikkat edilmesi gereken noktalara sahiptir:
  • Uygulama Ana Sayfası Etkinlikleri: APP_HOME etkinlikleri henüz desteklenmemektedir.
  • Dialogflow Query Input: Sorgu girişi olarak Dialogflow temsilcisine gönderilen metin, etkinlik türüne bağlıdır:
    • MESSAGE: Sohbet mesajındaki argumentText alanının değeri.
    • APP_COMMAND: "APP_COMMAND_PAYLOAD" dizesi.
    • ADDED_TO_SPACE: "ADDED_TO_SPACE_PAYLOAD" dizesi.
    • REMOVED_FROM_SPACE: "REMOVED_FROM_SPACE_PAYLOAD" dizesi.
    • CARD_CLICKED: "BUTTON_CLICKED_PAYLOAD" dizesi.
    • WIDGET_UPDATED: "WIDGET_UPDATED_PAYLOAD" dizesi (otomatik tamamlama için kullanılır).
  • Tam Etkinlik Yükü: Sohbet etkileşimi etkinliğinin tam JSON yükü, WebhookRequest.payload alanı içinde Dialogflow'a gönderilir. Buna Dialogflow webhook'unuzdan erişebilirsiniz. Daha fazla bilgi için Dialogflow CX webhook isteği belgelerine bakın.
• Komutlara yanıt verme ve kartlardan veya iletişim kutularından veri alma ile ilgili dikkat edilmesi gereken noktalar:
  • 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 bir iletişim kutusu göstermek için RenderActions nesnesi içeren tek bir özel JSON yüküyle yanıt verin. Bu nesne, gezinme pushCard içerir.
  • Kartlardan girilen verileri işlemek için Dialogflow webhook'u kullanabilir ve uygun işlemi içeren tek bir özel JSON yüküyle yanıt verebilirsiniz.
• Bağlantı önizlemeleri desteklenmez.
• Dialogflow aracısı yalnızca tek 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 her mesaj için bir kez create yöntemi ç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

Chat uygulamanızda hata ayıklamak için öncelikle hata günlüklerini inceleyin. Bu uygulama Dialogflow'u kullandığından, çeşitli günlük kaydı ve sorun giderme kaynaklarından yararlanabilirsiniz:

• Google Workspace eklenti günlükleri: Chat uygulamasıyla etkileşimleri de dahil olmak üzere, Chat uygulamasının davranışı hakkında ayrıntılı bilgi için günlükleri sorgulayın. Google Workspace eklentileri için sorgu günlükleri başlıklı makaleyi inceleyin.

• Google Chat uygulaması hataları: Genel Chat uygulaması hata mesajları ve düzeltmeleri için Chat uygulaması hatalarını giderme ve düzeltme başlıklı makaleyi inceleyin.

• Dialogflow CX Cloud Logging: Temsilciden gelen hatalar ve webhook etkileşimleri de dahil olmak üzere ayrıntılı yürütme günlüklerini yakalamak için Dialogflow aracısı ayarlarınızda Cloud Logging'in etkinleştirildiğinden emin olun. Bu özelliği nasıl etkinleştireceğinizi ve yapılandıracağınızı Dialogflow CX Agent Settings belgelerinden öğrenebilirsiniz. Bu günlükler, Google Cloud Console'daki Günlük Gezgini'nde görüntülenebilir.

• Dialogflow CX Görüşme Geçmişi: Görüşme akışını anlamak ve sorunların nerede oluştuğunu belirlemek için geçmiş etkileşimleri inceleyin. Sohbet Geçmişi başlıklı makaleyi inceleyin.

• Dialogflow ile ilgili genel sorun giderme: Daha kapsamlı Dialogflow sorunları için Dialogflow CX Sorun Giderme Kılavuzu'na bakın.

Temizleme

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

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

   Kaynak Yöneticisi'ne 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 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, görüşme ü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'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 Gemini ile Google Chat için uygulama geliştirme adlı codelab'deki geri bildirim Chat uygulamasına bakın. Build apps for Google Chat with Gemini.
• Dialogflow ES, Dialogflow'u bir sohbet uygulamasıyla kullanmanın başka bir yoludur.

{
  "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"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}