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

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

1. قبل از شروع

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

برنامه‌های چت Google با Gemini کارهای زیر را انجام می‌دهند:

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

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

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

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

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

پیش نیازها

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

آنچه می سازید

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

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

این برنامه کارهای زیر را انجام می دهد:

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

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

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

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

برنامه دانش (جستجوی داده ها)

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

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

برنامه بازخورد (مکالمه)

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

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

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

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

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

تکمیل ساختن برنامه چت Google با شروع سریع برنامه‌ها . این کد لبه بر روی برنامه Apps Script و پروژه Google Cloud ایجاد شده است.

2. راه اندازی شوید

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

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

پروژه Apps Script

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

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

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

پروژه Google Cloud

در کنسول Google Cloud ، این مراحل را دنبال کنید:

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

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

چت گوگل

در Google Chat ، این مراحل را دنبال کنید:

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

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

این مخزن GitHub را دانلود کنید.

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

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

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

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

npm install -g @google/clasp

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

clasp login

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

3. برنامه 1: ساخت

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

Vertex AI

Vertex AI هر آنچه را که برای ساخت و استفاده از هوش مصنوعی مولد نیاز دارید ارائه می دهد، از جمله راه حل های هوش مصنوعی، سازنده عامل، بیش از 130 مدل پایه و یک پلتفرم هوش مصنوعی یکپارچه.

جوزا

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

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

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

بررسی معماری

این برنامه Google Chat با Apps Script ساخته شده است. به صورت زیر عمل می کند:

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

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

مسئله ایجاد کنید

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

بستن شماره از فضای اختصاصی

کد منبع را مرور کنید

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

Configuration : ثابت هایی برای ویرایش بر اساس محیط.
ChatApp : رویدادهای تعاملی چت Google، از جمله پیام‌ها، کلیک‌های کارت، دستورات اسلش و دیالوگ‌ها را مدیریت می‌کند.
Storage : توابع ابزاری که به خدمات Properties متکی هستند.
ChatAppAuth : توابع ابزاری که به احراز هویت برنامه چت Google متکی هستند.
Docs : توابع ابزاری که به Google 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",
  ...
]

Configuration.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;
}

Docs.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);
  ...
}

پروژه Google Cloud را به روز کنید

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

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

روی Menu ☰ > APIs & Services > Enabled APIs & Services کلیک کنید و سپس تأیید کنید که APIها فعال هستند.

حساب سرویس را راه اندازی کنید

در کنسول Google Cloud ، این مراحل را دنبال کنید:

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

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

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

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

پیکربندی Google Chat API را به‌روزرسانی کنید

در کنسول Google Cloud ، این مراحل را دنبال کنید:

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

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

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

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

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

در کنسول Google Cloud ، روی Menu ☰ > IAM & Admin > Settings کلیک کنید.

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

ثابت رشته ای با نام PROJECT_ID در فایل Configuration.js را روی ID پروژه قرار دهید.

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

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

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

در فهرست فعلی، یک فایل .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.

آن را امتحان کنید

در Google Chat ، Hello! در یک پیام مستقیم به برنامه برنامه پاسخ نمی دهد، اما پیامی ظاهر می شود که پیکربندی را درخواست می کند.

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

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

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

در گفتگو، عنوان را روی Issue Title 1 تنظیم کنید.
توضیحات را روی Issue Description 1 تنظیم کنید.
روی ایجاد کلیک کنید.

برنامه کارهای زیر را انجام می دهد:

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

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

برنامه کارهای زیر را انجام می دهد:

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

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

4. اختیاری: برنامه 1: افزودن صفحه اصلی برنامه

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

App home یک پیام کارتی قابل تنظیم است که برنامه Chat هنگامی که کاربر از طریق یک پیام مستقیم با برنامه Chat به برگه Home دسترسی پیدا می کند، برای کاربر ارسال می کند. این معمولاً برای نمایش مستندات برنامه یا یک نمای کلی استفاده می شود. از نظر فنی، یک رویداد اختصاصی برای رسیدگی وجود دارد و بر اساس همان اصول اصلی پیام های کارت است.

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

مسائل را مدیریت کنید

کد منبع را مرور کنید

پروژه 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
  }}]}};
}

پروژه Google Cloud را به روز کنید

در کنسول Google Cloud ، این مراحل را دنبال کنید:

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

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

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

clasp push

آن را امتحان کنید

در Google Chat ، این مراحل را دنبال کنید:

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

با برنامه Google Chat، برگه Home را از فضای خود انتخاب کنید. می توانید جزئیات مسائلی را که ایجاد کرده اید مشاهده کنید.

