این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

با Gemini برنامه هایی برای چت گوگل بسازید

۱. قبل از شروع

برنامه‌های چت گوگل با جمینی چیست؟

برنامه‌های چت گوگل با Gemini موارد زیر را انجام می‌دهند:

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

چرا برنامه‌های گوگل چت را با Gemini ادغام کنیم؟

موارد استفاده معمول مدل‌های هوش مصنوعی مولد مانند Gemini در دسته‌های زیر قرار می‌گیرند:

تولید و بهبود محتوا . تولید محتوای بازاریابی، ساخت پست‌های رسانه‌های اجتماعی، خلق تصاویر واقع‌گرایانه، آهنگسازی موسیقی یا کمک به تولید محتوای ویدیویی.
جستجوی داده‌ها . استخراج بینش‌های کلیدی از یک پایگاه دانش بدون ساختار، خلاصه‌سازی متون طولانی، طبقه‌بندی محتوا یا ترجمه زبان‌ها با دقت و سرعت بیشتر.
مکالمه . در مکالمات طبیعی، آموزنده و خلاقانه شرکت کنید.

امکان ادغام مستقیم این قابلیت‌ها در رابط کاربری آشنای گوگل چت، فرصت بزرگی برای هر کسی است که می‌خواهد تجربه و بهره‌وری کاربران خود را بهبود بخشد.

پیش‌نیازها

دانش اولیه در مورد Apps Script ، Google Cloud و Node.js.
آشنایی اولیه با مفاهیم گوگل چت ، شامل مدیریت رویدادها ، دستورات اسلش ، دیالوگ‌ها ، کارت‌ها ، پیام‌ها ، احراز هویت برنامه و APIها .

آنچه می‌سازید

در این آزمایشگاه کد، شما سه برنامه گوگل چت با Gemini می‌سازید تا سه مورد استفاده معرفی شده در بخش قبلی را پوشش دهید.

اپلیکیشن مدیریت مشکلات (ایجاد و بهبود محتوا)

این برنامه موارد زیر را انجام می‌دهد:

مشکلات را از ایجاد تا بسته شدن با تعاملات اولیه، صفحه اصلی برنامه و احراز هویت برنامه مدیریت می‌کند.
پیام‌ها را رصد می‌کند و در مورد رویدادها و ویجت‌های جانبی، کمک‌های جامع ارائه می‌دهد.

شما از Gemini برای انجام موارد زیر استفاده می‌کنید:

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

فناوری‌های اصلی مورد استفاده عبارتند از Vertex AI، Gemini، Apps Script و APIهای Google Workspace (مدیر، چت، اسناد، رویدادها).

۲۲efdecff4601417.png

اپلیکیشن دانش (جستجوی داده‌ها)

این برنامه برای درک و پاسخ به سوالات به زبان طبیعی و بازگرداندن منابع از داده‌های بدون ساختار، به Gemini متکی است.

فناوری‌های اصلی مورد استفاده عبارتند از عامل ذخیره داده Dialogflow CX، وب‌هوک Dialogflow CX، توابع Google Cloud و Gemini.

۹۴۶۸۸۶۶bfe۸۴۸bb۸.png

برنامه بازخورد (گفتگو)

این برنامه برای جمع‌آوری و ذخیره نظرات به همراه مکالمات به زبان طبیعی، به Gemini متکی است.

فناوری‌های اصلی مورد استفاده عبارتند از عامل Dialogflow CX، ابزار Dialogflow CX، OpenAPI، توابع Google Cloud و Gemini.

آنچه یاد می‌گیرید

نحوه ادغام برنامه‌های گوگل چت با Gemini از طریق Vertex AI.
نحوه ادغام برنامه‌های گوگل چت با عوامل تجربه مشتری Dialogflow.
نحوه استفاده از جدیدترین ویژگی‌های گوگل چت: صفحه اصلی برنامه، رویدادهای گوگل چت و ابزارک‌های جانبی.

آنچه شما نیاز دارید

تکمیل شروع سریع ساخت یک برنامه چت گوگل با Apps Script . این آزمایشگاه کد بر اساس پروژه Apps Script و Google Cloud حاصل شده ساخته شده است.

۲. آماده شوید

مقداردهی اولیه منابع

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

پروژه اسکریپت برنامه‌ها

در کنسول Apps Script ، مراحل زیر را دنبال کنید:

روی تنظیمات کلیک کنید و سپس API اسکریپت Google Apps را فعال کنید.

پروژه خود را انتخاب کنید.
روی تنظیمات پروژه کلیک کنید.
کادر انتخاب نمایش فایل مانیفست « appsscript.json » در ویرایشگر را علامت بزنید .
نام پروژه را به Chat Apps Gemini تغییر دهید.

پروژه گوگل کلود

در کنسول گوگل کلود ، مراحل زیر را دنبال کنید:

پروژه خود را انتخاب کنید.
روی منو ☰ > APIها و خدمات > صفحه رضایت OAuth > ویرایش برنامه کلیک کنید و سپس نام برنامه را روی Chat Apps Gemini تنظیم کنید.

به پیکربندی Google Chat API بروید و سپس نام و توضیحات برنامه را روی Chat Apps Gemini تنظیم کنید.

گوگل چت

در گوگل چت ، مراحل زیر را دنبال کنید:

در صورت لزوم، با برنامه Google Chat خود چت را شروع کنید.
برای اطمینان از کارکرد آن، پیامی مانند Hello ارسال کنید.

۹۶۲۵۴۱۸۲۵۱۵۲٨ae9.png

دانلود کد منبع و منابع به صورت محلی

این مخزن گیت‌هاب را دانلود کنید.

در محیط توسعه‌ی دلخواه خود، پوشه‌ی apps-script را باز کنید و سپس در ترمینال خود به همان پوشه بروید.

نصب و پیکربندی `clasp`

ما clasp برای ویرایش و انتقال آسان نسخه‌های کد منبع از محیط محلی به پروژه Apps Script استفاده می‌کنیم.

در محیط محلی خود، آخرین نسخه‌های node ، npm و clasp را نصب کنید .

npm install -g @google/clasp

با حساب کاربری خود وارد شوید :

clasp login

در صورت موفقیت، یک صفحه تأیید اولیه در مرورگر وب خود مشاهده می‌کنید و فایل .clasprc.json حاوی اطلاعات کاربری کلاینت شما به‌روزرسانی می‌شود. می‌توانید محل قرارگیری آن را در ترمینال خود پیدا کنید.

۳. برنامه ۱: ساخت

مفاهیم را مرور کنید

هوش مصنوعی ورتکس

ورتکس ای‌آی هر آنچه را که برای ساخت و استفاده از هوش مصنوعی مولد نیاز دارید، از جمله راهکارهای هوش مصنوعی، سازنده عامل، بیش از ۱۳۰ مدل پایه و یک پلتفرم هوش مصنوعی یکپارچه، ارائه می‌دهد.

جوزا

Gemini یک دوره کارشناسی ارشد مدیریت چندوجهی از گوگل است که از طریق Vertex AI قابل دسترسی است. این دوره به افراد کمک می‌کند تا پتانسیل انسانی خود را شکوفا کنند تا بتوانند تخیل خود را تقویت کنند، کنجکاوی خود را گسترش دهند و بهره‌وری خود را افزایش دهند.

سرویس چت پیشرفته

سرویس چت پیشرفته به شما امکان می‌دهد از API چت گوگل در Apps Script استفاده کنید. این به اسکریپت‌ها اجازه می‌دهد فضاهای چت را پیدا، ایجاد و تغییر دهند، اعضا را به فضاها اضافه یا حذف کنند و پیام‌های حاوی متن، کارت، پیوست و واکنش را بخوانند یا ارسال کنند.

بررسی معماری

این برنامه‌ی چت گوگل با استفاده از Apps Script ساخته شده است و به شرح زیر عمل می‌کند:

کاربر پیامی را به برنامه ارسال می‌کند، چه از طریق پیام مستقیم و چه از طریق یک فضای خالی.
این برنامه که در یک پروژه Apps Script پیاده‌سازی شده و با یک پروژه Google Cloud مرتبط است، پیام را پردازش می‌کند.
این برنامه با APIهای Google Docs و Google Chat ادغام می‌شود.
این برنامه از سرویس Properties برای ذخیره داده‌ها در ویژگی‌های اسکریپت استفاده می‌کند.
برنامه یک پاسخ همزمان، چه در یک پیام مستقیم و چه در فضای اصلی، ارسال می‌کند.

