یک برنامه Dialogflow CX Google Chat بسازید که درک کند و با زبان طبیعی پاسخ دهد

این صفحه نحوه ساخت یک برنامه Google Chat را توضیح می‌دهد که با استفاده از Dialogflow هم بتواند با زبان طبیعی بفهمد و هم پاسخ دهد. این راهنما از Dialogflow CX استفاده می‌کند که مستقیماً با Google Chat ادغام می‌شود. همچنین می‌توانید از Dialogflow ES برای ایجاد یک برنامه Dialogflow ES Google Chat با دنبال کردن راهنمای Dialogflow ES Google Chat استفاده کنید.

به عنوان مثال، یک برنامه چت را در نظر بگیرید که به افراد کمک می کند ماشین اجاره کنند. یک کاربر ممکن است بنویسد، "من می خواهم یک ماشین اجاره کنم". برنامه Chat ممکن است با سؤالی مانند "از کجا می‌خواهید وسیله نقلیه را تحویل بگیرید؟" پاسخ دهد. که مکالمه ای شبیه به انسان را با کاربر شروع می کند که در آن برنامه چت در هنگام رزرو ماشین کرایه، هم گفتار انسان را می فهمد و هم با آن پاسخ می دهد.

این فقط یک نمونه است. برنامه‌های گفتگوی Dialogflow در انواع تعاملات مفید هستند. اگر به گفتار طبیعی انسان نیاز دارد، به یک برنامه گفتگوی گفتگوی جریان نیاز دارد. عوامل از پیش ساخته شده به شما کمک می کنند تا سریع شروع کنید و کارهایی را که Dialogflow می تواند انجام دهد را به نمایش بگذارید، مانند:

  • رزرو پرواز
  • برای قرار ملاقات با پزشک برنامه ریزی کنید
  • سفارش تحویل غذا
  • به سؤالات مربوط به کاتالوگ محصولات خرده فروشی پاسخ دهید، مانند اینکه آیا اقلام در رنگ های دیگر موجود هستند یا خیر
  • صفحه انتخاب عامل از پیش ساخته شده Dialogflow.
    شکل 1. انتخاب یک عامل از پیش ساخته شده برای برنامه Dialogflow Chat.
  • آزمایش عامل در Dialogflow CX.
    شکل 2. آزمایش عامل در Dialogflow CX برای اطمینان از کارکرد منطق و پیکربندی عامل همانطور که در نظر گرفته شده است. این نمودار مجموعه‌ای متوالی از صفحات موضوعی را نشان می‌دهد که به مراحل خاصی در مکالمه مربوط می‌شوند، مانند تعیین مکان تحویل و بازگشت برای خودروی کرایه‌ای، و منطقی را که آنها را به هم متصل می‌کند، پیکربندی می‌کند. مکالمه در یک شبیه ساز تست شده است.
  • پیکربندی یک برنامه گفتگوی گفتگو.
    شکل 3. پیکربندی یک برنامه چت برای پردازش پاسخ ها با استفاده از عامل Dialogflow CX در صفحه پیکربندی Chat API در کنسول Google Cloud.
  • آزمایش برنامه Dialogflow CX Chat
    شکل 4. مکالمه در مورد رزرو ماشین کرایه ای با برنامه Dialogflow Chat در Google Chat.

اهداف

  • محیط خود را تنظیم کنید.
  • یک عامل Dialogflow CX ایجاد و استقرار کنید.
  • یک برنامه چت که توسط عامل Dialogflow CX پشتیبانی می‌شود، ایجاد و اجرا کنید.
  • برنامه چت را تست کنید.

پیش نیازها

معماری

نمودار زیر معماری یک برنامه چت ساخته شده با Dialogflow را نشان می دهد:

معماری یک برنامه چت پیاده سازی شده با Dialogflow.

در نمودار قبلی، کاربری که با یک برنامه گفتگوی گفتگو در حال تعامل است، جریان اطلاعات زیر را دارد:

  1. کاربر پیامی را در چت به یک برنامه چت، چه در یک پیام مستقیم یا در فضای چت، ارسال می کند.
  2. یک عامل مجازی Dialogflow که در Google Cloud قرار دارد، پیام را دریافت و پردازش می‌کند تا پاسخی ایجاد کند.
  3. به صورت اختیاری، با استفاده از یک هوک Dialogflow ، عامل Dialogflow می‌تواند با سرویس‌های شخص ثالث خارجی، مانند سیستم مدیریت پروژه یا ابزار فروش بلیط، تعامل داشته باشد.
  4. عامل Dialogflow پاسخی را به سرویس برنامه Chat در Chat ارسال می کند.
  5. پاسخ به فضای چت تحویل داده می شود.