5. اختیاری: برنامه 1: اضافه کردن نظارت بر فضا

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

میخانه / فرعی

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

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

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

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

رویدادهای Google Workspace

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

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

این برنامه مشترک یک منبع در یک برنامه 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"
  }
  ...
]

Configuration.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);
  ...
}

Storage.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);
}

پروژه Google Cloud را به روز کنید

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

در کنسول Google Cloud، رویدادهای Google Workspace و PubSub را فعال کنید.

روی Menu ☰ > APIs & services > Enabled APIs & services کلیک کنید و سپس تأیید کنید که هر دو فعال هستند.

شروع اشتراک

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

در کنسول Google Cloud ، این مراحل را دنبال کنید:

به منو ☰ > Pub/Sub > Topics بروید.

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

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

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

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

در کنسول Google Cloud ، این مراحل را دنبال کنید:

به Menu ☰ > IAM & Admin > Settings بروید.

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

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

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

clasp push

آن را امتحان کنید

در Google Chat ، این مراحل را دنبال کنید:

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

در کنسول Google Cloud ، این مراحل را دنبال کنید:

به منو ☰ > Pub/Sub > اشتراک ها بروید.

اشتراک Workspace-events-sub را انتخاب کنید.
تب Messages را انتخاب کنید.
روی Pull کلیک کنید. جدول پیام های مربوط به آنچه را که به فضای ایجاد شده جدید ارسال کرده اید را نشان می دهد.

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

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

در کنسول Google Cloud ، این مراحل را دنبال کنید:

به منو ☰ > Pub/Sub > اشتراک ها بروید.

اشتراک Workspace-events-sub را انتخاب کنید.
تب Messages را انتخاب کنید.
روی Pull کلیک کنید. جدول دیگر پیام های مربوط به آنچه را که به فضای ایجاد شده جدید ارسال کرده اید نمایش نمی دهد.

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

در کنسول Google Cloud ، این مراحل را دنبال کنید:

به منو ☰ > Pub/Sub > اشتراک ها بروید.

اشتراک Workspace-events-sub را انتخاب کنید.
تب Messages را انتخاب کنید.
روی Pull کلیک کنید. جدول پیام های مربوط به آنچه را که به فضای ایجاد شده جدید ارسال کرده اید نمایش نمی دهد.

6. اختیاری: برنامه 1: اضافه کردن راهنمای جامعیت

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

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

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

فرآیند اشتراک ها (به روز رسانی)

کد منبع را مرور کنید

پروژه 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;
}

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

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

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

clasp push

آن را امتحان کنید

در Google Chat ، این مراحل را دنبال کنید:

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

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

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

در Google Chat ، این مراحل را دنبال کنید:

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

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

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

7. اختیاری: برنامه 1: تنظیمات برگزیده را اضافه کنید

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

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

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

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

کد منبع را مرور کنید

پروژه 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);
  }
}

Storage.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
              }]
            }}
          }]}}]
        }, ...);
        ...
      }
      ...
    }
    ...
  }
  ...
}

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

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

دایرکتوری فعلی در ترمینال خود را به 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 انتخاب کنید.
در قسمت Run processSubscription انتخاب کنید.
روی Run کلیک کنید. شما می توانید از گزارش اجرا ببینید که پیام ها پردازش شده اند.

در Google Chat ، این مراحل را دنبال کنید:

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

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

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

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

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

8. برنامه 2: ساخت

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

اتصال زمین با هوش مصنوعی ژنرال

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

زبان طبیعی

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

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

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

ذخیره اطلاعات Dialogflow CX

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

بررسی معماری

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

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

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

به سوال پاسخ دهید

کد منبع را مرور کنید

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

google-chat-overview.pdf

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

پروژه Google Cloud را به روز کنید

در کنسول Google Cloud، این مراحل را دنبال کنید:

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

Vertex AI Agent Builder API را فعال کنید.

روی Menu ☰ > APIs & services > Enabled APIs & services کلیک کنید و سپس تأیید کنید که همه APIS فعال هستند.

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

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

در کنسول Google Cloud ، این مراحل را دنبال کنید:

برای منو ☰ > Cloud Storage > Buckets کلیک کنید.

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

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

برنامه ایجاد کنید

در کنسول Google Cloud ، این مراحل را دنبال کنید:

روی Menu ☰ > Agent builder > Apps کلیک کنید.

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

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

روی ایجاد فروشگاه داده جدید کلیک کنید.
Cloud Storage را به عنوان منبع داده انتخاب کنید.

فایل را انتخاب کنید.
روی Browse کلیک کنید.
فایل google-chat-overview.pdf را انتخاب کنید.
روی Continue کلیک کنید.
نام فروشگاه داده را روی gchat-knowledge-ds تنظیم کنید.
روی ایجاد کلیک کنید.

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

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

