ساختن برنامه تعاملی Google Chat

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

برنامه‌های Chat تعاملی به کاربران امکان می‌دهد هریک از موارد زیر را انجام دهند:

نحوه کشف و استفاده کاربران از برنامه‌های تعاملی Chat

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

  • برنامه‌های Chat را از Google Chat یا Marketplace جستجو و نصب کنید.
  • با برنامه Chat که به فضای Chat اضافه شده است تعامل برقرار کنید.
  • برنامه Chat را در پانل پیام‌های مستقیم خود پس‌از اینکه سرپرست Google Workspace برنامه Chat را ازطرف آن‌ها نصب کرد کشف کنند.

برای شروع استفاده از برنامه Chat، کاربران Google Chat می‌توانند پیام مستقیمی را با برنامه Chat شروع کنند یا آن را به فضایی اضافه کنند. کاربران همچنین می‌توانند با @نامبری کردن برنامه Chat، آن را اضافه کنند. برای کسب اطلاعات بیشتر، به استفاده از برنامه‌های Chat مراجعه کنید.

مثال زیر نشان می‌دهد که چگونه کاربر از برنامه Chat @نام می‌برد تا آن را به فضا اضافه کند:

افزودن برنامه Chat به فضا با تایپ کردن @ در پیام.

شروع کنید

برای شروع ساختن برنامه تعاملی Chat، مستندات زیر را ببینید:

پیکربندی و ایجاد برنامه Chat پایه

جدول زیر فهرست اسناد مربوط به پیکربندی Chat API و ایجاد برنامه تعاملی Chat پایه را برای هریک از معماری‌های برنامه Google Chat ارائه می‌دهد:

معماری یا تکلیف راهنما
پیکربندی Chat API پیکربندی Google Chat API
شروع سریع
Apps Script ساختن برنامه Chat با Apps Script
سرویس HTTP (توابع Cloud Run) ساختن برنامه گپ HTTP
Pub/Sub ساختن برنامه Chat با Pub/Sub
Dialogflow CX ساختن برنامه گپ Dialogflow CX
Dialogflow ES ساختن برنامه گپ Dialogflow ES
عامل هوش مصنوعی Agent Development Kit (ADK) ساختن برنامه گپ عامل هوش مصنوعی ADK
عامل هوش مصنوعی Agent2Agent (A2A) ساختن برنامه Chat عامل هوش مصنوعی A2A
عامل هوشواره‌ای A2UI ساختن برنامه Chat عامل هوش مصنوعی A2UI
عامل هوش مصنوعی Gemini Enterprise ساختن برنامه گپ عامل هوش مصنوعی Gemini Enterprise

ساختن ویژگی‌های تعاملی

جدول زیر مستندات مربوط به ساختن ویژگی‌های تعاملی برنامه Chat را نشان می‌دهد:

ویژگی راهنما
دریافت و پاسخ دادن به تعاملات کاربر دریافت و پاسخ به تعاملات کاربر
ارسال پیام (پاسخ به تعاملات یا ارسال پیش‌دستانه) با پیامی پاسخ دهید یا بااستفاده از Chat API پیامی ارسال کنید
پاسخ دادن به فرمان‌های خط مورب، فرمان‌های سریع، و کنش‌های پیام پاسخ دادن به فرمان‌ها
ساختن کادرهای گفتگوی تعاملی باز کردن کادرهای گفتگوی تعاملی
جمع‌آوری و پردازش اطلاعات از کارت‌ها و چارگوش‌های گفتگو خواندن داده‌های فرم واردشده توسط کاربران در کارت‌ها
پیش‌نمایش پیوندها در پیام‌های Chat پیش‌نمایش پیوندها
ساختن صفحه اصلی (صفحه اصلی برنامه) در پیام‌های مستقیم یک‌به‌یک ساختن صفحه اصلی برای برنامه Chat
اتصال به سیستم‌ها و ابزارهای خارجی اتصال برنامه Chat به سرویس‌ها و ابزارهای دیگر

محدودیت‌ها و ملاحظات مربوط به برافزاهای Google Workspace