محیط را تنظیم کنید

قبل از استفاده از Google API، باید آنها را در پروژه Google Cloud روشن کنید. می‌توانید یک یا چند API را در یک پروژه Google Cloud روشن کنید.

  1. در کنسول Google Cloud، Google Chat API و Dialogflow API را فعال کنید.

    API ها را فعال کنید

  2. تأیید کنید که APIها را در پروژه Cloud صحیح فعال می‌کنید، سپس روی Next کلیک کنید.

  3. تأیید کنید که API های صحیح را فعال می کنید، سپس روی فعال کردن کلیک کنید.

یک عامل Dialogflow CX ایجاد کنید

عامل Dialogflow CX یک عامل مجازی است که مکالمات همزمان با کاربران نهایی شما را مدیریت می کند. این یک ماژول درک زبان طبیعی است که تفاوت های ظریف زبان انسانی را درک می کند. Dialogflow متن کاربر نهایی را در طول مکالمه به داده‌های ساختاری ترجمه می‌کند که برنامه‌ها و سرویس‌های شما می‌توانند آن را درک کنند. شما یک عامل Dialogflow را برای مدیریت انواع مکالمات مورد نیاز برای سیستم خود طراحی و می سازید.

یک نماینده Dialogflow مانند یک نماینده مرکز تماس انسانی است. شما هر دوی آنها را برای کنترل سناریوهای مکالمه مورد انتظار آموزش می دهید و نیازی نیست که آموزش شما بیش از حد صریح باشد.

در اینجا نحوه ایجاد عامل Dialogflow CX آمده است:

  1. در کنسول Dialogflow CX، کنسول Dialogflow CX را باز کنید. منو > Dialogflow CX را کلیک کنید.

    به کنسول Dialogflow CX بروید

  2. یک پروژه Google Cloud را انتخاب کنید. برای پیدا کردن پروژه خود، ممکن است لازم باشد روی همه کلیک کنید و سپس آن را جستجو کنید.

  3. اکنون شما این امکان را دارید که یک عامل از پیش ساخته شده انتخاب کنید یا خود را ایجاد کنید. اگر ترجیح می‌دهید بعداً سفارشی‌سازی عامل را با جزئیات کاوش کنید، یکی از عوامل از پیش ساخته شده را انتخاب کنید، که همچنین برای اطلاع از کارهایی که نماینده‌ها می‌توانند انجام دهند مفید هستند.

    برای انتخاب یک عامل از پیش ساخته شده، مراحل زیر را دنبال کنید:

    1. روی استفاده از عوامل از پیش ساخته شده کلیک کنید.

    2. یک عامل از پیش ساخته شده را انتخاب کنید. برای این راهنما، سفر: کرایه ماشین را انتخاب کنید.

      بر اساس تعداد ویژگی هایی که نماینده استفاده می کند و بر اساس پیچیدگی منطق مکالمه، نمایندگان به عنوان مبتدی، متوسط ​​یا پیشرفته رتبه بندی می شوند. انتخاب یک عامل میانی یا پیشرفته ممکن است به تنظیمات و سفارشی‌سازی‌های خاص نماینده نیاز داشته باشد، از جمله فعال کردن ویژگی‌ها و APIها در کنسول Google Cloud.

    3. روی Import as agent کلیک کنید.

    برای ایجاد نماینده خود، مراحل زیر را دنبال کنید:

    1. روی ایجاد عامل کلیک کنید.
    2. برای ایجاد یک عامل ذخیره داده، Auto-generate را انتخاب کنید یا برای ایجاد انواع دیگر عوامل، Build your own را انتخاب کنید.

    برای بررسی دقیق فرآیند ساخت عامل، به ایجاد یک عامل Dialogflow CX مراجعه کنید.

  4. تنظیمات اصلی عامل را پیکربندی کنید:

    1. در نمایش نام ، یک نام نمایشی وارد کنید.
    2. مکان مورد نظر خود را انتخاب کنید. اگر می‌خواهید تنظیمات موقعیت مکانی پیشرفته را تغییر دهید، روی ویرایش کلیک کنید.
    3. منطقه زمانی مورد نظر خود را انتخاب کنید.
    4. زبان پیش فرض را برای نماینده خود انتخاب کنید. پس از ایجاد نمی‌توانید زبان پیش‌فرض یک نماینده را تغییر دهید.

  5. روی ایجاد کلیک کنید. Dialogflow CX شروع به ایجاد عامل می کند و سپس جریان شروع پیش فرض عامل را نمایش می دهد.

  6. به صورت اختیاری، عامل را سفارشی کنید. برای بررسی دقیق فرآیند سفارشی‌سازی عامل، به ایجاد یک عامل Dialogflow CX مراجعه کنید.

  7. به عنوان بهترین روش، عامل را آزمایش کنید:

    1. روی Test agent کلیک کنید.
    2. عامل تست در محیط را انتخاب کنید.
    3. در Environment، پیش نویس را انتخاب کنید.
    4. در Flow، Default Start Flow را انتخاب کنید.
    5. در Page، Start Page را انتخاب کنید.
    6. در نوار نوشتن گفتگو با عامل ، Hello تایپ کرده و Enter را فشار دهید. نماینده با معرفی خود پاسخ می دهد.
    7. با انجام نمونه مکالمه تستی تست را کامل کنید.

  8. عامل Dialogflow CX ایجاد می شود. به کنسول Dialogflow CX برگردید. منو > Dialogflow CX را کلیک کنید.

    به کنسول Dialogflow CX بروید

  9. در زیر نمایندگی ها ، روی > کپی نام کلیک کنید. این نام را همانطور که هنگام پیکربندی برنامه چت از آن استفاده می کنید، ذخیره کنید.