روی Menu ☰ > Agent builder > Data stores کلیک کنید.

روی فروشگاه داده gchat-knowledge-ds کلیک کنید. تعداد اسناد 1 است که نشان دهنده آماده بودن آن است.

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

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

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

Agent settings > Generative AI > Generative agent را انتخاب کنید.
مدل را از Text Bison به Gemini Pro تغییر دهید.
روی ذخیره کلیک کنید.

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

برنامه Google Chat را یکپارچه کنید

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

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

در کنسول Google Cloud ، این مراحل را دنبال کنید:

به پیکربندی Google Chat API بروید.

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

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

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

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

وب هوک Dialogflow CX

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

توابع ابری

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

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

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

کد منبع را مرور کنید

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

package.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"
  },
  ...
}

index.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
          }}]
        }]}
      }]
    }}]
  }});
});

پروژه Google Cloud را به روز کنید

در کنسول Google Cloud، این مراحل را دنبال کنید:

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

روی Menu ☰ > APIs & services > Enabled APIs & services کلیک کنید و سپس تأیید کنید که APIها فعال هستند.

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

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

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

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

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

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

عملکرد Cloud را راه اندازی کنید

در کنسول Google Cloud ، این مراحل را دنبال کنید:

روی Menu ☰ > Cloud Functions کلیک کنید.

روی Create function کلیک کنید.
در زیر مبانی ، نام را روی function-1 تنظیم کنید.
در بخش احراز هویت ، دکمه رادیویی Allow unauthenticated invocations را انتخاب کنید.
در بخش Runtime، ساخت، اتصالات و تنظیمات امنیتی ، حداکثر تعداد نمونه ها را روی 3 تنظیم کنید.
روی Next کلیک کنید.

نقطه ورود را روی agent-response-adapter تنظیم کنید.
فایل های package.json و index.js را جایگزین محتوای پیش فرض کنید.
روی Deploy کلیک کنید.

در حالی که چند دقیقه صبر می کنید تا تابع اجرا شود، URL را کپی کنید.

وب هوک را راه اندازی کنید

شما باید عامل Dialogflow CX را پیکربندی کنید تا از یک هوکی استفاده کند که عملکرد تازه مستقر شده را فعال می کند.

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

پروژه Google Cloud خود را انتخاب کنید.
عامل دانش را انتخاب کنید.
مدیریت > Webhooks > ایجاد را انتخاب کنید.
نام نمایشی را روی Google Chat Response Adapter تنظیم کنید.
URL Webhook را روی نشانی اینترنتی که قبلاً کپی کرده اید تنظیم کنید.
روی ذخیره کلیک کنید.

روی ساخت کلیک کنید.
صفحه شروع را انتخاب کنید.
ویرایش ذخیره‌های داده را انتخاب کنید.
در تنظیمات Webhook ، روی دکمه فعال کردن webhook کلیک کنید.
آداپتور Google Chat Response Adapter برای Webhook را انتخاب کنید.
تگ را روی arbitrary_tag تنظیم کنید.
روی ذخیره کلیک کنید.

برنامه تست

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

10. برنامه 3: ساخت

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

تعامل مکالمه

آنها مبادلات عقب و جلو از اطلاعات یا ایده های بین دو یا چند نفر از طریق زبان طبیعی هستند. این در تضاد با رابط های فنی است که اغلب به مبادلات بدون تابعیت ، بسیار ساختار یافته و غیرقابل تحمل متکی هستند.

مشخصات OpenAPI

این وسیله ای ثابت برای حمل اطلاعات از طریق هر مرحله از چرخه عمر API فراهم می کند. این یک زبان مشخصات برای API های HTTP است که ساختار و نحو را به شکلی تعریف می کند که به زبان برنامه نویسی که API در آن ایجاد شده است ، عروسی نمی شود. مشخصات API به طور معمول در YAML یا JSON نوشته شده است و امکان اشتراک و مصرف آسان مشخصات را فراهم می کند.

DIALOGFLOW CX عامل

بلوک ساختمانی اصلی برنامه های عامل . یک برنامه عامل به طور معمول دارای عوامل زیادی است که در آن هر عامل برای انجام کارهای خاص تعریف می شود. داده های عامل به LLM ارائه می شود ، بنابراین اطلاعاتی را که برای پاسخ به سؤالات و اجرای وظایف لازم دارد ، دارد. هر نماینده می تواند اطلاعاتی را ارائه دهد ، نمایش داده شدگان را به خدمات خارجی ارسال کند ، یا جابجایی مکالمه را به یک جریان گفتگو CX یا یک عامل دیگر برای رسیدگی به کارهای فرعی ارائه دهد.