ازآنجایی‌که برنامه‌های Chat به‌عنوان برافزاهای Google Workspace ساخته شده‌اند که Chat را گسترش می‌دهند، محدودیت‌های ویژگی زیر را درنظر داشته باشید:

  • AppSheet معماری برنامه گپ هنگام ساختن به‌عنوان برافزای Google Workspace دردسترس نیست. به‌جای آن، برنامه Chat را بااستفاده از خدمات HTTP، Apps Script، Dialogflow ES، Dialogflow CX، یا Pub/Sub بسازید.
  • کارت‌های مجوز سفارشی در Chat پشتیبانی نمی‌شود. برای اصالت‌سنجی و اعطای مجوز به سرویس از Chat، برنامه Chat باید کارت مجوز پایه را برگرداند.
  • صفحه‌های اصلی برافزا در نوار کناری Chat پشتیبانی نمی‌شوند. اگر در مانیفست خود (addons.common.homepageTrigger) یک راه‌انداز صفحه اصلی پیکربندی کرده باشید، صفحه اصلی فقط در نوار کناری سایر برنامه‌های Google Workspace که برافزایتان آن‌ها را گسترش می‌دهد ظاهر می‌شود. درعوض، می‌توانید صفحه اصلی برای برنامه Chat بسازید که در برگه صفحه اصلی پیام‌های مستقیم یک‌به‌یک با برنامه Chat نشان داده می‌شود.

اگر می‌خواهید برافزای Google Workspace موجودی را گسترش دهید تا در Chat کار کند، ملزومات پیکربندی برنامه‌های Chat را درنظر بگیرید:

  • تنظیمات نصب Google Workspace Marketplace باید به افراد و سرپرستان Google Workspace اجازه دهد برافزا را نصب کنند.
  • هرگونه تنظیمات پیکربندی مشترک در مانیفست برافزا (addons.common) در Chat نادیده گرفته می‌شود. برای پیکربندی برافزا به‌منظور کار در Chat، باید «میانای برنامه‌سازی کاربردی Chat» را فعال و پیکربندی کنید. برای مراحل، به پیکربندی Google Chat API مراجعه کنید.
  • برای پیاده‌سازی و آزمایش کردن برافزایی در Chat، باید از تنظیم رؤیت‌پذیری Chat API استفاده کنید. هرگونه تنظیمات رؤیت‌پذیری یا آزمایش که در Google Workspace Marketplace SDK پیکربندی کرده‌اید نادیده گرفته می‌شود. برای استقرار نسخه آزمایشی برافزا در Chat، به آزمایش ویژگی‌های تعاملی برای برنامه‌های Google Chat مراجعه کنید.
  • اگر برافزای شما در «بازار کار Google Workspace» منتشر شده باشد، نمی‌توانید پیش‌نویس هیچ تغییری را در تنظیمات پیکربندی Google Chat API ذخیره کنید. وقتی تنظیمات پیکربندی Chat API را به‌روزرسانی می‌کنید، برنامه Chat به‌روزرسانی‌شده بلافاصله برای همه کاربران موجود دردسترس قرار می‌گیرد. برای به‌روزرسانی فهرستگان «بازار»، می‌توانید پیش‌از ارسال هرگونه تغییر، پیش‌نویسی ایجاد کنید.

برنامه‌های Chat که برافزا نیستند: ساختن برنامه تعاملی Google Chat

برنامه‌های گپی که برافزاهای Google Workspace نیستند به‌عنوان برنامه‌های فقط Chat ساخته می‌شوند که رویدادهای تعامل Chat API (Event) را به‌جای کنش‌ها و اشیای رویداد برافزای Google Workspace (EventObject) دریافت می‌کنند.

اگر برنامه Chat را که برافزا نیست نگهداری می‌کنید، می‌توانید:

  • برنامه Chat خود را که برافزا نیست به برافزای Google Workspace تبدیل کنید که Google Chat را گسترش می‌دهد. به تبدیل برنامه Google Chat به برافزای Google Workspace مراجعه کنید.
  • برای قالب‌های درخواست و پاسخ، به بخش‌های ازهم بازشدنی برنامه‌های Chat که برافزا نیستند در پایین هر راهنمای ویژگی تعاملی در این مجموعه اسناد مراجعه کنید.