یک برنامه چت ایجاد کنید و آن را با عامل Dialogflow متصل کنید

پس از ایجاد یک عامل Dialogflow CX، این مراحل را دنبال کنید تا آن را به یک برنامه چت تبدیل کنید:

  1. در کنسول Google Cloud، به Google Chat API بروید. «Google Chat API» را جستجو کنید و روی Google Chat API کلیک کنید، سپس روی Manage کلیک کنید.

    به Chat API بروید

  2. روی Configuration کلیک کنید و برنامه Chat را راه اندازی کنید:

    1. در نام برنامه ، Dialogflow App وارد کنید.
    2. در URL آواتار ، https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png را وارد کنید.
    3. در توضیحات ، Responds to real human conversation را وارد کنید.
    4. در بخش عملکرد ، دریافت پیام های 1:1 و پیوستن به فضاها و مکالمات گروهی را انتخاب کنید.
    5. در قسمت تنظیمات اتصال ، Dialogflow را انتخاب کنید.
    6. در قسمت تنظیمات Dialogflow ، Dialogflow CX را انتخاب کنید.
    7. در نام منبع عامل یا محیط ، نام عامل Dialogflow CX را که کپی کرده اید در انتهای گزینه Create a Dialogflow CX agent قرار دهید.
    8. این برنامه چت را در دسترس افراد و گروه های خاصی در دامنه خود قرار دهید و آدرس ایمیل خود را وارد کنید.
    9. در زیر گزارش‌ها ، Log errors to Logging را انتخاب کنید.

  3. روی ذخیره کلیک کنید.

برنامه چت برای دریافت و پاسخ به پیام ها در چت آماده است.

برنامه چت را تست کنید

برنامه Dialogflow CX Chat را با ارسال پیام در Google Chat آزمایش کنید.

  1. Google Chat را با استفاده از حساب Google Workspace که هنگام اضافه کردن خود به عنوان آزمایش‌کننده معتمد ارائه کرده‌اید، باز کنید.

    به Google Chat بروید

  2. روی گپ جدید کلیک کنید.
  3. در قسمت افزودن 1 یا چند نفر ، نام برنامه چت خود را تایپ کنید.

  4. برنامه چت خود را از نتایج انتخاب کنید. یک پیام مستقیم باز می شود.

  5. در پیام مستقیم جدید با برنامه، Hello تایپ کرده و enter فشار دهید.

    برنامه Dialogflow Chat با معرفی خود پاسخ می دهد.

  6. با انجام نمونه مکالمه تستی تست را کامل کنید.