ابزار CX DIALOGFLOW

از ابزارها برای اتصال برنامه های عامل به سیستم های خارجی استفاده می شود. این سیستم ها می توانند دانش برنامه های عامل را تقویت کرده و آنها را قادر به انجام کارهای پیچیده به طور مؤثر کنند.

معماری را مرور کنید

این برنامه Google Chat با DialogFlow CX ساخته شده است و به شرح زیر است:

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

بررسی جریان

بررسی را جمع آوری کنید

کد منبع را مرور کنید

تنها کد منبع مورد نیاز شما عملکردی برای مسخره کردن سرویس باطن است که عامل به عنوان ابزاری از آن استفاده می کند.

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');
});

سرویس-باز .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

شروع مسخره خدمات پس زمینه

شما یک تابع ابری را برای شبیه سازی یک سرویس باطن که برنامه Agent DialogFlow CX برای ادغام و تماس با آن به عنوان ابزاری استفاده می کند ، مستقر می کنید.

در کنسول Google Cloud ، این مراحل را دنبال کنید:

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

روی ایجاد تابع کلیک کنید.
تحت اصول اولیه ، نام را روی function-2 تنظیم کنید.
تحت تأیید اعتبار ، دکمه رادیویی Ally Ally Aptencation را انتخاب کنید.
در زمان اجرا ، ساخت ، اتصالات و تنظیمات امنیتی ، حداکثر تعداد موارد را به 3 تنظیم کنید.
روی Next کلیک کنید.

نقطه ورود را روی feedback-app-backend تنظیم کنید.
محتوای پیش فرض را با Package.json و index.js جایگزین کنید.
روی استقرار کلیک کنید.

URL را کپی کنید در حالی که چند دقیقه صبر می کنید تا عملکرد مستقر شود.

ایجاد برنامه عامل CX DIALOGFLOW

ایجاد برنامه

در کنسول Google Cloud ، این مراحل را دنبال کنید:

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

روی برنامه جدید کلیک کنید.
عامل را انتخاب کنید.
نام نمایش را روی Feedback App تنظیم کنید.
روی ایجاد کلیک کنید.

ابزار اولیه

در کنسول Google Cloud ، این مراحل را دنبال کنید:

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

عامل برنامه بازخورد را انتخاب کنید.
بر روی Tools> + ایجاد کنید .
نام را برای review تنظیم کنید.
OpenAPI را انتخاب کنید.
توضیحات را روی مقدار زیر تنظیم کنید:

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

$URL در پرونده service-openapi.yaml با URL که قبلاً کپی کرده اید بارگیری و جایگزین کنید.
YAML Schema را روی محتوای ویرایش شده پرونده service-openapi.yaml تنظیم کنید.
روی ذخیره کلیک کنید.

عامل اولیه

در کنسول Google Cloud ، این مراحل را دنبال کنید:

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

عامل برنامه بازخورد را انتخاب کنید.
Agents> Agent Default Generative را انتخاب کنید.
نام عامل را روی Feedback collector تنظیم کنید.
goal را روی مقدار زیر تنظیم کنید:

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.

دستورالعمل ها را روی مقدار زیر تنظیم کنید:

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.

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

برنامه آزمایشی

در کنسول Google Cloud ، این مراحل را دنبال کنید:

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

عامل برنامه بازخورد را انتخاب کنید.
به نماینده پیش نمایش بروید.
در زیر نماینده ، جمع آوری بازخورد را انتخاب کنید.
تحت مدل Select Generative ، Gemini-Pro را انتخاب کنید.
ارسال پیام Hello! برای شروع

در کنسول Google Cloud ، این مراحل را دنبال کنید:

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

Function-2> Logs را انتخاب کنید. برخی از گزارش ها Google-dialogflow را به عنوان تماس گیرنده نشان می دهند.

برنامه Google Chat را ادغام کنید

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

پروژه Google Cloud خود را انتخاب کنید.
روی منوی عمل عامل Feedback App کلیک کنید.
روی نام کپی کلیک کنید.

در کنسول Google Cloud ، این مراحل را دنبال کنید:

به پیکربندی API Google Chat بروید.

نام منبع یا نام منابع محیط را روی نام نماینده ای که قبلاً کپی کرده اید تنظیم کنید.

در گپ گوگل ، Hello! در یک پیام مستقیم به برنامه Google Chat برای شروع. نماینده به طور مشابه به آزمون شما از کنسول گفتگو CX پاسخ می دهد.

11. تمیز کردن

پروژه Google Cloud را حذف کنید

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