جریان‌های بررسی

ایجاد مسئله

عیب‌یابی مشکل از فضای اختصاصی

بستن مشکل از فضای اختصاصی

بررسی کد منبع

پروژه Apps Script شامل اسکریپت‌های زیر است:

Configuration : ثابت‌هایی که باید بر اساس محیط ویرایش شوند.
ChatApp : رویدادهای تعاملی Google Chat، از جمله پیام‌ها، کلیک‌های کارت، دستورات اسلش و دیالوگ‌ها را مدیریت می‌کند.
Storage : توابع کاربردی که به سرویس‌های Properties متکی هستند.
ChatAppAuth : توابع کاربردی که به احراز هویت برنامه Google Chat متکی هستند.
Docs : توابع کاربردی که به اسناد گوگل متکی هستند.
VertexAi : توابع کاربردی که به Vertex AI متکی هستند.

و در اینجا بخش‌هایی وجود دارد که به طور فعال هنگام تولید اسناد گزارش با Gemini و تاریخچه‌های فضای چت استفاده می‌شوند:

appsscript.json

// Enables the Admin SDK Directory and Chat services, which you need to retrieve
// messages and usernames.

"enabledAdvancedServices": [
  ...
  {
    "userSymbol": "AdminDirectory",
    "version": "directory_v1",
    "serviceId": "admin"
  },
  {
    "userSymbol": "Chat",
    "version": "v1",
    "serviceId": "chat"
  }
  ...
]

// Includes the OAuth scopes to request the Admin SDK Directory, Google Chat,
// Google Docs, and Vertex AI APIs.

"oauthScopes": [
  ...
  "https://www.googleapis.com/auth/admin.directory.user.readonly",
  "https://www.googleapis.com/auth/chat.messages.readonly",
  "https://www.googleapis.com/auth/documents",
  "https://www.googleapis.com/auth/cloud-platform",
  ...
]

پیکربندی.js

// Relies on two constants: the first one is the Google Cloud project ID and the
// second one is the Vertex AI location to be used.

...
const PROJECT_ID = 'replace-with-gcp-project-id';
const VERTEX_AI_LOCATION_ID = 'us-central1';
...

ChatApp.js

// The slash command process function retrieves history, generates content, and passes
// it to the report generator.

function processSlashCommand(event) {
  ...
  if (event.message.slashCommand.commandId == CLOSE_COMMAND_ID
    && event.message.space.type !== "DM") {
    ...
    const history = exportSpaceHistory(spaceId);
    const summary = summarizeSpace(history);
    const docUrl = createReport(
      issue.title, issue.description, resolution, history, summary
    );
    ...
  }
  ...
}

/**
 * Fetches and concatenates the 100 first space messages by using the Google Chat API.
 *
 * Messages with slash commands are filtered (app command invocations).
 *
 * @return {string} concatenate space messages in the format "Sender's name: Message"
 */
function exportSpaceHistory(spaceName) {
  const messages = Chat.Spaces.Messages.list(spaceName, { 'pageSize': 100 }).messages;
  // Returns results after fetching message sender display names.
  let users = new Map();
  return messages
    .filter(message => message.slashCommand === undefined)
    .map(message =>
      `${getUserDisplayName(users, message.sender.name)}: ${message.text}`
    ).join('\n');
}

/**
 * Fetches a user's display name by using the Admin Directory API.
 *
 * A cache is used to only call the API once per user.
 *
 * @param {Map} cache the map containing users previously fetched
 * @param {string} userId the user ID to fetch
 * @return {string} the user's display name
 */
function getUserDisplayName(cache, userId) {
  if (cache.has(userId)) {
    return cache.get(userId);
  }
  let displayName = 'Unknown User';
  try {
    const user = AdminDirectory.Users.get(
      userId.replace("users/", ""),
      { projection: 'BASIC', viewType: 'domain_public' });
    displayName = user.name.displayName ? user.name.displayName : user.name.fullName;
  } catch (e) {
    // Ignores errors, uses 'Unknown User' by default.
  }
  cache.set(userId, displayName);
  return displayName;
}

VertexAi.js

/**
 * Summarizes a Google Chat space history with the Gemini Pro model using
 * Vertex AI API.
 *
 * @param {string} history the history
 * @return {string} the summary
 */
function summarizeSpace(history) {
  const url = `https://${VERTEX_AI_LOCATION_ID}-aiplatform.googleapis.com/v1`
    + `/projects/${PROJECT_ID}/locations/${VERTEX_AI_LOCATION_ID}`
    + "/publishers/google/models/gemini-1.0-pro:generateContent";
  const options = {
    method: "POST",
    headers: { Authorization: "Bearer " + ScriptApp.getOAuthToken() },
    contentType: "application/json",
    payload: JSON.stringify({
      contents: {
        role: "user",
        parts: {
          text: "Summarize the following conversation between engineers resolving"
              + " an issue in a few sentences.\n\n" + history
        }
      },
      safetySettings: {
        category: "HARM_CATEGORY_SEXUALLY_EXPLICIT",
        threshold: "BLOCK_LOW_AND_ABOVE"
      },
      generationConfig: {
        temperature: 0.2,
        topP: 0.8,
        topK: 40
      }
    })
  };

  return JSON.parse(UrlFetchApp.fetch(url, options).getContentText())
    .candidates[0].content.parts[0].text;
}

اسناد.js

// The report generator function adds two sections: the first one is for the summary and the second one is for history.
function createReport(..., history, summary) {
  ...
  body.appendParagraph("Summary").setHeading(DocumentApp.ParagraphHeading.HEADING1);
  body.appendParagraph(summary);
  body.appendParagraph("History").setHeading(DocumentApp.ParagraphHeading.HEADING1);
  body.appendParagraph(history);
  ...
}

به‌روزرسانی پروژه گوگل کلود

فعال کردن APIها

در کنسول Google Cloud ، رابط‌های برنامه‌نویسی کاربردی Google Docs ، Google Admin SDK و Vertex AI را فعال کنید:

روی منو ☰ > APIها و خدمات > APIها و خدمات فعال‌شده کلیک کنید و سپس تأیید کنید که APIها فعال شده‌اند.

شروع حساب کاربری سرویس

در کنسول گوگل کلود ، مراحل زیر را دنبال کنید:

روی منو ☰ > مدیریت و دسترسی > حساب‌های سرویس > + ایجاد حساب سرویس کلیک کنید.

نام حساب سرویس را روی chat-app تنظیم کنید.
توضیحات حساب سرویس را روی Chat app auth تنظیم کنید.
روی ایجاد کلیک کنید و ادامه دهید .
روی «انجام شد» کلیک کنید. شما به صفحه حساب‌های سرویس هدایت می‌شوید و می‌توانید حساب سرویسی را که ایجاد کرده‌اید مشاهده کنید.

حساب سرویس تازه ایجاد شده را انتخاب کنید.
برگه کلیدها را انتخاب کنید.
روی افزودن کلید کلیک کنید.
روی ایجاد کلید جدید کلیک کنید.
JSON را انتخاب کنید.
روی ایجاد کلیک کنید.

پنجره بسته می‌شود و جفت کلید عمومی/خصوصی جدید ایجاد شده شما به طور خودکار به عنوان یک فایل JSON در محیط محلی شما دانلود می‌شود. می‌توانید بعداً هنگام ویرایش کد منبع پروژه Apps Script خود از محتوای آن استفاده کنید.

پیکربندی API چت گوگل را به‌روزرسانی کنید

در کنسول گوگل کلود ، مراحل زیر را دنبال کنید:

یک دستور اسلش اضافه کنید.
نام را روی /create تنظیم کنید.
شناسه فرمان را روی 1 تنظیم کنید.
توضیحات را روی Create a new issue تنظیم کنید.
کادر انتخاب «باز کردن یک کادر محاوره‌ای» را علامت بزنید.
یک دستور اسلش دیگر اضافه کنید.
نام را روی /close تنظیم کنید.
شناسه فرمان را روی 2 تنظیم کنید.
تنظیم توضیحات برای Close an issue .
روی ذخیره کلیک کنید.

پروژه اسکریپت برنامه‌ها را به‌روزرسانی کنید

دایرکتوری فعلی در ترمینال محلی خود را به issue-management/1-baseline تغییر دهید. این دایرکتوری شامل کد منبع است. قبل از ارسال کد منبع به پروژه Apps Script خود، باید چند مورد را پیکربندی کنید.

پیکربندی کد منبع