نمونه گفتگوی تستی

برای آزمایش برنامه Dialogflow CX Chat در کنسول Dialogflow CX یا در Google Chat، مکالمه زیر را انجام دهید. توضیح به شما کمک می‌کند بفهمید که چگونه عامل Dialogflow CX زبان طبیعی کاربر را تفسیر می‌کند و در هر مرحله از مکالمه پاسخ زبان طبیعی خود را تولید می‌کند. این نمونه مکالمه بر اساس نماینده از پیش ساخته شده به نام Travel: car rental است.

گفتگو توضیح
کاربر نهایی: سلام
نماینده: سلام! من نماینده اجاره ماشین مجازی هستم. من می توانم به شما کمک کنم تا یک رزرو کرایه ماشین جدید شروع کنید. امروز چگونه می توانم به شما کمک کنم؟
  1. مسیر پیش فرض خوش آمد گویی در جریان شروع پیش فرض نامیده می شود.
  2. تکمیل برای این کنترل کننده حالت ("سلام! من...") به صف پاسخ اضافه می شود.
  3. عامل، صف پاسخ را برای کاربر نهایی ارسال می کند.
کاربر نهایی: من می خواهم یک ماشین اجاره کنم.
نماینده: از کجا می خواهید وسیله نقلیه را تحویل بگیرید؟
  1. مسیر هدف car_rental.reservation_create در صفحه شروع مطابقت دارد.
  2. جلسه به صفحه Pickup Location منتقل می شود.
  3. فرم صفحه Pickup Location کامل نیست، بنابراین عامل از پارامتر pickup_location برای درخواست از کاربر ("Where want to pick up...") استفاده می کند که به صف پاسخ اضافه می شود.
  4. عامل، صف پاسخ را برای کاربر نهایی ارسال می کند.
کاربر نهایی: لاس وگاس
نماینده: باشه، پیکاپ شما در لاس وگاس خواهد بود.
نماینده: آیا محل تحویل شما با محل تحویل شما متفاوت است؟
  1. ورودی کاربر نهایی پارامتر pickup_location درخواست شده توسط نماینده در نوبت مکالمه قبلی را پر می کند.
  2. مسیر هدف car_rental.return_different_location در Default Start Flow مطابقت دارد.
  3. مسیر تکمیل فرم در صفحه Pickup Location ارزیابی و فراخوانی می شود. دارای یک تکمیل ("Ok, your pickup...")) که با ارجاع پارامترهای آن به مقادیر واقعی ارائه شده توسط کاربر نهایی، به صف پاسخ اضافه می شود.
  4. جلسه به صفحه تأیید مکان منتقل می شود.
  5. صفحه تأیید موقعیت مکانی دارای یک ورودی است ("آیا موقعیت مکانی شما متفاوت است...") که به صف پاسخ اضافه می شود.
  6. عامل، صف پاسخ را برای کاربر نهایی ارسال می کند.
کاربر نهایی: بله. من ماشین را در لس آنجلس پیاده خواهم کرد.
نماینده: باشه، تحویل شما در لس آنجلس خواهد بود.
نماینده: چه تاریخی و چه ساعتی دوست دارید وسیله نقلیه را تحویل بگیرید؟
  1. مسیر هدف car_rental.return_different_location در Default Start Flow مطابقت دارد.
  2. جلسه به صفحه Drop Off Location منتقل می شود.
  3. ورودی کاربر نهایی پارامتر drop_off_location درخواست شده توسط نماینده در نوبت مکالمه قبلی را پر می کند.
  4. مسیر تکمیل فرم در صفحه Drop Off Location ارزیابی و فراخوانی می شود. یک تکمیل دارد ("Ok, your drop off...") که به صف پاسخ اضافه می شود.
  5. جلسه به صفحه مدت اجاره منتقل می شود.
  6. صفحه مدت اجاره دارای مقادیر فرم ناقص است، بنابراین از کاربر می خواهد پارامتر pickup_date_time ("چه تاریخ و ساعتی را می خواهید انتخاب کنید...") که به صف پاسخ اضافه می شود.
  7. عامل، صف پاسخ را برای کاربر نهایی ارسال می کند.
