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

Bu sayfada hem bir Google Chat uygulamasını hem de doğal dili anlamak ve yanıt vermek için Dialogflow Bu kılavuzda Dialogflow CX Google Chat ile doğrudan entegrasyon. Ayrıca şunu da kullanabilirsiniz: Dialogflow ES ile Aşağıdaki adımları uygulayarak Dialogflow ES Google Chat uygulamasını kullanın "the" Dialogflow ES Google Chat rehberini inceleyin.

Örneğin, kullanıcıların ev kiralamasına yardımcı olan bir Chat uygulamasını ele alalım. arabalar var. Bir kullanıcı "Araba kiralamak istiyorum" yazabilir. İlgili içeriği oluşturmak için kullanılan Chat uygulaması, "Aracı nereden almak istersiniz?" bu da insana benzer bir kullanıcıyla sohbet ederek araç kiralama rezervasyonu yaparken insan konuşmasıyla anlayıp yanıt verir.

Bu sadece bir örnektir. Dialogflow Chat uygulamaları her konuda anlamına gelir. İnsanın doğal konuşmasını gerektiriyorsa Dialogflow Chat uygulaması İlgili içeriği oluşturmak için kullanılan önceden oluşturulmuş aracılar hemen kullanmaya başlayın ve Dialogflow'un neler yapabileceğini gösterin. Örneğin:

• Uçuş rezervasyonu
• Doktor randevuları planlayın
• Adrese yemek siparişi verme
• Perakende ürün kataloğuyla ilgili soruları yanıtlayın (ör. ürünlerin mevcut olup olmadığı) farklı renklerde mevcut

Hedefler

• Ortamınızı ayarlayın.
• Dialogflow CX aracısı oluşturup dağıtma
• Chrome OS tarafından desteklenen bir Chat uygulaması Dialogflow CX aracısı.
• Chat uygulamasını test edin.

Ön koşullar

• Google Workspace şu hesaba erişimi olan hesap: Google Chat.
• Bir Google Cloud projesi.
• Cloud projeniz için faturalandırmayı etkinleştirdiğinizden emin olun. Öğren nasıl yapılır? projelerinizin faturalandırma durumunu doğrulayın.

Mimari

Aşağıdaki şemada, örnek bir makinenin mimarisi Dialogflow ile oluşturulmuş Chat uygulaması:

Önceki şemada, Dialogflow ile etkileşimde bulunan bir kullanıcı Chat uygulamasında aşağıdaki bilgi akışı bulunur:

1. Bir kullanıcı Chat'te bir kullanıcıya mesaj gönderir: doğrudan mesajla veya Chat alanı
2. Google Cloud'da bulunan bir Dialogflow sanal aracısı, ve bir yanıt oluşturmak için mesajı işler.
3. İsteğe bağlı olarak, Dialogflow webhook Dialogflow aracısı harici üçüncü taraf hizmetleriyle etkileşim kurabilir: hale getirebileceğimizi düşünüyoruz.
4. Dialogflow aracısı Chat'te Chat uygulaması hizmeti.
5. Yanıt, Chat alanına gönderilir.

Ortamı ayarlama

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

   API'leri etkinleştirme

2. API'leri doğru şekilde etkinleştirdiğinizden emin olun. Cloud projesine, ardından İleri'yi tıklayın.

3. Doğru API'leri etkinleştirdiğinizden emin olun ve ardından Etkinleştir'i tıklayın.

Dialogflow CX aracısı oluşturma

CEVAP Dialogflow CX aracısı eşzamanlı görüşmeleri işleyen sanal bir aracıdır son kullanıcılarınızla etkileşim kurabilirsiniz. Çevik Manifesto'daki doğal dil anlama insan dilinin nüanslarını anlar. Dialogflow son kullanıcı metnini çeviriyor yaptığınız görüşme sırasında uygulamalarınızın ve hizmetlerinizin anlayacağım. Şunları işlemek için bir Dialogflow aracısı tasarlayıp derleyeceksiniz: ileti dizisi gereklidir.

Dialogflow aracısı insan çağrı merkezi temsilcisi gibidir. İkisine de eğitim verin konuşma senaryolarıyla başa çıkmak için idealdir ve eğitiminiz çok fazla aşırı müstehcen.

Dialogflow CX aracısını aşağıdaki gibi oluşturabilirsiniz:

1. Dialogflow CX konsolunda Dialogflow CX Console'u açın. Sonraki slayta geçin Menü menu > Dialogflow CX'e dokunun.

   Dialogflow CX konsoluna gidin

2. Bir Google Cloud projesi seçin. Projenizi bulmak için Tümü'nü tıklayın ve ardından arama yapın.