احتیاط: حذف یک پروژه Google Cloud به شرح زیر است ::

همه چیز در پروژه حذف شده است. اگر از یک پروژه موجود برای این CodeLab استفاده کرده اید ، کارهای دیگری را که در این پروژه انجام داده اید حذف می کنید.
شناسه پروژه سفارشی از بین می رود. هنگامی که این پروژه را ایجاد کردید ، ممکن است یک شناسه پروژه سفارشی ایجاد کرده باشید که می خواهید در آینده از آن استفاده کنید. برای حفظ URL هایی که از شناسه پروژه استفاده می کنند ، مانند URL در AppSpot.com ، منابع منتخب را به جای کل پروژه حذف کنید.

در کنسول Google Cloud ، این مراحل را دنبال کنید:

روی منو ☰> IAM & Admin> تنظیمات کلیک کنید.

روی خاموش کردن کلیک کنید.
شناسه پروژه را وارد کنید.
به هر حال روی خاموش کردن کلیک کنید.

پروژه اسکریپت برنامه ها را حذف کنید

توصیه می کنیم پروژه اسکریپت برنامه های خود را نیز حذف کنید.

در کنسول اسکریپت برنامه ها ، این مراحل را دنبال کنید:

پروژه خود را انتخاب کنید.
روی منوی Action کلیک کنید.
روی حذف کلیک کنید.

12. تبریک می گویم

تبریک می گویم! شما برنامه های گپ Google را با جمینی ساخته اید!

بعدش چی؟

ما فقط موارد استفاده ساده را در این CodeLab به نمایش گذاشتیم ، اما زمینه های انبساط زیادی وجود دارد که ممکن است بخواهید در برنامه های Google Chat خود در نظر بگیرید ، مانند موارد زیر:

با سایر مدلهای تولید کننده هوش مصنوعی از جمله گمرک ادغام شوید.
از انواع دیگر رسانه ها مانند صدا ، تصویر و فیلم پشتیبانی کنید.
از multimodality استفاده کنید.
به ویندوزهای زمینه طولانی تر و حلقه های بازخورد اعتماد کنید.
برنامه های گپ Google آماده تولید را در بازار منتشر کنید. منابع زیادی برای توسعه دهندگان مانند فیلم های YouTube ، وب سایت های اسناد ، نمونه کد و آموزش در دسترس است.
Google Chat را برای سازمان خود فعال کنید. ویژگی Mode Import ، شروع به کار را آسان تر می کند.

بیشتر بدانید

1. قبل از شروع

برنامه های گپ Google با جمینی چیست؟

برنامه های چت Google با جمینی موارد زیر را انجام می دهند:

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

چرا برنامه های گپ Google را با جمینی ادغام می کنیم؟

موارد استفاده معمولی از مدل های AI تولیدی مانند جمینی در دسته های زیر قرار می گیرند:

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

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

پیش نیازها

دانش اساسی اسکریپت برنامه ها ، Google Cloud و Node.js.
دانش اساسی در مورد مفاهیم گپ Google ، از جمله دستگیرندگان رویداد ، دستورات SLASH ، دیالوگ ، کارت ، پیام ها ، تأیید برنامه و API .

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

در این CodeLab ، شما سه برنامه Google Chat را با جمینی می سازید تا سه مورد استفاده معرفی شده در بخش قبلی را پوشش دهد.

برنامه مدیریت شماره (ایجاد محتوا و تقویت)

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

مسائل مربوط به ایجاد تا تعامل اساسی ، برنامه خانه و احراز هویت برنامه را مدیریت می کند.
پیام ها را کنترل می کند و در مورد وقایع و ابزارک های لوازم جانبی کمک می کند.

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

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

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

برنامه دانش (جستجوی داده ها)

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

فن آوری های اصلی مورد استفاده عبارتند از: DialogFlow CX Data Agent Agent ، DialogFlow CX Webhook ، عملکردهای Google Cloud و Gemini.

برنامه بازخورد (مکالمه)

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

فن آوری های اصلی مورد استفاده عبارتند از: DialogFlow CX Agent ، DialogFlow CX Tool ، OpenAPI ، عملکردهای Google Cloud و Gemini.

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

نحوه ادغام برنامه های گپ Google با Gemini از طریق Vertex AI.
نحوه ادغام برنامه های Google Chat با DialogFlow CX Agents.
نحوه استفاده از جدیدترین ویژگی های Google Chat: App Home ، Google Chat Events و ابزارک های لوازم جانبی.

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

تکمیل برنامه Google Chat با برنامه های اسکریپت QuickStart. این CodeLab بر روی اسکریپت برنامه های حاصل و پروژه Google Cloud ساخته شده است.