کاربر نهایی: می‌خواهم ظهر 5 مارس ماشین را تحویل بگیرم.
نماینده: چه تاریخی و چه ساعتی دوست دارید وسیله نقلیه را پیاده کنید؟
  1. ورودی کاربر نهایی پارامتر pickup_date_time درخواست شده توسط نماینده در نوبت مکالمه قبلی را پر می کند.
  2. صفحه Rental Duration دارای مقدار فرم دیگری است که گم شده است، بنابراین از کاربر می خواهد پارامتر drop_off_date_time ("چه تاریخ و ساعتی را می خواهید رها کنید...") که به صف پاسخ اضافه می شود.
  3. عامل، صف پاسخ را برای کاربر نهایی ارسال می کند.
کاربر نهایی: 15 مارس در ظهر.
نماینده: پس برای تایید:

شما خودرو را در لاس وگاس 2024-03-05 ساعت 12:00:00 تحویل خواهید گرفت و آن را در لس آنجلس 2024-03-15 ساعت 12:00:00 تحویل خواهید داد.

آیا این درست به نظر می رسد؟
  1. ورودی کاربر نهایی پارامتر drop_off_date_time درخواست شده توسط نماینده در نوبت مکالمه قبلی را پر می کند.
  2. جلسه به صفحه تأیید مدت اجاره منتقل می شود.
  3. صفحه Confirm Rental Duration دارای یک ورودی است ("پس برای تایید...") که به صف پاسخ اضافه می شود.
  4. عامل، صف پاسخ را برای کاربر نهایی ارسال می کند.
کاربر نهایی: بله، متشکرم.
نماینده: عالی! حالا بیایید وسیله نقلیه را انتخاب کنیم.
نماینده: آیا یک وسیله نقلیه اقتصادی یا لوکس می خواهید؟
  1. مسیر قصد small_talk.confirmation.yes در صفحه تایید مدت اجاره مطابقت دارد.
  2. نماینده با یک پیام ("عالی! حالا بیایید انتخاب کنیم...") که به صف پاسخ اضافه می شود، انتخاب کاربر را تایید می کند.
  3. جلسه به صفحه ابهام‌زدایی خودرو منتقل می‌شود.
  4. فرم صفحه ابهام‌زدایی وسیله نقلیه کامل نیست، بنابراین عامل از پارامتر wesayît_type برای درخواست از کاربر استفاده می‌کند ("دوست دارید اقتصادی یا لوکس می‌خواهید...")، که به صف پاسخ اضافه می‌شود.
  5. عامل، صف پاسخ را برای کاربر نهایی ارسال می کند.
کاربر نهایی: اقتصادی، لطفا.
نماینده: ماشین سنج را دوست دارید یا کامیون سنج؟
  1. مسیر هدف $session.params.vehicle_type="economy_vehicle" مطابقت دارد.
  2. جلسه به صفحه گزینه های اقتصادی منتقل می شود.
  3. صفحه گزینه های اقتصادی دارای یک تکمیل ورودی است ("Would you like the...") که به صف پاسخ اضافه می شود.
  4. عامل، صف پاسخ را برای کاربر نهایی ارسال می کند.
کاربر نهایی: کامیون سنج.
نماینده: کامیون Cymbal 50.33 دلار در روز است. برای 4 نفر مناسب است و دارای رادیو AM/FM است. آیا می خواهید به پرداخت ادامه دهید؟
کاربر نهایی: بله، لطفا.
  1. مسیر هدف $session.params.vehicle_type="Cymbal Truck" مطابقت داده می شود و پارامتر automjet_model پر می شود.
  2. جلسه به صفحه Confirm Cymbal Truck منتقل می شود.
  3. صفحه Confirm Cymbal Truck دارای یک ورودی است ("Cymbal Truck 50.33 دلار در روز است...")، که به صف پاسخ اضافه می شود.
  4. عامل، صف پاسخ را برای کاربر نهایی ارسال می کند.
  5. پاسخ کاربر با مسیر small_talk.confirmation.yes مطابقت دارد.