ثابت JSON با نام CHAT_CREDENTIALS را در فایل Configuration.js روی محتوای فایل کلید خصوصی که قبلاً دانلود کرده‌اید، تنظیم کنید.

در کنسول گوگل کلود ، روی منو ☰ > مدیریت و دسترسی > تنظیمات کلیک کنید.

شناسه پروژه را کپی کنید.

۸۲۵۹۲fa0bd113469.png

ثابت رشته‌ای با نام PROJECT_ID را در فایل Configuration.js برابر با شناسه پروژه تنظیم کنید.

تنظیمات `clasp` را پیکربندی کنید

برای تنظیم اولیه تنظیمات clasp جهت انتقال کد منبع به پروژه Apps Script مناسب، این مراحل را دنبال کنید:

در کنسول Apps Script ، پروژه خود را انتخاب کنید.
تنظیمات پروژه را انتخاب کنید.
در بخش شناسه‌ها ، روی کپی کلیک کنید.

در دایرکتوری فعلی، یک فایل .clasp.json ایجاد کنید.
<your-script-id> با شناسه کپی شده جایگزین کنید.
نتیجه را در فایل .clasp.json کپی کنید.
فایل .clasp.json را ذخیره کنید.

{
  "scriptId": "<your-script-id>"
}

کد منبع را فشار دهید

دستور زیر را اجرا کنید:

$clasp push
? Manifest file has been updated. Do you want to push and overwrite? Yes
└─ appsscript.json
└─ ChatApp.js
└─ ChatAppAuth.js
└─ Configuration.js
└─ Docs.js
└─ Storage.js
└─ VertexAi.js
Pushed 7 files.

امتحانش کن

در گوگل چت ، در یک پیام مستقیم به برنامه، Hello! را ارسال کنید. برنامه پاسخی نمی‌دهد، اما پیامی ظاهر می‌شود که تنظیمات را درخواست می‌کند.

روی پیکربندی کلیک کنید.
حساب گوگل خود را انتخاب کنید.
احراز هویت کنید.
بررسی کنید و اجازه دسترسی به برنامه را بدهید.

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

یک پیام مستقیم دیگر به برنامه ارسال کنید، اما با دستور اسلش /create .

در کادر محاوره‌ای، عنوان را روی Issue Title 1 تنظیم کنید.
شرح را روی Description 1 تنظیم کنید.
روی ایجاد کلیک کنید.

۲۲efdecff4601417.png

برنامه موارد زیر را انجام می‌دهد:

کادر محاوره‌ای را می‌بندد.
فضایی را به شماره جدید ایجاد شده با همین عنوان اختصاص می‌دهد.
به فضای تازه ایجاد شده می‌پیوندد.
پیامی حاوی شرح مشکل را در فضای تازه ایجاد شده ارسال می‌کند.
یک پیام مستقیم حاوی لینک به فضای تازه ایجاد شده برای شما ارسال می‌کند.

در فضای تازه ایجاد شده، پیامی با دستور اسلش /close و وضوحی مانند Not reproducible ارسال کنید.

۱۳۲cc4acfc10b98c.png

برنامه موارد زیر را انجام می‌دهد:

یک سند گزارش در Google Docs ایجاد می‌کند.
پیامی را به فضای اختصاص داده شده به مسئله با پیوندی به سند گزارش تازه ایجاد شده ارسال می‌کند.

سند گزارش را باز کنید. این سند شامل اطلاعات اولیه، تاریخچه و خلاصه‌ای از آن است.

۴. اختیاری: برنامه ۱: افزودن برنامه به خانه

مفاهیم را مرور کنید

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

جریان‌های بررسی

مدیریت مسائل

بررسی کد منبع

پروژه Apps Script نیاز به ویرایش دارد.

ChatApp.js

/**
 * Handles app home requests in Google Chat.
 * 
 * Displays the latest status of all issues.
 */
function onAppHome() {
  // Generates one card section per issue.
  var sections = [];
  for (var issueKey in appProperties.getProperties()) {
    const issue = JSON.parse(appProperties.getProperty(issueKey));
    if (issue.spaceId) {
      sections.push({
        header: `${issue.status} - ${issue.title}`,
        widgets: [{ textParagraph: {
            text: `Description: ${issue.description}`
          }}, { textParagraph: {
            text: `Resolution: ${issue.resolution}`
          }}, { buttonList: { buttons: [{
              text: "Open space",
              onClick: { openLink: {
                url: `https://mail.google.com/mail/u/0/#chat/space/${issue.spaceId}`
              }}
            }, {
              text: "Open report",
              onClick: { openLink: {
                url: issue.reportUrl !== "" ? issue.reportUrl : "docs.new"
              }},
              disabled: issue.reportUrl === ""
          }]}
        }]
      });
    }
  }

  return { action: { navigations: [{ push_card: {
    sections: sections
  }}]}};
}

به‌روزرسانی پروژه گوگل کلود

در کنسول گوگل کلود ، مراحل زیر را دنبال کنید:

در بخش ویژگی‌های تعاملی ، کادر انتخاب «پشتیبانی برنامه اصلی» را انتخاب کنید.

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

دایرکتوری فعلی در ترمینال خود را به issue-management/2-app-home تغییر دهید. این دایرکتوری شامل کد منبعی است که باید از آن استفاده کنید.
فایل issue-management/1-baseline/.clasp.json را در دایرکتوری فعلی خود کپی کنید.
فایل issue-management/1-baseline/Configuration.js را در دایرکتوری فعلی خود کپی کنید تا جایگزین فایل موجود شود.
دستور زیر را اجرا کنید:

clasp push

امتحانش کن

در گوگل چت ، مراحل زیر را دنبال کنید:

با دستور اسلش /create یک پیام مستقیم به برنامه ارسال کنید. برنامه یک کادر محاوره‌ای باز می‌کند.
عنوان را روی Issue Title 2 تنظیم کنید.
شرح را روی Description 2 تنظیم کنید.
روی ایجاد کلیک کنید.

در برنامه چت گوگل، تب «خانه» را از فضای خود انتخاب کنید. می‌توانید جزئیات مشکلاتی که ایجاد کرده‌اید را مشاهده کنید.

۵. اختیاری: برنامه ۱: افزودن نظارت بر فضا

مفاهیم را مرور کنید

میخانه/ساب

Pub/Sub یک سرویس پیام‌رسانی غیرهمزمان و مقیاس‌پذیر است که سرویس‌های تولیدکننده پیام را از سرویس‌های پردازش‌کننده آن پیام‌ها جدا می‌کند. Pub/Sub به شما امکان می‌دهد سیستم‌هایی از تولیدکنندگان و مصرف‌کنندگان رویداد، به نام ناشران و مشترکین ، ایجاد کنید. ناشران به جای فراخوانی‌های همزمان رویه از راه دور (RPC)، به صورت غیرهمزمان با پخش رویدادها با مشترکین ارتباط برقرار می‌کنند.

ناشران رویدادها را بدون توجه به نحوه یا زمان پردازش آنها به سرویس Pub/Sub ارسال می‌کنند. سپس Pub/Sub رویدادها را به تمام سرویس‌هایی که به آنها واکنش نشان می‌دهند، ارسال می‌کند. در سیستم‌هایی که از طریق RPCها ارتباط برقرار می‌کنند، ناشران باید منتظر بمانند تا مشترکین داده‌ها را دریافت کنند. با این حال، ادغام ناهمزمان در Pub/Sub انعطاف‌پذیری و استحکام سیستم کلی را افزایش می‌دهد.

موضوع : منبعی نامگذاری شده که مجموعه‌ای از پیام‌ها را نشان می‌دهد. قبل از اینکه بتوانید موضوعی را منتشر کنید یا در آن مشترک شوید، باید آن را ایجاد کنید.

اشتراک : برای دریافت پیام‌های منتشر شده در یک موضوع، باید یک اشتراک برای آن موضوع ایجاد کنید. کلاینت مشترک، پیام‌های منتشر شده در موضوع را دریافت و پردازش می‌کند. یک موضوع می‌تواند چندین اشتراک داشته باشد، اما یک اشتراک مشخص متعلق به یک موضوع واحد است.

رویدادهای گوگل ورک اسپیس

رویدادهای Google Workspace نشان‌دهنده تغییراتی در منابع Google Workspace هستند، مانند زمانی که منابع ایجاد، به‌روزرسانی یا حذف می‌شوند. برنامه‌ها می‌توانند در منابع Google Workspace مشترک شوند تا رویدادهای مرتبط را به صورت غیرهمزمان دریافت و پردازش کنند.