2. تنظیم کنید

منابع اولیه

در این بخش ، منابع زیر را از مرورگر وب مورد نظر خود دسترسی و پیکربندی می کنید.

برنامه اسکریپت برنامه ها

در کنسول اسکریپت برنامه ها ، این مراحل را دنبال کنید:

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

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

پروژه Google Cloud

در کنسول Google Cloud ، این مراحل را دنبال کنید:

پروژه خود را انتخاب کنید.
روی منو کلیک کنید ☰> APIS & Services> صفحه رضایت OAUTH> ویرایش برنامه ، و سپس نام برنامه را روی Chat Apps Gemini قرار دهید.

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

چت گوگل

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

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

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

این مخزن GitHub را بارگیری کنید.

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

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

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

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

npm install -g @google/clasp

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

clasp login

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

3. برنامه 1: ساخت

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

Vertex AI

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

جوزا

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

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

سرویس چت پیشرفته به شما امکان می دهد از Google Chat API در اسکریپت برنامه ها استفاده کنید. این به اسکریپت ها اجازه می دهد تا فضاهای چت را پیدا کنند ، ایجاد و اصلاح کنند ، اعضای را به فضاها اضافه یا حذف کنند و پیام ها را با متن ، کارت ، پیوست ها و واکنش ها بخوانند یا ارسال کنند.

معماری را مرور کنید

این برنامه Google Chat با اسکریپت برنامه ها ساخته شده است. به صورت زیر عمل می کند:

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

بررسی جریان

ایجاد مسئله

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

مسئله نزدیک از فضای اختصاصی

کد منبع را مرور کنید

پروژه اسکریپت برنامه ها شامل اسکریپت های زیر است:

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

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

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;
}

docs.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);
  ...
}

پروژه Google Cloud را به روز کنید

API را فعال کنید

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

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

حساب خدمات را شروع کنید

در کنسول Google Cloud ، این مراحل را دنبال کنید:

روی منو کلیک کنید ☰> IAM & Admin> حساب های خدمات> + ایجاد حساب خدمات .

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

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

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

پیکربندی API Google را به روز کنید

در کنسول Google Cloud ، این مراحل را دنبال کنید:

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

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

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

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

JSON FINASION نام CHAT_CREDENTIALS را در پرونده Configuration.js روی محتوای پرونده کلید خصوصی که قبلاً بارگیری کرده اید تنظیم کنید.

در کنسول Google Cloud ، روی منو ☰> IAM & Admin> تنظیمات کلیک کنید.

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

String Fired نامگذاری شده PROJECT_ID در پرونده Configuration.js روی شناسه پروژه تنظیم کنید.

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

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

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

در فهرست فعلی ، یک پرونده .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! در یک پیام مستقیم به برنامه. برنامه پاسخ نمی دهد ، اما پیامی ظاهر می شود که پیکربندی را تحریک می کند.

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

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

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

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

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

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

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

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

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

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

4. اختیاری: برنامه 1: اضافه کردن برنامه به خانه

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

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

بررسی جریان

مدیریت مسائل

کد منبع را مرور کنید

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

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

پروژه Google Cloud را به روز کنید

در کنسول Google Cloud ، این مراحل را دنبال کنید:

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

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

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

clasp push

آن را امتحان کنید

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

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

برگه خانه را از فضای خود با برنامه Google Chat انتخاب کنید. جزئیات موضوعاتی را که ایجاد کرده اید می توانید مشاهده کنید.

5. اختیاری: برنامه 1: نظارت بر فضا را اضافه کنید

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

میخانه / فرعی

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

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

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

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

رویدادهای فضای کاری Google

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

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

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

بررسی جریان

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

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

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

اشتراک پردازش

کد منبع را مرور کنید

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

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);
  ...
}

ذخیره سازی

// 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);
}

پروژه Google Cloud را به روز کنید

API را فعال کنید

در کنسول Google Cloud ، رویدادهای فضای کاری Google و PubSub را فعال کنید.

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

اشتراک را شروع کنید

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

در کنسول Google Cloud ، این مراحل را دنبال کنید:

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

روی ایجاد موضوع کلیک کنید.
تنظیم شناسه موضوع را روی workspace-events تنظیم کنید.
کادر انتخاب Add A Default اشتراک را انتخاب کنید.
روی ایجاد کلیک کنید.

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

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

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

در کنسول Google Cloud ، این مراحل را دنبال کنید:

به منو بروید ☰> IAM & Admin> تنظیمات .

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

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

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

clasp push

آن را امتحان کنید

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

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

در کنسول Google Cloud ، این مراحل را دنبال کنید:

به منو بروید ☰> میخانه/زیر> اشتراک ها .

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

در کنسول اسکریپت برنامه ها ، این مراحل را دنبال کنید:

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

در کنسول Google Cloud ، این مراحل را دنبال کنید:

به منو بروید ☰> میخانه/زیر> اشتراک ها .

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

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

در کنسول Google Cloud ، این مراحل را دنبال کنید:

به منو بروید ☰> میخانه/زیر> اشتراک ها .

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

6. اختیاری: برنامه 1: اضافه کردن کمک به انحصار

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

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

بررسی جریان

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

کد منبع را مرور کنید

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

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

آن را امتحان کنید

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

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

در کنسول اسکریپت برنامه ها ، این مراحل را دنبال کنید:

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

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

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

در کنسول اسکریپت برنامه ها ، این مراحل را دنبال کنید:

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

7. اختیاری: برنامه 1: ترجیحات اضافه کنید

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

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

بررسی جریان

کمک به انحصار کمک کنید

کد منبع را مرور کنید

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

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);
  }
}

ذخیره سازی

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

آن را امتحان کنید

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

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

در کنسول اسکریپت برنامه ها ، این مراحل را دنبال کنید:

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

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

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

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

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

در کنسول اسکریپت برنامه ها ، این مراحل را دنبال کنید:

پروژه خود را انتخاب کنید.
ویرایشگر را انتخاب کنید.
پرونده WorkspaceEvent.gs را انتخاب کنید.
processSubscription را در بخش Run انتخاب کنید.
روی Run کلیک کنید. از ورود به سیستم می بینید که پیام ها پردازش شده اند. در Google Chat ، این برنامه پیامی با کمک فراگیر بودن به فضای اختصاص داده شده به این مسئله ارسال نکرد زیرا این بیماری غیرفعال بود.

8. برنامه 2: ساخت

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

Gen Ai Grounding

این در مورد ایجاد مدل های هوش مصنوعی واقعی تر و قابل اعتماد تر با اتصال آنها به منابع دانش قابل اثبات است. این تکنیک به جلوگیری از اختراع هوش مصنوعی کمک می کند و می تواند به پاسخگویی به متن متناسب و کمتر مغرضانه کمک کند.

زبان طبیعی

Any language spoken or written by humans for everyday communication, in contrast to artificial or computer-based languages.

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

Cloud Storage allows worldwide storage and retrieval of any amount of data at any time. It can be used for a range of scenarios, including serving website content, storing data for archival and disaster recovery, or distributing large data objects to users through direct download.

Dialogflow CX data store

Dialogflow CX integrates with data stores that are collections of websites and documents used by data store agents to find answers for end user's questions from specific data. For a given question, the data store agent searches for an answer from the given source content and summarizes the findings into a coherent response. It also provides supporting links to the sources of the response for the end user to learn more.

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 a data store located in Cloud Storage.
The app sends a synchronous response, either in a direct message or in the original space.

Review flows

Answer question

Review source code

The only source that you need isn't code, but rather data that you use for grounding.

google-chat-overview.pdf

Contains the unstructured information of Google Chat apps, a printed version of a page from the Google Workspace developers website.

Update Google Cloud project

In the Google Cloud console, follow these steps:

Enable the Dialogflow and Cloud Storage APIs.

Enable the Vertex AI Agent Builder API.

Click Menu ☰ > APIs & services > Enabled APIs & services and then confirm that all APIS are enabled.

Create Dialogflow CX data store agent

Initiate knowledge data

In the Google Cloud console , follow these steps:

Click to Menu ☰ > Cloud Storage > Buckets .

روی ایجاد کلیک کنید.
Set name to gchat-knowledge .
روی ایجاد کلیک کنید.

Select the gchat-knowledge bucket.
Click Upload files .
Download and select the google-chat-overview.pdf file from your local environment.

Create app

In the Google Cloud console , follow these steps:

Click Menu ☰ > Agent builder > Apps .

Click New app .
Select the Chat type.

Set Company name to your company name.
Set Agent name to knowledge .
روی Continue کلیک کنید.

Click Create new data store .
Select Cloud Storage as the data source.

فایل را انتخاب کنید.
روی Browse کلیک کنید.
Select the google-chat-overview.pdf file.
روی Continue کلیک کنید.
Set the data store name to gchat-knowledge-ds .
روی ایجاد کلیک کنید.

Select the gchat-knowledge-ds data store in the table.
روی ایجاد کلیک کنید.

After a couple of minutes, click Menu ☰ > Agent builder > Apps and notice that you can see the app.

Click Menu ☰ > Agent builder > Data stores .