نماینده: از چه نوع کارتی استفاده خواهید کرد؟
کاربر نهایی: Altostrat
نماینده: لطفا شماره کارت را وارد کنید.
کاربر نهایی: 1234 1234 1234 1234
نماینده: اسم کارت چیه؟
کاربر نهایی: چارلی
نماینده: آدرس خیابان قبض چیست؟
کاربر نهایی: بلوار دوزیستان 1800 Mountain View, CA
نماینده: کد پستی صورتحساب چیست؟
کاربر نهایی: 94045
نماینده: شما در لاس وگاس، 2024-03-05 ساعت 12:00:00، ماشین سنج را در لاس وگاس می گیرید و آن را تحویل می گیرید، 15-03-2024 ساعت 12:00:00. مجموع این سفر 175.38 دلار خواهد بود.
نماینده: از اینکه با ما اجاره کردید متشکرم و روز فوق العاده ای داشته باشید!
  1. جلسه به صفحه پرداخت منتقل می شود.
  2. فرم پرداخت کامل نیست، بنابراین نماینده پارامترهای card_type ، card_number ، billing_name ، billing_street_address و billing_zip_code را از کاربر می‌خواهد که به‌طور متوالی به صف پاسخ اضافه می‌شوند و به‌عنوان کاربر ارسال می‌شوند. پاسخ می دهد. پاسخ های کاربر مقدار هر پارامتر را تنظیم می کند.
  3. جلسه به صفحه تأیید اجاره منتقل می شود.
  4. صفحه تأیید اجاره دارای یک تکمیل ورودی است ("Ok, your pickup will be...") که به صف پاسخ اضافه می شود.
  5. عامل، صف پاسخ را برای کاربر نهایی ارسال می کند.
  6. جلسه به صفحه پایان جلسه منتقل می شود.

ارسال پیام های کارت از Dialogflow

Dialogflow می تواند با پیام های متنی یا کارتی پاسخ دهد. برای پاسخ دادن با پیام کارت، آن را به عنوان یک بار سفارشی در حال تکمیل مشخص کنید.

JSON زیر نحوه ارسال پیام کارت به عنوان بار سفارشی را نشان می دهد:

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'
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

محدودیت ها و ملاحظات

  • رویدادهای تعامل گپ دارای پشتیبانی محدود و برخی ملاحظات هستند:
    • انواع رویدادهای تعامل زیر پشتیبانی می شوند:
      • MESSAGE
      • ADDED_TO_SPACE
      • CARD_CLICKED
    • برای رویدادهای MESSAGE یا ADDED_TO_SPACE ، ورودی درخواست ارسال شده به عامل Dialogflow با مقدار فیلد argumentText در پیام چت مطابقت دارد. اگر پیام حاوی دستور اسلش باشد، به جای آن از مقدار فیلد text استفاده می شود.
    • برای رویدادهای CARD_CLICKED ، ورودی درخواست ارسال شده به عامل Dialogflow به صورت CARD_CLICKED.functionName قالب‌بندی می‌شود، جایی که functionName با مقدار function شی Action متصل به عنصر کارت تعاملی (مانند یک دکمه) مطابقت دارد.
    • بار کامل JSON هر رویداد تعامل Chat به عنوان یک بار سفارشی در پارامتر query به Dialogflow ارسال می‌شود و می‌توان با جستجوی مقدار فیلد WebhookRequest.payload با یک webhook Dialogflow به آن دسترسی داشت.
  • ملاحظات مربوط به پاسخ به دستورات اسلش و دریافت داده ها از کارت ها یا دیالوگ ها :
    • وقتی برنامه‌های گفتگوی Dialogflow پیامی با دستور اسلش دریافت می‌کنند، ورودی پرس و جو فقط حاوی مقدار فیلد text است. فیلد text با نام دستور اسلش شروع می شود (به عنوان مثال، /command )، که می توانید از آن برای پیکربندی هدف عامل Dialogflow برای تشخیص یک دستور اسلش استفاده کنید.
    • اگر عامل Dialogflow نیاز به پردازش رویداد تعامل Chat محموله JSON داشته باشد، می‌تواند این کار را با استفاده از webhook Dialogflow برای بررسی بار سفارشی در پارامتر پرس و جو انجام دهد.
    • برای نمایش یک گفتگو از Dialogflow Agent، با یک بار JSON سفارشی که شامل پیامی حاوی پاسخ اقدام DIALOG است، پاسخ دهید.
    • برای پردازش داده‌های وارد شده از کارت‌ها، عامل Dialogflow می‌تواند مقاصدی را شناسایی کند که با متن CARD_CLICKED شروع می‌شوند و با یک بار JSON سفارشی حاوی عملکرد مناسب پاسخ می‌دهند.
  • پیش نمایش پیوندها پشتیبانی نمی شود.
  • اگر عامل Dialogflow فقط با یک پیام پاسخ دهد، پیام به طور همزمان به چت Google ارسال می شود. اگر عامل Dialogflow با پیام‌های متعدد پاسخ دهد، با فراخوانی متد create در منبع spaces.messages در Chat API یک بار برای هر پیام، همه پیام‌ها به طور ناهمزمان به Chat ارسال می‌شوند.
  • هنگام استفاده از ادغام Dialogflow CX با Chat، عامل Dialogflow و برنامه Chat باید در همان پروژه Google Cloud راه‌اندازی شوند. اگر نیاز به راه‌اندازی Dialogflow و Chat در پروژه‌های Cloud مختلف دارید، می‌توانید یک سرور میانی برای تسهیل اتصال راه‌اندازی کنید. برای یادگیری نحوه انجام این کار، به مثال ادغام Chat برای Dialogflow CX در GitHub مراجعه کنید.