در اینجا نحوه ارائه رویدادها توسط API رویدادهای Google Workspace به یک برنامه از طریق اشتراک آورده شده است:

این برنامه در یک برنامه Google Workspace، مانند یک فضا، مشترک منبعی می‌شود.
منبعی که برنامه در آن مشترک شده است تغییر می‌کند.
برنامه Google Workspace رویدادی را به موضوعی در Pub/Sub ارسال می‌کند که به عنوان نقطه پایانی اعلان برای اشتراک Google Workspace برنامه عمل می‌کند. این رویداد حاوی داده‌هایی درباره آنچه در منبع تغییر کرده است، می‌باشد.
برنامه پیام Pub/Sub را که حاوی رویداد است پردازش می‌کند و در صورت لزوم، اقدامی انجام می‌دهد.

جریان‌های بررسی

ایجاد مشکل (به‌روزرسانی)

عیب‌یابی مشکل از فضای اختصاصی (به‌روزرسانی)

بستن مشکل از فضای اختصاصی (به‌روزرسانی)

اشتراک‌های فرآیند

بررسی کد منبع

پروژه Apps Script نیاز به ویرایش دارد.

appsscript.json

// Enables the Workspace Events service.

"enabledAdvancedServices": [
  ...
  {
    "userSymbol": "WorkspaceEvents",
    "version": "v1",
    "serviceId": "workspaceevents"
  }
  ...
]

پیکربندی.js

// Adds two constants: the first one is the Pub/Sub topic ID and the second one
// is the Pub/Sub subscription ID to be used to retrieve Google Workspace events.

...
const GWS_PUBSUB_TOPIC_ID = `projects/${PROJECT_ID}/topics/workspace-events`;
const GWS_PUBSUB_SUBSCRIPTION_ID =
  `projects/${PROJECT_ID}/subscriptions/workspace-events-sub`;
...

ChatApp.js

// Edits the function to delete the subscription at issue closure.

function processSlashCommand(event) {
  ...
  if (event.message.slashCommand.commandId == CLOSE_COMMAND_ID
    && event.message.space.type !== "DM") {
    ...
    deleteSubscription(issue.subscriptionId);
    ...
  }
  ...
}

// Edits the function to create the subscription.

function createIssue(event) {
  ...
  const subscriptionId = createSpaceSubscription(spaceUrl);
  const createdIssue = saveCreatedIssue(..., subscriptionId);
  ...
}

// Edits the function to delete the subscription.

function onRemoveFromSpace(event) {
  ...
  deleteSubscription(issue.subscriptionId);
  ...
}

ذخیره‌سازی.js

// Edits the function to keep track of the subscription ID.

function saveCreatedIssue(..., spaceId, subscriptionId) {
  ...
  appProperties.setProperty(spaceId, JSON.stringify({
    ...
    subscriptionId: subscriptionId,
    ...
  }));
  ...
}

WorkspaceEvent.js

/**
 * Creates a new subscription to Google Workspace Events associated to a
 * Google Chat space.
 * 
 * The subscription scope includes message creation events and resources.
 * 
 * @param {string} spaceId the space ID to create a subscription for
 * @return the ID of the newly created subscription
 */
function createSpaceSubscription(spaceId) {
  const operation = WorkspaceEvents.Subscriptions.create({
    targetResource: `//chat.googleapis.com/${spaceId}`,
    eventTypes: ["google.workspace.chat.message.v1.created"],
    notificationEndpoint: { pubsubTopic: GWS_PUBSUB_TOPIC_ID },
    payloadOptions: { includeResource: true },
  });

  return operation.response.name;
}

/**
 * Processes events from subscription by using the Google Cloud PubSub API.
 * 
 * It pulls and acknowledges each event.
 */
function processSubscription() {
  const response = UrlFetchApp.fetch(
    `https://pubsub.googleapis.com/v1/${GWS_PUBSUB_SUBSCRIPTION_ID}:pull`,
    {
      method: "POST",
      contentType: "application/json",
      headers: { "Authorization": "Bearer " + ScriptApp.getOAuthToken() },
      payload: JSON.stringify({ maxMessages: 10 })
    }
  );

  const messages = JSON.parse(response.getContentText()).receivedMessages;
  for (var messageIndex in messages) {
    const message = messages[messageIndex];
    const ceType = message.message.attributes["ce-type"];
    const dataStr = Utilities.newBlob(Utilities.base64Decode(message.message.data))
      .getDataAsString();
    if (ceType === "google.workspace.events.subscription.v1.expirationReminder") {
      // Renews subscription.
      renewSubscription(JSON.parse(dataStr).subscription.name);
    } else if (ceType === "google.workspace.chat.message.v1.created") {
      // Processes the message text when it's sent in a space.
      const chatMessage = JSON.parse(dataStr).message;
      if (chatMessage.sender.type !== "BOT") {
        console.log("Message was processed.");
      }
    }
    // Acknowledges successful processing to avoid getting it again next time.
    ackSubscription(message.ackId);
  }
}

/**
 * Acknowledges a subscription event by using the Google Cloud PubSub API.
 * 
 * @param {string} ackId the ID of the event acknowledgment to send
 */
function ackSubscription(ackId) {
  UrlFetchApp.fetch(
    `https://pubsub.googleapis.com/v1/${GWS_PUBSUB_SUBSCRIPTION_ID}:acknowledge`,
    {
      method: "POST",
      contentType: "application/json",
      headers: { "Authorization": "Bearer " + ScriptApp.getOAuthToken() },
      payload: JSON.stringify({
        ackIds: [ackId]
      })
    }
  );
}

/**
 * Renews a subscription to Google Workspace Events.
 * 
 * The default time to live option is used.
 * 
 * @param {string} subscriptionId the ID of the subscription to renew
 */
function renewSubscription(subscriptionId) {
  WorkspaceEvents.Subscriptions.patch({ttl: '0s'}, subscriptionId);
}

/**
 * Deletes a subscription to Google Workspace Events.
 * 
 * @param {string} subscriptionId the ID of the subscription to delete
 */
function deleteSubscription(subscriptionId) {
  WorkspaceEvents.Subscriptions.remove(subscriptionId);
}

به‌روزرسانی پروژه گوگل کلود

فعال کردن APIها

در کنسول گوگل کلود، رویدادهای گوگل ورک‌اسپیس و PubSub را فعال کنید.

روی منو ☰ > APIها و خدمات > APIها و خدمات فعال‌شده کلیک کنید و سپس تأیید کنید که هر دو فعال هستند.

شروع اشتراک

برای ارسال همه رویدادهای فضای کاری، باید یک موضوع Pub/Sub ایجاد و در آن مشترک شوید.

در کنسول گوگل کلود ، مراحل زیر را دنبال کنید:

به منو ☰ > انتشار/زیرمجموعه > موضوعات بروید.

روی ایجاد موضوع کلیک کنید.
شناسه موضوع را روی workspace-events تنظیم کنید.
کادر انتخاب «افزودن اشتراک پیش‌فرض» را علامت بزنید.
روی ایجاد کلیک کنید.

برای اعطای دسترسی به انتشار پیام‌های Pub/Sub به موضوع تازه ایجاد شده خود از Google Chat، این مراحل را دنبال کنید:

موضوع را از لیست انتخاب کنید.
برگه مجوزها را انتخاب کنید.
chat-api-push@system.gserviceaccount.com را به New principals اضافه کنید.
برای نقش، گزینه انتشار/زیرنویس ناشر را انتخاب کنید.
روی ذخیره کلیک کنید.

پروژه اسکریپت برنامه‌ها را به‌روزرسانی کنید

در کنسول گوگل کلود ، مراحل زیر را دنبال کنید:

به منو ☰ > مدیریت و شناسه کاربری > تنظیمات بروید.

شناسه پروژه را کپی کنید.

۸۲۵۹۲fa0bd113469.png

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

دایرکتوری فعلی در ترمینال خود را به issue-management/3-message-monitoring تغییر دهید. این دایرکتوری شامل کد منبع مورد نیاز شماست.
ثابت رشته‌ای با نام PROJECT_ID را در فایل Configuration.js برابر با شناسه پروژه کپی شده قرار دهید.
ثابت JSON با نام CHAT_CREDENTIALS را در فایل Configuration.js روی محتوای فایل کلید خصوصی که قبلاً دانلود کرده‌اید، تنظیم کنید.
فایل issue-management/2-app-home/.clasp.json را در دایرکتوری فعلی خود کپی کنید.
دستور زیر را اجرا کنید:

clasp push

امتحانش کن

در گوگل چت ، مراحل زیر را دنبال کنید:

با دستور اسلش /create یک پیام مستقیم به برنامه ارسال کنید. برنامه یک کادر محاوره‌ای باز می‌کند.
عنوان را روی Issue Title 3 تنظیم کنید.
شرح را روی Description 3 تنظیم کنید.
روی ایجاد کلیک کنید.
در فضای تازه ایجاد شده، چند پیام ارسال کنید که در مورد موضوع بحث می‌کنند.
با دستور اسلش /close و راه‌حلی مانند Fixed یک پیام ارسال کنید.

در کنسول گوگل کلود ، مراحل زیر را دنبال کنید:

به منو ☰ > انتشار/عضویت > اشتراک‌ها بروید.

فضای کاری-رویدادهای-زیرشاخه اشتراک را انتخاب کنید.
برگه پیام‌ها را انتخاب کنید.
روی «کشیدن» کلیک کنید. جدول، پیام‌های مرتبط با آنچه که به فضای تازه ایجاد شده ارسال کرده‌اید را نمایش می‌دهد.

۸۲۶۳۱c۹۷۹۲d۸۳۸۸۹.png

در کنسول Apps Script ، مراحل زیر را دنبال کنید:

پروژه خود را انتخاب کنید.
ویرایشگر را انتخاب کنید.
فایل WorkspaceEvent.gs را انتخاب کنید.
در بخش اجرا، processSubscription انتخاب کنید.
Run کلیک کنید. از گزارش اجرا می‌توانید ببینید که پیام‌ها پردازش شده‌اند.

در کنسول گوگل کلود ، مراحل زیر را دنبال کنید:

به منو ☰ > انتشار/عضویت > اشتراک‌ها بروید.

فضای کاری-رویدادهای-زیرشاخه اشتراک را انتخاب کنید.
برگه پیام‌ها را انتخاب کنید.
روی «کشیدن» کلیک کنید. جدول دیگر پیام‌های مربوط به آنچه که به فضای تازه ایجاد شده ارسال کرده‌اید را نمایش نمی‌دهد.

در گوگل چت ، در فضای اختصاص داده شده به موضوع سوم که با دستور اسلش /create ایجاد کرده‌اید، چند پیام دیگر ارسال کنید که در مورد موضوع بحث می‌کنند.

در کنسول گوگل کلود ، مراحل زیر را دنبال کنید:

به منو ☰ > انتشار/عضویت > اشتراک‌ها بروید.

فضای کاری-رویدادهای-زیرشاخه اشتراک را انتخاب کنید.
برگه پیام‌ها را انتخاب کنید.
روی «کشیدن» کلیک کنید. جدول پیام‌های مربوط به آنچه که به فضای تازه ایجاد شده ارسال کرده‌اید را نمایش نمی‌دهد.

۶. اختیاری: برنامه ۱: اضافه کردن کمک در مورد فراگیری

مفاهیم را مرور کنید

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

جریان‌های بررسی

اشتراک‌ها را پردازش کنید (به‌روزرسانی)

بررسی کد منبع

پروژه Apps Script نیاز به ویرایش دارد.

WorkspaceEvent.js

// Edits the function to replace logging by an actual card message.

function processSubscription() {
  ...
  for (var messageIndex in messages) {
    ...
    } else if (ceType === "google.workspace.chat.message.v1.created") {
      ...
      const inclusivityCheck = getInclusivityFeedback(chatMessage.text);
      if (inclusivityCheck !== "It's inclusive!") {
        createAppMessageUsingChatService({
          cardsV2: [{ cardId: "1", card: { header: {
              title: "Inclusivity",
              subtitle: `The following words are not inclusive: ${inclusivityCheck}`
          }}}]
        },
        chatMessage.space.name);
      }
      ...
    }
    ...
  }
  ...
}

VertexAi.js

/**
 * Gets feedback on inclusivity for a text with the Gemini Pro model using
 * Vertex AI API.
 * 
 * Returns "It's inclusive!" when it is otherwise a list of word(s) that might not
 * be optimal.
 *
 * @param {string} text the text
 * @return {string} the feedback
 */
function getInclusivityFeedback(text) {
  const url = `https://${VERTEX_AI_LOCATION_ID}-aiplatform.googleapis.com/v1`
    + `/projects/${PROJECT_ID}/locations/${VERTEX_AI_LOCATION_ID}`
    + "/publishers/google/models/gemini-1.0-pro:generateContent";
  const options =  {
    method: "POST",
    headers: { Authorization: "Bearer " + ScriptApp.getOAuthToken() },
    contentType: "application/json",
    payload: JSON.stringify({
      contents: {
        role: "user",
        parts: {
          text: "Are there any words that obviously go against inclusivity "
            + "in this text:"
            + `\n\n----------\n${text}\n----------\n\n`
            + "If there are not, answer \"It's inclusive!\" "
            + "otherwise answer by listing them separated by commas. "
            + "Do not answer with any explanation."
        }
      },
      safetySettings: {
        category: "HARM_CATEGORY_SEXUALLY_EXPLICIT",
        threshold: "BLOCK_LOW_AND_ABOVE"
      },
      generationConfig: {
        temperature: 0.2,
        topP: 0.8,
        topK: 40
      }
    })
  };

  return JSON.parse(UrlFetchApp.fetch(url, options).getContentText())
    .candidates[0].content.parts[0].text;
}

پروژه اسکریپت برنامه‌ها را به‌روزرسانی کنید

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

دایرکتوری فعلی در ترمینال خود را به issue-management/4-inclusivity-help تغییر دهید. این دایرکتوری شامل کد منبع مورد نیاز شماست.
فایل issue-management/3-message-monitoring/.clasp.json را در دایرکتوری فعلی خود کپی کنید.
فایل issue-management/3-message-monitoring/Configuration.js را در دایرکتوری فعلی خود کپی کنید تا جایگزین فایل موجود شود.
دستور زیر را اجرا کنید:

clasp push

امتحانش کن

در گوگل چت ، مراحل زیر را دنبال کنید:

با دستور اسلش /create یک پیام مستقیم به برنامه ارسال کنید. برنامه یک کادر محاوره‌ای باز می‌کند.
عنوان را روی Issue Title 4 تنظیم کنید.
شرح را روی Description 4 تنظیم کنید.
روی ایجاد کلیک کنید.
در فضای تازه ایجاد شده، It happened to me last week as well ارسال کنید.

در کنسول Apps Script ، مراحل زیر را دنبال کنید:

پروژه خود را انتخاب کنید.
ویرایشگر را انتخاب کنید.
فایل WorkspaceEvent.gs را انتخاب کنید.
در بخش اجرا، processSubscription انتخاب کنید.
روی اجرا کلیک کنید. از گزارش اجرا می‌توانید ببینید که پیام‌ها پردازش شده‌اند.

در گوگل چت ، مراحل زیر را دنبال کنید:

توجه داشته باشید که برنامه هیچ کمکی در مورد فراگیری در فضای تازه ایجاد شده ارسال نکرده است.
در فضای تازه ایجاد شده، پیام I had to add myself from the master to fix it ارسال کنید.

در کنسول Apps Script ، مراحل زیر را دنبال کنید:

پروژه خود را انتخاب کنید.
ویرایشگر را انتخاب کنید.
فایل WorkspaceEvent.gs را انتخاب کنید.
در بخش اجرا، processSubscription انتخاب کنید.
روی اجرا کلیک کنید. از گزارش اجرا می‌توانید ببینید که پیام‌ها پردازش شده‌اند. در گوگل چت ، برنامه یک پیام کمک در مورد فراگیری در فضای تازه ایجاد شده ارسال کرد.

۷. اختیاری: برنامه ۱: افزودن تنظیمات برگزیده

مفاهیم را مرور کنید

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

جریان‌های بررسی

غیرفعال کردن راهنمای جامعیت

بررسی کد منبع

پروژه Apps Script نیاز به ویرایش دارد.

ChatApp.js

// Edits the function to handle the inclusivity help disablement action for a
// given space.

function onCardClick(event) {
  ...
  if (event.action.actionMethodName === "disableInclusivityHelp") {
    disableInclusivityHelp(event.common.parameters.spaceId);
  }
}

ذخیره‌سازی.js

// Edits the function to keep track of the inclusivity help setting.