3. Artık önceden oluşturulmuş bir aracı veya kendinizinkini oluşturun. Müşteri temsilcisiyle görüşmek isterseniz daha sonra ayrıntılı özelleştirme yapmak isterseniz önceden oluşturulmuş aracılar Bu da temsilcilerin neler yapabileceğini öğrenmesine yardımcı olur.

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

      Temsilciler "acemi," temsilcinin kullandığı özellik sayısına göre orta veya ileri düzey ve sohbet mantığının gelişimini gözler önüne seriyor. Bir Orta veya gelişmiş aracı, temsilciye özel gerektirebilir özellikleri ve API'leri etkinleştirmek de dahil olmak üzere, Google Cloud konsolunu kullanın.

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

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

   1. Temsilci oluştur'u tıklayın.
   2. Oluşturmak için Otomatik oluştur'u seçin veri deposu aracısı veya diğer aracı türleri oluşturmak için Kendiniz oluşturun'u seçin.

   Aracı oluşturma sürecinin ayrıntılı bir adım adım açıklamalı kılavuzu için Dialogflow CX aracısı oluşturun.

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 seçeneği belirleyin. konum. Gelişmiş özellikleri değiştirmek istiyorsanız konum ayarlarınızı kullanıyorsanı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 aracının varsayılan başlangıç akışını gösterir.

6. İsteğe bağlı olarak aracıyı özelleştirin. Temsilciyle ilgili ayrıntılı bilgi edinmek için hakkında daha fazla bilgi edinmek için Dialogflow CX aracısı oluşturun.

7. En iyi uygulama olarak temsilciyi test edin:

   1. Test aracısı'nı tıklayın.
   2. Aracıyı ortamda test et'i seçin.
   3. Ortam'da Taslak'ı seçin.
   4. Akışta, Varsayılan Başlangıç Akışı'nı seçin.
   5. Sayfada Başlangıç Sayfası'nı seçin.
   6. Temsilciyle konuş oluşturma çubuğuna Hello yazıp Enter'a basın. Temsilci kendisini tanıtarak yanıt verir.
   7. Örnek test görüşmesini başlatarak testi tamamlayın.

8. Dialogflow CX aracısı oluşturulur. Dialogflow CX konsoluna dönün. Menü'yü menu tıklayın. > Dialogflow CX'e dokunun.

   Dialogflow CX konsoluna gidin

9. Temsilciler bölümünde more_vert simgesini tıklayın. > Adı kopyala'yı tıklayın. Bu adı farklı kaydet Chat uygulamasını yapılandırırken kullanırsınız.

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

Dialogflow CX aracısı oluşturduktan sonra bunu Chat uygulaması:

1. Google Cloud konsolunda 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 şunu girin: https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
   3. Açıklama alanına Responds to real human conversation yazın.
   4. İşlevsellik bölümünde Bire bir mesajlar al'ı seçin ve Alanlara ve grup görüşmelerine katılabilirsiniz.
   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. Aracı veya Ortam kaynağı adı alanına Dialogflow CX aracısını yapıştırın. sonunda kopyaladığınız ad Dialogflow CX aracısı oluşturun.
   8. Bu Chat uygulamasını belirli kişi ve grupların kullanımına sunma seçeneğini tıklayın 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ı mesajları almaya ve yanıtlamaya hazır mesajları görebilir.

Chat uygulamasını test etme

Dialogflow CX Chat uygulamasını Google Chat

1. Oluşturduğunuz Google Workspace hesabını kullanarak Google Chat'i açın ve kendinizi güvenilir test kullanıcısı olarak eklediğinizde sağlanan bir değerdir.

   Google Chat'e git

2. add Yeni sohbet'i tıklayın.
3. 1 veya daha fazla kişi ekle alanına eklemek istediğiniz kişinin adını Chat uygulaması.

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ın ve enter tuşuna basın.

   Dialogflow Chat uygulaması kendisi.

6. Testi tamamlamak için örnek test görüşmesi.

Örnek test görüşmesi

Dialogflow CX Chat uygulamasını Dialogflow CX konsolunda veya Google Chat'te aşağıdaki görüşmeyi gerçekleştirin. Bu açıklama, Dialogflow CX aracısının kullanıcının doğal dilini kullanır ve anında konuşmanın her adımını içerir. Bu örnek görüşme şuna dayalı olarak: önceden oluşturulmuş aracı Seyahat: araç kiralama adlı bir kampanya oluşturun.

Dialogflow'dan kart mesajları gönderme

Dialogflow, text veya kart mesajları. Kartla yanıt vermek için mesajının içeriğini özel yük bir listesini oluştur: sipariş karşılama.

Aşağıdaki JSON dosyasında, bir kart mesajının sipariş karşılama:

{
  '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ırlamalar ve dikkat edilmesi gereken noktalar

• Chat etkileşimi etkinlikleri sınırlı desteğe sahiptir ve dikkate alınması gereken bazı noktalar vardır:
  • Aşağıdakiler etkileşim etkinliği türleri desteklenir:
    • MESSAGE
    • ADDED_TO_SPACE
    • CARD_CLICKED
  • MESSAGE veya ADDED_TO_SPACE etkinlikleri için sorgu girişi Dialogflow aracısı,argumentText Chat mesajı. Mesajda bir eğik çizgi komutu, bunun yerine text alanı kullanılır.
  • CARD_CLICKED etkinlikleri için sorgu girişi Dialogflow aracısına gönderildi şu şekilde biçimlendirilir: CARD_CLICKED.functionName (functionName) function alanındaki değere karşılık gelir İşlem nesnesi ekli, etkileşimli kart öğesine (ör. bir düğme) ekli olmalıdır.
  • Her Chat etkileşimi etkinliğinin tam JSON yükü sorgu parametresinde özel bir yük olarak Dialogflow'a gönderilir bir Dialogflow webhook WebhookRequest.payload alanının değerini sorgulayarak.
• Yanıt verirken dikkat edilmesi gereken noktalar eğik çizgi komutları ve kartlardan veya iletişim kutularından veri alma:
  • Dialogflow Chat uygulamaları eğik çizgi içeren bir mesaj aldığında komutu sorgusunda, sorgu girişi yalnızca text alanındaki değeri içerir. text alanı eğik çizgi komutunun adıyla başlar (örneğin, /command) tıklayın. Bu örnek, Dialogflow aracısının amacını yapılandırmak için kullanılabilir. komutunu kullanmanızı öneririz.
  • Dialogflow aracısının Chat etkileşimi etkinliği JSON yükü bunu bir Dialogflow webhook kullanarak sorgu parametresindeki özel yükü inceleyin.
  • Menüden bir iletişim kutusunu görüntülemek için Dialogflow Agent sadece bir özel JSON yükü ile yanıt verir. DIALOG içeren bir ileti içerir işlem yanıtı.
  • Kartlardan girilen verileri işlemek için Dialogflow aracısı, CARD_CLICKED metniyle başlayan ve şununla yanıt veren niyetler: uygun öğeyi içeren tek özel JSON yükü işlem.
• Bağlantı önizlemeleri desteklenmez.
• Dialogflow aracısı tek bir mesajla yanıt verirse mesaj Google Chat'e eşzamanlı olarak gönderilir. Dialogflow aracısı yanıt verirse birden çok mesaj varsa tüm mesajlar Chat'e gönderilir yöntemini çağırarak eşzamansız olarak create yöntemini Chat API'deki spaces.messages kaynağında her biri için bir kez mesajını alırsınız.
• Chat ile Dialogflow CX entegrasyonunu kullanırken Dialogflow aracısı ve Chat uygulaması ayarlanmalıdır aynı Google Cloud projesinde çalışır. Dialogflow'u kurmanız gerekiyorsa ve sohbet özelliklerini kullanarak Bağlantıyı kolaylaştırmak için ara sunucu oluşturun. Bunu nasıl yapacağınızı öğrenmek için bunu görün Dialogflow CX için sohbet entegrasyonu örneği bulabilirsiniz.

Sorun giderme

Bir Google Chat uygulaması veya card bir hata döndürürse Chat arayüzünde "Bir sorun oluştu" mesajı gösteriliyor. veya "İsteğiniz işlenemiyor." Chat kullanıcı arayüzü herhangi bir hata mesajı görüntülenmiyor ancak Chat uygulaması veya kart beklenmeyen bir sonuç veriyorsa; Örneğin karttaki bir mesajda görünür.

Chat kullanıcı arayüzünde hata mesajı görüntülenmese de Hataları düzeltmenize yardımcı olmak için açıklayıcı hata mesajları ve günlük verileri sunulur Chat uygulamaları için hata günlük kaydı etkinleştirildiğinde. Görüntüleme konusunda yardım için ve hataları düzeltme ile ilgili daha fazla bilgi edinmek için Google Chat hatalarını giderme ve düzeltme

Temizleme

Aşağıdaki işlem için Google Cloud hesabınızdan ücret alınmasını önlemek amacıyla: kaynaklardan yararlanabilmeniz için Cloud projesi.

1. Google Cloud konsolunda Kaynakları yönetin sayfasına gidin. Sonraki slayta geçin Menü menu > IAM ve Yönetici > Kaynakları Yönetin.

   Resource Manager'a git 'nı inceleyin.

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

İlgili konular

• Dialogflow CX, durum makinesi net ve anlaşılır hale getiren Dialogflow aracı tasarımına üzerinde kontrol sahibi olmanızı, daha iyi bir son kullanıcı deneyimi ve nasıl kullanacağınızı göstereceğim. Dialogflow oluştururken Dialogflow CX kullanmanızı öneririz.
  • Aracıları derleme ve yapılandırma hakkında daha fazla bilgi edinmek için Dialogflow CX Aracıları.
  • Uygulamanızı derleme ve yapılandırma konusunda size yol gösteren ayrıntılı bir kılavuz için öğrenmek için Dialogflow CX aracısı oluşturun.
  • code. Codelab: Dialogflow CX verileri derleme örneği için öğrenmek için aşağıdaki adımları uygulayın: codelab Gemini ile Google Chat için uygulama geliştirme.
  • code. Codelab: Dialogflow CX derleme örneği için sohbet aracısı, geri bildirim için Chat uygulamasına bakın Codelab'den Gemini ile Google Chat için uygulama geliştirme.
• Dialogflow ES Dialogflow'u Chat uygulamasıyla kullanmanın başka bir yoludur.