عیب یابی

وقتی یک برنامه یا کارت Google Chat خطایی را برمی‌گرداند، رابط Chat پیامی را نشان می‌دهد که می‌گوید «مشکلی پیش آمده است». یا "نمی توان به درخواست شما رسیدگی کرد." گاهی اوقات Chat UI هیچ پیام خطایی را نمایش نمی دهد، اما برنامه یا کارت Chat نتیجه غیرمنتظره ای ایجاد می کند. برای مثال، ممکن است پیام کارت ظاهر نشود.

اگرچه ممکن است پیام خطا در رابط کاربری گپ نمایش داده نشود، پیام‌های خطای توصیفی و داده‌های گزارش در دسترس هستند تا به شما کمک کنند هنگام فعال بودن ثبت خطا برای برنامه‌های گپ، خطاها را برطرف کنید. برای راهنمایی برای مشاهده، اشکال‌زدایی و رفع خطاها، به عیب‌یابی و رفع خطاهای Google Chat مراجعه کنید.

تمیز کردن

برای جلوگیری از تحمیل هزینه به حساب Google Cloud خود برای منابع استفاده شده در این آموزش، توصیه می کنیم پروژه Cloud را حذف کنید.

  1. در کنسول Google Cloud، به صفحه مدیریت منابع بروید. > IAM & Admin > Manage Resources کلیک کنید.

    به Resource Manager بروید

  2. در لیست پروژه، پروژه ای را که می خواهید حذف کنید انتخاب کنید و سپس روی حذف کلیک کنید.
  3. در گفتگو، ID پروژه را تایپ کنید و سپس بر روی Shut down کلیک کنید تا پروژه حذف شود.
  • Dialogflow CX یک رویکرد ماشین حالت برای طراحی عامل Dialogflow دارد که به شما کنترل واضح و صریح روی مکالمه، تجربه کاربر نهایی بهتر و گردش کار توسعه بهتر را می دهد. هنگام ساخت یک برنامه Dialogflow Chat، توصیه می کنیم از Dialogflow CX استفاده کنید.
    • برای کسب اطلاعات بیشتر در مورد ساخت و پیکربندی عوامل، به Dialogflow CX Agents مراجعه کنید.
    • برای راهنمایی دقیق در مورد نحوه ساخت و پیکربندی عوامل، به ایجاد یک عامل Dialogflow CX مراجعه کنید.
    • Codelab: برای مثالی از نحوه ایجاد یک عامل ذخیره داده Dialogflow CX، به برنامه Chat دانش از codelab Build apps for Google Chat with Gemini مراجعه کنید.
    • Codelab: برای مثالی از نحوه ایجاد یک عامل مکالمه Dialogflow CX، به برنامه بازخورد Chat از codelab Build apps for Google Chat with Gemini مراجعه کنید.
  • Dialogflow ES روش دیگری برای استفاده از Dialogflow با برنامه Chat است.