function saveCreatedIssue(title, description, spaceId, subscriptionId) {
  appProperties.setProperty(spaceId, JSON.stringify({
    ...
    inclusivityHelp: true,
    ...
  }));
  ...
}

/**
 * Disables inclusivity help in a space.
 * 
 * @param {string} spaceId the ID of dedicated space of the issue
 */
function disableInclusivityHelp(spaceId) {
  var issue = JSON.parse(appProperties.getProperty(spaceId));
  issue.inclusivityHelp = false;
  appProperties.setProperty(spaceId, JSON.stringify(issue));
}

/**
 * Checks whether the app should help with inclusivity in a given space.
 * 
 * @param {string} spaceId the ID of dedicated space of the issue
 * @return whether the app should help with inclusivity
 */
function shouldHelpWithInclusivity(spaceId) {
  return JSON.parse(appProperties.getProperty(spaceId)).inclusivityHelp;
}

WorkspaceEvent.js

// Edits the function to display the accessory widget to the existing card message.

function processSubscription() {
  ...
  for (var messageIndex in messages) {
    ...
    } else if (ceType === "google.workspace.chat.message.v1.created") {
      ...
      if (... && shouldHelpWithInclusivity(chatMessage.space.name)) {
        createAppMessageUsingChatService({
          ...
          accessoryWidgets: [{ buttonList: { buttons: [{
            altText: "Disable inclusivity help",
            icon: {
              iconUrl: "https://upload.wikimedia.org/.../Stop_hand_rugen.png"
            },
            onClick: { action: {
              function: "disableInclusivityHelp",
              parameters: [{
                key: "spaceId",
                value: chatMessage.space.name
              }]
            }}
          }]}}]
        }, ...);
        ...
      }
      ...
    }
    ...
  }
  ...
}

پروژه اسکریپت برنامه‌ها را به‌روزرسانی کنید

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

دایرکتوری فعلی را در ترمینال خود به issue-management/5-disable-help تغییر دهید. این دایرکتوری شامل کد منبع مورد نیاز شماست.
فایل issue-management/4-inclusivity-help/.clasp.json را در دایرکتوری فعلی خود کپی کنید.
فایل issue-management/4-inclusivity-help/Configuration.js را در دایرکتوری فعلی خود کپی کنید تا جایگزین فایل موجود شود.
دستور زیر را اجرا کنید:

clasp push

امتحانش کن

غیرفعال کردن راهنما

در چت گوگل ، در فضای اختصاص داده شده به موضوع چهارم که با دستور اسلش /create ایجاد کردید، پیام I had to add myself from the master to fix ارسال کنید.

در کنسول Apps Script ، مراحل زیر را دنبال کنید:

پروژه خود را انتخاب کنید.
ویرایشگر را انتخاب کنید.
فایل WorkspaceEvent.gs را انتخاب کنید.
در بخش اجرا، processSubscription انتخاب کنید.
روی اجرا کلیک کنید. از گزارش اجرا می‌توانید ببینید که پیام‌ها پردازش شده‌اند.

در گوگل چت ، مراحل زیر را دنبال کنید:

توجه کنید که برنامه پیامی با عنوان «کمک به فراگیری» به فضای اختصاص داده شده به این موضوع به همراه یک ویجت لوازم جانبی ارسال کرده است.
برای غیرفعال کردن راهنمای جامعیت، روی ویجت لوازم جانبی کلیک کنید.

بررسی غیرفعال بودن

در چت گوگل ، در فضای اختصاص داده شده به موضوع چهارم که با دستور اسلش /create ایجاد کردید، پیام I had to add myself from the master to fix ارسال کنید.

در کنسول Apps Script ، مراحل زیر را دنبال کنید:

پروژه خود را انتخاب کنید.
ویرایشگر را انتخاب کنید.
فایل WorkspaceEvent.gs را انتخاب کنید.
در بخش اجرا، processSubscription انتخاب کنید.
روی اجرا کلیک کنید. از گزارش اجرا می‌توانید ببینید که پیام‌ها پردازش شده‌اند. در گوگل چت ، برنامه پیامی با پشتیبانی inclusivity به فضای اختصاص داده شده به مشکل ارسال نکرد زیرا غیرفعال بود.

۳۴۷d۶۵۹db۵۳b۷۳e۹.png

۸. برنامه ۲: ساخت

مفاهیم را مرور کنید

اتصال به زمین توسط هوش مصنوعی عمومی

این در مورد واقعی‌تر و قابل اعتمادتر کردن مدل‌های هوش مصنوعی با اتصال آنها به منابع دانش قابل تأیید است. این تکنیک به جلوگیری از اختراع اطلاعات توسط هوش مصنوعی کمک می‌کند و می‌تواند به پاسخ‌هایی با ارتباط محتوایی و کمتر جانبدارانه کمک کند.

زبان طبیعی

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

فضای ذخیره‌سازی ابری

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

فروشگاه داده Dialogflow CX

Dialogflow CX با انبارهای داده که مجموعه‌ای از وب‌سایت‌ها و اسناد هستند و توسط عوامل انبار داده برای یافتن پاسخ سوالات کاربر نهایی از داده‌های خاص استفاده می‌شوند، ادغام می‌شود. برای یک سوال مشخص، عامل انبار داده به دنبال پاسخی از محتوای منبع داده شده می‌گردد و یافته‌ها را در یک پاسخ منسجم خلاصه می‌کند. همچنین پیوندهای پشتیبانی به منابع پاسخ را برای کاربر نهایی فراهم می‌کند تا اطلاعات بیشتری کسب کند.

بررسی معماری

این برنامه گوگل چت با Dialogflow CX ساخته شده است و به شرح زیر عمل می‌کند:

کاربر پیامی را به برنامه ارسال می‌کند، چه از طریق پیام مستقیم و چه از طریق یک فضای خالی.
این برنامه که یک عامل Dialogflow CX است و با یک پروژه Google Cloud مرتبط است، پیام را پردازش می‌کند.
این برنامه با یک فروشگاه داده واقع در Cloud Storage ادغام می‌شود.
برنامه یک پاسخ همزمان، چه در یک پیام مستقیم و چه در فضای اصلی، ارسال می‌کند.

جریان‌های بررسی

پاسخ سوال

بررسی کد منبع

تنها منبعی که نیاز دارید کد نیست، بلکه داده‌هایی است که برای اتصال به زمین استفاده می‌کنید.

نمای کلی گوگل چت.pdf

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

به‌روزرسانی پروژه گوگل کلود

در کنسول گوگل کلود، مراحل زیر را دنبال کنید:

APIهای Dialogflow و Cloud Storage را فعال کنید.

API سازنده عامل هوش مصنوعی ورتکس (Vertex AI Agent Builder) را فعال کنید.

روی منو ☰ > APIها و خدمات > APIها و خدمات فعال‌شده کلیک کنید و سپس تأیید کنید که همه APIها فعال شده‌اند.

ایجاد عامل ذخیره داده Dialogflow CX

داده‌های دانش را آغاز کنید

در کنسول گوگل کلود ، مراحل زیر را دنبال کنید:

روی منو ☰ > فضای ذخیره‌سازی ابری > سطل‌ها کلیک کنید.

روی ایجاد کلیک کنید.
نام را روی gchat-knowledge تنظیم کنید.
روی ایجاد کلیک کنید.

مخزن gchat-knowledge را انتخاب کنید.
روی آپلود فایل‌ها کلیک کنید.
فایل google-chat-overview.pdf را از محیط محلی خود دانلود و انتخاب کنید.

ایجاد برنامه

در کنسول گوگل کلود ، مراحل زیر را دنبال کنید:

روی منو ☰ > سازنده‌ی عامل > برنامه‌ها کلیک کنید.

روی برنامه جدید کلیک کنید.
نوع چت را انتخاب کنید.

۴۴۲۷۶۰۰۳۰۷4bcf۱۴.png

Company name روی نام شرکت خود تنظیم کنید.
Agent name روی knowledge تنظیم کنید.
روی ادامه کلیک کنید.

روی ایجاد فروشگاه داده جدید کلیک کنید.
فضای ذخیره‌سازی ابری را به عنوان منبع داده انتخاب کنید.

فایل را انتخاب کنید.
روی مرور کلیک کنید.
فایل google-chat-overview.pdf را انتخاب کنید.
روی ادامه کلیک کنید.
نام محل ذخیره‌سازی داده را روی gchat-knowledge-ds تنظیم کنید.
روی ایجاد کلیک کنید.

مخزن داده gchat-knowledge-ds را در جدول انتخاب کنید.
روی ایجاد کلیک کنید.

