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 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 sohbet uygulamasını ele alalım. Bir kullanıcı, "Araba kiralamak istiyorum" yazabilir. Chat uygulaması, "Aracı nereden teslim almak istersiniz?" gibi bir soruyla yanıt verebilir. Bu soru, kullanıcıyla insan benzeri bir sohbet başlatır. Chat uygulaması, araç kiralama rezervasyonu sırasında hem anlar hem de insan konuşmasıyla yanıt verir.

Bu yalnızca 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 randevuları planlama
• Yemek siparişi verme
• Bir perakende ürün kataloğuyla ilgili soruları (ör. öğelerin başka renklerde olup olmadığı) yanıtlama

• 

  Şekil 1. Dialogflow Chat uygulaması için önceden oluşturulmuş bir aracı seçme.

• 
  Şekil 2. Temsilcinin mantığının ve yapılandırmasının beklendiği gibi çalıştığından emin olmak için Dialogflow CX'te temsilciyi test etme. Şemada, sohbetteki belirli adımlarla (ör. kiralık araba için teslim alma ve iadenin yapılacağı konum ayarlama) ilgili sıralı bir dizi konu sayfası gösterilmekte ve bunları birbirine bağlayan mantık yapılandırılmaktadır. Görüşme, simülatörde test edilir.
• 
  Şekil 3. Google Cloud Console'daki Chat API yapılandırma sayfasında, yanıtları işlemek için Chat uygulamasını Dialogflow CX temsilcisini kullanacak şekilde yapılandırma.
• 
  Şekil 4. Google Chat'teki Dialogflow Chat uygulamasıyla kiralık araç rezervasyonu hakkında konuşma.

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 Chat 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şime geçebilir.
4. Dialogflow aracısı, Chat'teki Chat uygulama hizmetine yanıt gönderir.
5. Yanıt, Chat alanına gönderilir.

Ortamı ayarlama

Google API'lerini kullanmadan önce bir Google Cloud projesinde etkinleştirmeniz gerekir. Tek bir Google Cloud projesinde bir veya daha fazla API'yi etkinleştirebilirsiniz.

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 görüşme türlerini işlemek üzere bir Dialogflow aracısı 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 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ü > Dialogflow CX'i tıklayın.

   Dialogflow CX konsoluna gidin.

2. Bir Google Cloud projesi seçin. Projenizi bulmak için Tümü'yü tıklayıp projeyi 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ına ve görüşme mantığının karmaşıklığına göre başlangıç, orta veya ileri seviye olarak derecelendirilir. Orta veya ileri düzey bir aracı seçmek, Google Cloud Console'da özelliklerin ve API'lerin etkinleştirilmesi de dahil olmak üzere araca özel ö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. 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 türlerdeki aracıları oluşturmak için Kendiniz oluşturun'u seçin.

   Ajan oluşturma sürecinin ayrıntılı açıklaması için Dialogflow CX ajanı oluşturma başlıklı makaleye bakın.

4. Temel aracı 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. Oluşturduktan sonra 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, 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ı 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. Akış'ta Varsayılan Akış Başlatma'yı seçin.
   5. Sayfa bölümünde Başlangıç Sayfası'nı seçin.
   6. Temsilciyle konuşun oluşturma çubuğuna Hello yazıp Enter tuşuna basın. Temsilci, 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ü > Dialogflow CX'i tıklayın.

   Dialogflow CX konsoluna gidin.

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

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ı kullanabilmesini sağlayın ve e-posta adresinizi girin.
   9. Günlükler bölümünde Günlük hatalarını Logging'e seçeneğini belirleyin.

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. 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.

   Not: Chat uygulamanızı sonuç listesinde görmüyorsanız Google Cloud Console'daki Chat API Yapılandırması sayfasının Görünürlük ayarlarında Google Workspace hesabınızı eklediğinizden emin olun.

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üşmedeki 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: araba kiralama adlı önceden oluşturulmuş aracıya dayanmaktadır.