Click the gchat-knowledge-ds data store. The number of documents is 1 , which indicates that it's ready.

Complete and test app

In the Dialogflow CX console , follow these steps:

Select your Google Cloud project.
Select the knowledge agent.

Select Agent settings > Generative AI > Generative agent .
Switch the model from Text Bison to Gemini Pro .
روی ذخیره کلیک کنید.

Click Test agent .
Send What is Google Chat? . The agent responds with something meaningful.

Integrate Google Chat app

In the Dialogflow CX console , follow these steps:

Select your Google Cloud project.
In the row of the knowledge agent, click > Copy name .

In the Google Cloud console , follow these steps:

Go to Google Chat API configuration.

Under Connection settings , select Dialogflow .
Under Dialogflow settings , select Dialogflow CX .
Set Agent or Environment resource name to the agent name that you copied.
Remove the two slash commands.

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

9. Optional: App 2: Add sources

Review concepts

Dialogflow CX webhook

A service that hosts business logic or calls other services. During a Dialogflow CX session, webhooks can rely on the data extracted by natural language processing to generate dynamic responses, validate collected data, or trigger actions on the backend.

توابع ابری

Cloud Functions are great for building serverless backends, doing real-time data processing, and creating intelligent apps. There are no servers to provision, manage, patch, or update. They automatically scale, and are highly available and fault-tolerant.

Review flows

Answer question (update)

Review source code

The only source code that you need is the function to adapt agent responses to Google Chat messages. It's used as a webhook.

package.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"
  },
  ...
}

index.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
          }}]
        }]}
      }]
    }}]
  }});
});

Update Google Cloud project

In the Google Cloud console, follow these steps:

Enable the Cloud Build, Cloud Functions, Cloud Logging, Artifact Registry, and Cloud Run APIs.

Click Menu ☰ > APIs & services > Enabled APIs & services and then confirm that the APIs are enabled.

Update Dialogflow CX data store agent

You need to deploy a Cloud Function and update the Dialogflow CX webhook to trigger it with multiple sources when possible.

Return multiple sources

By default, a new data store agent only returns one source at maximum, but you can change for more.

In the Dialogflow CX console , follow these steps:

Select your Google Cloud project.
Select the knowledge agent.
Select Start page .
Select Edit data stores .
Under the Agent responses section , set Data store response options to 5 .
روی ذخیره کلیک کنید.

Initiate Cloud Function

In the Google Cloud console , follow these steps:

Click Menu ☰ > Cloud Functions .

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

Set Entry point to 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 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 .
روی ذخیره کلیک کنید.

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

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 .
روی Next کلیک کنید.

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 .
روی ایجاد کلیک کنید.

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.
روی ذخیره کلیک کنید.

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.

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

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! برای شروع

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.
روی حذف کلیک کنید.

12. 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 برنامه هایی برای چت گوگل بسازید

1. قبل از شروع

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

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

پیش نیازها

آنچه می سازید

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

برنامه دانش (جستجوی داده ها)

برنامه بازخورد (مکالمه)

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

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

2. راه اندازی شوید

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

پروژه Apps Script

پروژه Google Cloud

چت گوگل

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

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

3. برنامه 1: ساخت

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

Vertex AI

جوزا

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

بررسی معماری

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

مسئله ایجاد کنید

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

بستن شماره از فضای اختصاصی

کد منبع را مرور کنید

پروژه Google Cloud را به روز کنید

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

حساب سرویس را راه اندازی کنید

پیکربندی Google Chat API را به‌روزرسانی کنید

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

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

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

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

آن را امتحان کنید

4. اختیاری: برنامه 1: افزودن صفحه اصلی برنامه

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

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

مسائل را مدیریت کنید

کد منبع را مرور کنید

پروژه Google Cloud را به روز کنید

آن را امتحان کنید

5. اختیاری: برنامه 1: اضافه کردن نظارت بر فضا

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

میخانه / فرعی

رویدادهای Google Workspace

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

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

عیب یابی از فضای اختصاصی (به روز رسانی)

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

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

کد منبع را مرور کنید

پروژه Google Cloud را به روز کنید

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

شروع اشتراک

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

آن را امتحان کنید

6. اختیاری: برنامه 1: اضافه کردن راهنمای جامعیت

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

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

فرآیند اشتراک ها (به روز رسانی)

کد منبع را مرور کنید

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

آن را امتحان کنید

7. اختیاری: برنامه 1: تنظیمات برگزیده را اضافه کنید

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

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

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

کد منبع را مرور کنید

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

آن را امتحان کنید

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

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

8. برنامه 2: ساخت

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

اتصال زمین با هوش مصنوعی ژنرال

زبان طبیعی

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

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