بعد از چند دقیقه، روی Menu ☰ > Agent builder > Apps کلیک کنید و متوجه خواهید شد که می‌توانید برنامه را ببینید.

روی منو ☰ > سازنده‌ی عامل > فروشگاه‌های داده کلیک کنید.

روی مخزن داده gchat-knowledge-ds کلیک کنید. تعداد اسناد 1 است که نشان می‌دهد آماده است.

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

در کنسول Dialogflow CX ، مراحل زیر را دنبال کنید:

پروژه گوگل کلود خود را انتخاب کنید.
عامل دانش را انتخاب کنید.

تنظیمات عامل > هوش مصنوعی مولد > عامل مولد را انتخاب کنید.
مدل را از Text Bison به Gemini Pro تغییر دهید.
روی ذخیره کلیک کنید.

روی عامل تست کلیک کنید.
ارسال What is Google Chat? . نماینده با چیزی معنادار پاسخ می‌دهد.

ادغام برنامه چت گوگل

در کنسول Dialogflow CX ، مراحل زیر را دنبال کنید:

پروژه گوگل کلود خود را انتخاب کنید.
در ردیف عامل دانش، کلیک کنید > نام را کپی کنید .

در کنسول گوگل کلود ، مراحل زیر را دنبال کنید:

به پیکربندی API چت گوگل بروید.

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

در گوگل چت ، What is Google Chat? را در یک پیام مستقیم به برنامه گوگل چت ارسال کنید. اپراتور با پیامی معنادار پاسخ می‌دهد.

۹. اختیاری: برنامه ۲: افزودن منابع

مفاهیم را مرور کنید

وب هوک Dialogflow CX

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

توابع ابری

توابع ابری برای ساخت backendهای بدون سرور، انجام پردازش داده‌های بلادرنگ و ایجاد برنامه‌های هوشمند عالی هستند. هیچ سروری برای تهیه، مدیریت، وصله‌گذاری یا به‌روزرسانی وجود ندارد. آنها به طور خودکار مقیاس‌پذیر هستند و در دسترس بودن بالایی دارند و در برابر خطا مقاوم هستند.

جریان‌های بررسی

پاسخ به سوال (به‌روزرسانی)

۹۲۷۶۷c۰۷c۷b۲۵۲aa.png

بررسی کد منبع

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

بسته.json

// The function relies on the Cloud Functions framework to run.

{
  "name": "agent-response-adapter",
  "version": "0.0.1",
  "dependencies": {
    "@google-cloud/functions-framework": "^3.0.0"
  },
  ...
}

ایندکس.js

/** 
 * Handles all incoming requests.
 *
 * It takes a Dialogflow CX agent response as input and returns a
 * valid Google Chat card message with both the text and source links
 */
functions.http('agent-response-adapter', (request, response) => {
  // Creates Google Chat buttons based on the data store agent response
  // grounding details.
  var linkTitles = [];
  var linkButtons = [];
  const grounding = request.body.messages[1].payload.richContent[0][0];
  if (grounding.type === "match_citations") {
    // Supports citation match type.
    grounding.citations.forEach((citation) => {
      // Avoid duplications.
      if (linkTitles.indexOf(citation.title) < 0) {
        linkButtons.push({
          text: citation.title,
          onClick: { openLink: {
            url: citation.actionLink
          }}
        });
        linkTitles.push(citation.title);
      }
    });
  } else if (grounding.type === "info") {
    // Supports info type.
    if (linkTitles.indexOf(grounding.title) < 0) {
      linkButtons.push({
        text: grounding.title,
        onClick: { openLink: {
          url: grounding.actionLink
        }}
      });
      linkTitles.push(grounding.title);
    }
  }

  // Sends the Dialogflow CX fulfillment response to replace the agent response
  // with the Chat message with text and source buttons.
  response.send({ fulfillment_response: {
    merge_behavior: "REPLACE",
    messages: [{ payload: {
      // Reuses the original data store agent response text.
      text: request.body.messages[0].text.text[0],
      cardsV2: [{
        cardId: "sourcesCard",
        card: { sections: [{
          header: "Sources",
          widgets: [{ buttonList: {
            buttons: linkButtons
          }}]
        }]}
      }]
    }}]
  }});
});

به‌روزرسانی پروژه گوگل کلود

در کنسول گوگل کلود، مراحل زیر را دنبال کنید:

APIهای Cloud Build، Cloud Functions، Cloud Logging، Artifact Registry و Cloud Run را فعال کنید.

روی منو ☰ > APIها و خدمات > APIها و خدمات فعال‌شده کلیک کنید و سپس تأیید کنید که APIها فعال شده‌اند.

به‌روزرسانی عامل ذخیره‌سازی داده Dialogflow CX

شما باید یک تابع ابری (Cloud Function) مستقر کنید و وب‌هوک Dialogflow CX را به‌روزرسانی کنید تا در صورت امکان، آن را با چندین منبع فعال کنید.

بازگرداندن چندین منبع

به طور پیش‌فرض، یک عامل ذخیره داده جدید حداکثر فقط یک منبع را برمی‌گرداند، اما می‌توانید آن را برای تعداد بیشتری تغییر دهید.

در کنسول Dialogflow CX ، مراحل زیر را دنبال کنید:

پروژه گوگل کلود خود را انتخاب کنید.
عامل دانش را انتخاب کنید.
صفحه شروع را انتخاب کنید.
ویرایش محل‌های ذخیره‌سازی داده را انتخاب کنید.
در بخش پاسخ‌های عامل ، گزینه‌های پاسخ ذخیره داده را روی 5 تنظیم کنید.
روی ذخیره کلیک کنید.

شروع عملکرد ابری

در کنسول گوگل کلود ، مراحل زیر را دنبال کنید:

روی منو ☰ > توابع ابری کلیک کنید.

روی ایجاد تابع کلیک کنید.
در بخش Basics ، نام را روی function-1 تنظیم کنید.
در بخش «احراز هویت» ، دکمه رادیویی «مجاز کردن فراخوانی‌های احراز هویت نشده» را انتخاب کنید.
در قسمت تنظیمات زمان اجرا، ساخت، اتصالات و امنیت ، حداکثر تعداد نمونه‌ها را روی 3 تنظیم کنید.
روی بعدی کلیک کنید.

نقطه ورود را روی agent-response-adapter تنظیم کنید.
Replace the default content with the files package.json and index.js .
Click Deploy .

Copy the URL while you wait a couple minutes for the function to deploy.

Initiate webhook

You need to configure the Dialogflow CX agent to use a webhook that triggers the newly deployed function.

In the Dialogflow CX console , follow these steps:

Select your Google Cloud project.
Select the knowledge agent.
Select Manage > Webhooks > Create .
Set Display name to Google Chat Response Adapter .
Set Webhook URL to the URL that you copied previously.
Click Save .

Click Build .
Select Start page .
Select Edit data stores .
Under Webhook settings , click the Enable webhook toggle.
Select Google Chat Response Adapter for Webhook .
Set tag to arbitrary_tag .
Click Save .

Test app

In Google Chat , send What is Google Chat? in a direct message to the Google Chat app. The agent responds with something meaningful and a card with sources, if any.

10. App 3: Build

Review concepts

Conversational interactions

They are the back-and-forth exchanges of information or ideas between two or more people through natural language. This contrasts to technical interfaces that often rely on stateless, highly structured, and intolerant exchanges.

OpenAPI Specification

It provides a consistent means to carry information through each stage of the API lifecycle. It is a specification language for HTTP APIs that defines structure and syntax in a way that is not wedded to the programming language the API is created in. API specifications are typically written in YAML or JSON, allowing for easy sharing and consumption of the specification.

Dialogflow CX agent

The basic building block of agent apps . An agent app typically has many agents , where each agent is defined to handle specific tasks. The agent data is provided to the LLM, so it has the information it needs to answer questions and execute tasks. Each agent can provide information, send queries to external services, or defer conversation handling to a Dialogflow CX flow or another agent to handle sub-tasks.

Dialogflow CX tool

Tools are used to connect agent apps to external systems. These systems can augment the knowledge of agent apps and empower them to execute complex tasks efficiently.

Review architecture

This Google Chat app is built with Dialogflow CX and works as follows:

A user sends a message to the app, either in a direct message or in a space.
The app, which is a Dialogflow CX agent and is associated with a Google Cloud project, processes the message.
The app integrates with an agent.
The app sends a synchronous response, either in a direct message or in the original space.