Dialog	Açıklama
Son kullanıcı: Merhaba Temsilci: Merhaba! Ben sanal araba kiralama acentesi temsilcisiyim. Yeni bir araç kiralama rezervasyonu başlatmanıza yardımcı olabilirim. Bugün size nasıl yardımcı olabilirim?	Varsayılan Başlangıç Akışı'ndaki Varsayılan Karşılama Niyeti rotası çağrılır. Bu durum işleyicinin ("Merhaba! Ben...") yanıt sırasına eklenir. Aracı, yanıt sırasını son kullanıcıya gönderir.
Son kullanıcı: Araç kiralamak istiyorum. Temsilci: Aracı nereden teslim almak istersiniz?	Başlangıç Sayfası'ndaki car_rental.reservation_create amaç rotası eşleştirilir. Oturum, Teslim Alma Konumu sayfasına yönlendirilir. Teslim alma konumu sayfa formu tamamlanmadığı için temsilci, kullanıcıya istem göndermek üzere pickup_location parametresini kullanıyor ("... nereden teslim almak istersiniz?"). Bu istek, yanıt sırasına eklenir. Aracı, yanıt sırasını son kullanıcıya gönderir.
Son kullanıcı: Las Vegas Temsilci: Tamam, teslim alma işlemi Las Vegas'ta yapılacak. Temsilci: Teslimat konumunuz, teslim alma konumunuzdan farklı mı?	Son kullanıcı girişi, önceki görüşme dönüşünde aracı tarafından istenen pickup_location parametresini doldurur. Varsayılan Başlangıç Akışı'ndaki car_rental.return_different_location amacı rotasıyla eşleşir. Teslim alma konumu sayfasındaki form doldurma rotası değerlendirilir ve çağrılır. Parametre referansları, son kullanıcı tarafından sağlanan gerçek değerlere çözümlenmiş şekilde yanıt sırasına eklenen bir karşılama ("Tamam, teslim alma işleminiz...") içerir. Oturum, Konumu Onayla sayfasına yönlendirilir. Konumu Onayla sayfasında bir giriş tamamlama alanı var ("Teslimat konumunuz farklı mı?..."). Bu istek, yanıt sırasına eklenir. Aracı, yanıt sırasını son kullanıcıya gönderir.
Son kullanıcı: Evet. Arabayı Los Angeles'ta bırakacağım. Temsilci: Tamam. Bırakma yeriniz Los Angeles olacak. Temsilci: Aracı hangi tarih ve saatte teslim almak istersiniz?	Varsayılan Başlangıç Akışı'ndaki car_rental.return_different_location amacı rotasıyla eşleşir. Oturum, Bırakma Yeri sayfasına geçer. Son kullanıcı girişi, önceki etkileşim dönüşünde temsilci tarafından istenen drop_off_location parametresini doldurur. Bırakma Konumu sayfasındaki form doldurma rotası değerlendirilir ve çağrılır. Yanıt sırasına eklenen bir karşılama ("Tamam, teslimatınız...") içerir. Oturum, Kiralama Süresi sayfasına yönlendirilir. Kiralama Süresi sayfasında form değerleri eksik olduğundan kullanıcıya pickup_date_time parametresiyle ilgili soru soruluyor ("Aracı hangi tarih ve saatte teslim almak istersiniz?"). Bu istek, yanıt sırasına eklenir. Aracı, yanıt sırasını son kullanıcıya gönderir.
Son kullanıcı: Arabayı 5 Mart'ta öğlen teslim almak istiyorum. Temsilci: Aracı hangi tarih ve saatte bırakmak istersiniz?	Son kullanıcı girişi, önceki görüşme dönüşünde aracı tarafından istenen pickup_date_time parametresini doldurur. Kiralama Süresi sayfasında başka bir form değeri eksik olduğundan kullanıcıya drop_off_date_time parametresi soruluyor ("Aracı hangi tarih ve saatte teslim etmek istersiniz?"). Bu istek, yanıt sırasına eklenir. Aracı, yanıt sırasını son kullanıcıya gönderir.
Son kullanıcı: 15 Mart saat 12:00 Temsilci: Onaylamak için: Aracı şu adresten alacaksınız: Las Vegas 2024-03-05 12:00:00 ve şu adrese bırakacaksınız: Los Angeles 2024-03-15 12:00:00 Doğru mu?	Son kullanıcı girişi, önceki görüşme dönüşünde aracı tarafından istenen drop_off_date_time parametresini doldurur. Oturum, Kiralama Süresini Onayla sayfasına yönlendirilir. Kiralama Süresini Onayla sayfasında bir giriş tamamlama ("Yani onaylamak için...") var. Bu istek, yanıt sırasına eklenir. Aracı, yanıt sırasını son kullanıcıya gönderir.
Son kullanıcı: Evet, teşekkürler. Temsilci: Harika! Şimdi bir araç seçelim. Temsilci: Ekonomik mi yoksa lüks bir araç mı istiyorsunuz?	small_talk.confirmation.yes amacı, Kiralama Süresini Onayla sayfasındaki rotayla eşleşir. Ajan, kullanıcı seçimini bir mesajla onaylar ("Harika! Şimdi de..."), Bu istek, yanıt sırasına eklenir. Oturum, Araç Belirsizliğini Giderme sayfasına geçer. Araç Belirsizliğini Giderme sayfası formu tamamlanmadığı için aracı, kullanıcıya istem göndermek üzere vehicle_type parametresini kullanıyor ("Ekonomik mi yoksa lüks bir araç mı istiyorsunuz?"). Bu istek, yanıt sırasına eklenir. Aracı, yanıt sırasını son kullanıcıya gönderir.
Son kullanıcı: Lütfen ekonomik seçeneği kullanın. Temsilci: Cymbal Car mı yoksa Cymbal Truck mı istersiniz?	$session.params.vehicle_type="economy_vehicle" amaç rotası eşleştirilir. Oturum, Ekonomi Seçenekleri sayfasına yönlendirilir. Ekonomi Seçenekleri sayfasında giriş tamamlama ("... ister misiniz?") özelliği bulunur. Bu istek, yanıt sırasına eklenir. Aracı, yanıt sırasını son kullanıcıya gönderir.
Son kullanıcı: Cymbal Truck. Temsilci: Cymbal Truck'ın günlük ücreti 50,33 ABD dolarıdır. 4 kişi kapasiteli olup AM/FM radyo içerir. Ödeme işlemine devam etmek istiyor musunuz? Son kullanıcı: Evet, lütfen.	$session.params.vehicle_type="Cymbal Truck" amaç rotası eşleştirilir ve vehicle_model parametresi doldurulur. Oturum, Confirm Cymbal Truck (Cymbal Truck'ı Onayla) sayfasına geçer. Confirm Cymbal Truck (Cymbal Kamyonu'nu Onayla) sayfasında giriş yerine getirme ("Cymbal Kamyonu'nun günlük ücreti 50,33 ABD dolarıdır...") yer alıyor. Bu istek, yanıt sırasına eklenir. Aracı, yanıt sırasını son kullanıcıya gönderir. Kullanıcının yanıtı, small_talk.confirmation.yes rotasıyla eşleşiyor.
Temsilci: 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 adresi nedir? Son kullanıcı: 1800 Amphibious Blvd. Mountain View, CA Temsilci: Faturalandırma posta kodu nedir? Son kullanıcı: 94045 Temsilci: Cymbal Car'ı 2024-03-05 12:00:00 tarihinde Las Vegas'tan alıp 2024-03-15 12:00:00 tarihinde bırakacaksınız. Bu seyahatin toplam tutarı 175,38 ABD doları olacaktır. Temsilci: Bizden kiralama yaptığınız için teşekkür eder, iyi günler dileriz.	Oturum, Ödeme sayfasına yönlendirilir. Ödeme formu tamamlanmadığı için temsilci, kullanıcıdan card_type, card_number, billing_name, billing_street_address ve billing_zip_code parametrelerini girmesini istiyor ("Hangi kart türü..."). Bunlar, yanıt sırasına eklenir ve kullanıcı yanıt verdikçe gönderilir. Kullanıcının yanıtları, her parametre değerini ayarlar. Oturum, Kiralama Onayı sayfasına yönlendirilir. Kiralama Onayı sayfasında bir giriş tamamlama ("Tamam, teslim alma işleminiz şu saatte yapılacak...") bulunur. Bu istek, yanıt sırasına eklenir. Aracı, yanıt sırasını son kullanıcıya gönderir. Oturum, Oturumu Sonlandır sayfasına yönlendirilir.

Dialogflow'dan kart mesajları gönderme

Codelab: Dialogflow'dan kart mesajları göndermeyle ilgili uygulamalı bir örnek için Gemini ile Google Chat için uygulama geliştirme codelab'indeki Bilgi Chat uygulaması yanıtlarında kaynakları görüntüleme bölümüne bakın.

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 özel bir yük olarak kart mesajının nasıl gönderileceğini gösterir:

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ı desteklenir ve bazı hususlara dikkat edilmesi gerekir:
  • Aşağıdaki etkileşimli 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 parametresinde ö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 başlar (örneğin, /command). 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 bir iletişim kutusu göstermek için DIALOG içeren bir mesaj içeren tek bir özel JSON yüküyle yanıt verin. İşlem yanıtı.
  • 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 eşzamanlı 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.
• Dialogflow CX'in Chat ile 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, hataları 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.

Dikkat: Bir projenin silinmesinin etkileri şunlardır:

• Projedeki her şey silinir. Bu eğitim için mevcut bir proje kullandıysanız projeyi sildiğinizde projede yaptığınız diğer tüm çalışmalar da silinir.
• Özel proje kimlikleri kaybolur. Bu projeyi oluştururken gelecekte kullanmak istediğiniz özel bir proje kimliği oluşturmuş olabilirsiniz. appspot.com'daki bir URL gibi proje kimliğini kullanan URL'leri korumak için projenin tamamını silmek yerine proje içindeki seçili kaynakları silin.

Birden fazla eğitici ve hızlı başlangıç kılavuzunu incelemeyi planlıyorsanız projeleri yeniden kullanmak proje kotası sınırlarını aşmanızı önleyebilir.

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

   Resource Manager'a gidin

2. Proje listesinde, silmek istediğiniz projeyi seçin ve Sil'i 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, 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.
  • Codelab: Dialogflow CX veri deposu aracısı oluşturma örneği için codelab'deki Gemini ile Google Chat için uygulama geliştirme başlıklı bilgi sohbeti uygulamasına bakın.
  • 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 Chat uygulamasıyla kullanmanın başka bir yoludur.