Review flows

Collect review

Review source code

The only source code that you need is the function to mock the backend service that the agent uses as a tool.

package.json

// The function relies on the Cloud Functions framework to run.

{
  "name": "feedback-app-backend",
  "version": "0.0.1",
  "dependencies": {
    "@google-cloud/functions-framework": "^3.0.0"
  },
  ...
}

index.js

/** 
 * Handles all incoming requests.
 * 
 * It always returns OK in plain text.
 */
functions.http('feedback-app-backend', (request, response) => {
    response.send('OK');
});

service-openapi.yaml

// Defines the backend service structure and how to request it.

openapi: 3.1.0
info:
  title: Review Store
  license:
    name: Apache 2.0
    identifier: Apache-2.0
  version: 0.0.1
servers:
  - url: https://us-central1-project-0.cloudfunctions.net
paths:
  /store-review:
    post:
      operationId: storeReview
      summary: Store a new review
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                stars:
                  type: integer
                  format: int64
      responses:
        '200':
          description: success
          content:
            application/json:
              schema:
                type: string

Initiate backend service mock

You deploy a Cloud Function to simulate a backend service that the Dialogflow CX agent app needs to integrate and call as a tool.

In the Google Cloud console , follow these steps:

Click Menu ☰ > Cloud Functions .

Click Create function .
Under Basics , set name to function-2 .
Under Authentication , select the Allow unauthenticated invocations radio button.
Under Runtime, build, connections and security settings , set Maximum number of instances to 3 .
روی بعدی کلیک کنید.

Set Entry point to feedback-app-backend .
Replace the default content with the files package.json and index.js .
Click Deploy .

Copy the URL while you wait a couple minutes for the function to deploy.

Create Dialogflow CX agent app

Create app

In the Google Cloud console , follow these steps:

Click Menu ☰ > Agent builder > Apps .

Click New app .
Select Agent .
Set Display name to Feedback App .
Click Create .

Initiate tool

In the Google Cloud console , follow these steps:

Click Menu ☰ > Agent builder > Apps .

Select the Feedback App agent.
Click Tools > + Create .
Set Name to review .
Select OpenAPI .
Set description to the following value:

The tool takes the number of stars as a parameter of the store review method and saves it in a database for later use.

Download and replace $URL in the file service-openapi.yaml with the URL that you copied previously.
Set YAML Schema to the edited content of the service-openapi.yaml file.
Click Save .

Initiate agent

In the Google Cloud console , follow these steps:

Click Menu ☰ > Agent builder > Apps .

Select the Feedback App agent.
Select Agents > Default Generative Agent .
Set Agent name to Feedback collector .
Set goal to the following value:

You are an agent that collects reviews from Google Chat app developers.
A review may be between 0 and 5 stars. The more stars, the more positive the review.

Set instructions to the following value:

If the developer didn't provide the number of stars, ask for the number of stars.
After the developer provides the number of stars of the review, confirm the number with the developer and use ${TOOL: review} to store the review with the number of stars.
If ${TOOL: review} fails, apologize and ask to try again later. Otherwise, thank the developer for the review.

Click Save .

Test app

In the Google Cloud console , follow these steps:

Click Menu ☰ > Agent builder > Apps .

Select the Feedback App agent.
Go to Preview agent .
Under Agent , select Feedback collector .
Under Select generative model , select gemini-pro .
Send the message Hello! to start.

In the Google Cloud console , follow these steps:

Click Menu ☰ > Cloud Functions .

Select function-2 > Logs . Some logs show Google-Dialogflow as caller.

Integrate Google Chat app

In the Dialogflow CX console , follow these steps:

Select your Google Cloud project.
Click the action menu of the Feedback App agent.
Click Copy name .

In the Google Cloud console , follow these steps:

Go to the Google Chat API configuration.

Set Agent or Environment resource name to the agent name that you copied previously.

In Google Chat , send Hello! in a direct message to the Google Chat app to start. The agent responds similarly to your test from the Dialogflow CX console.

11. Clean up

Delete Google Cloud project

To avoid incurring charges to your Google Cloud Account for the resources used in this codelab, we recommend that you delete the Google Cloud project.

In the Google Cloud console , follow these steps:

Click Menu ☰ > IAM & Admin > Settings .

Click Shut down .
Enter the project ID.
Click Shut down anyway .

Delete Apps Script project

We recommend that you delete your Apps Script project, too.

In the Apps Script console , follow these steps:

Select your project.
Click the action menu.
Click Remove .

12. Congratulations

Congratulations! You built Google Chat apps with Gemini!

بعدش چی؟

We only showcased simple use cases in this codelab, but there are plenty of expansion areas that you might want to consider in your Google Chat apps, such as the following:

Integrate with other Generative AI models, including customs.
Support other types of media, such as audio, image, and video.
Use multimodality.
Rely on longer context windows and feedback loops.
Publish production-ready Google Chat apps on the marketplace. There are plenty of resources available for developers such as YouTube videos, documentation websites, code samples, and tutorials.
Enable Google Chat for your organization. The import mode feature makes it easier to get started.

با Gemini برنامه هایی برای چت گوگل بسازید

۱. قبل از شروع

برنامه‌های چت گوگل با جمینی چیست؟

چرا برنامه‌های گوگل چت را با Gemini ادغام کنیم؟

پیش‌نیازها

آنچه می‌سازید

اپلیکیشن مدیریت مشکلات (ایجاد و بهبود محتوا)

اپلیکیشن دانش (جستجوی داده‌ها)

برنامه بازخورد (گفتگو)

آنچه یاد می‌گیرید

آنچه شما نیاز دارید

۲. آماده شوید

مقداردهی اولیه منابع

پروژه اسکریپت برنامه‌ها

پروژه گوگل کلود

گوگل چت

دانلود کد منبع و منابع به صورت محلی

نصب و پیکربندی clasp

۳. برنامه ۱: ساخت

مفاهیم را مرور کنید

هوش مصنوعی ورتکس

جوزا

سرویس چت پیشرفته

بررسی معماری

جریان‌های بررسی

ایجاد مسئله

عیب‌یابی مشکل از فضای اختصاصی

بستن مشکل از فضای اختصاصی

بررسی کد منبع

به‌روزرسانی پروژه گوگل کلود

فعال کردن APIها

شروع حساب کاربری سرویس

پیکربندی API چت گوگل را به‌روزرسانی کنید

پروژه اسکریپت برنامه‌ها را به‌روزرسانی کنید

پیکربندی کد منبع

تنظیمات clasp را پیکربندی کنید

کد منبع را فشار دهید

امتحانش کن

۴. اختیاری: برنامه ۱: افزودن برنامه به خانه

مفاهیم را مرور کنید

جریان‌های بررسی

مدیریت مسائل

بررسی کد منبع

به‌روزرسانی پروژه گوگل کلود

امتحانش کن

۵. اختیاری: برنامه ۱: افزودن نظارت بر فضا

مفاهیم را مرور کنید

میخانه/ساب

رویدادهای گوگل ورک اسپیس

جریان‌های بررسی

ایجاد مشکل (به‌روزرسانی)

عیب‌یابی مشکل از فضای اختصاصی (به‌روزرسانی)

بستن مشکل از فضای اختصاصی (به‌روزرسانی)

اشتراک‌های فرآیند

بررسی کد منبع

به‌روزرسانی پروژه گوگل کلود

فعال کردن APIها

شروع اشتراک

پروژه اسکریپت برنامه‌ها را به‌روزرسانی کنید

امتحانش کن

۶. اختیاری: برنامه ۱: اضافه کردن کمک در مورد فراگیری

مفاهیم را مرور کنید

جریان‌های بررسی

اشتراک‌ها را پردازش کنید (به‌روزرسانی)

بررسی کد منبع

پروژه اسکریپت برنامه‌ها را به‌روزرسانی کنید

امتحانش کن

۷. اختیاری: برنامه ۱: افزودن تنظیمات برگزیده

مفاهیم را مرور کنید

جریان‌های بررسی

غیرفعال کردن راهنمای جامعیت

بررسی کد منبع

پروژه اسکریپت برنامه‌ها را به‌روزرسانی کنید

امتحانش کن

غیرفعال کردن راهنما

بررسی غیرفعال بودن

۸. برنامه ۲: ساخت

مفاهیم را مرور کنید

اتصال به زمین توسط هوش مصنوعی عمومی

زبان طبیعی

نصب و پیکربندی `clasp`

تنظیمات `clasp` را پیکربندی کنید