Gemini ile Google Chat için uygulamalar oluşturma

1. Başlamadan önce

Gemini'ı içeren Google Chat uygulamaları nedir?

Gemini özellikli Google Chat uygulamaları şunları yapar:

Hizmetlerinizi ve kaynaklarınızı Google Chat'e taşıyın. Böylece kullanıcılar, görüşmeden ayrılmadan bilgi alabilir ve işlem yapabilir.
İş akışlarınızı kolaylaştırmak için belirli zamanlarda metin veya resim gibi veriler oluşturabilmeleri ya da arayabilmeleri amacıyla Gemini üretken yapay zeka modeliyle entegre edin.

Google Chat uygulamaları neden Gemini ile entegre edilmelidir?

Gemini gibi üretken yapay zeka modellerinin tipik kullanım alanları aşağıdaki kategorilere girer:

İçerik oluşturma ve geliştirme. Pazarlama metinleri oluşturma, sosyal medya gönderileri hazırlama, gerçekçi görüntüler oluşturma, müzik besteleme veya video içeriklerinin oluşturulmasına yardımcı olma
Veri arama. Yapılandırılmamış bir bilgi tabanından önemli analizler elde edin, uzun metinleri özetleyin, içerikleri sınıflandırın veya dilleri daha doğru ve hızlı bir şekilde çevirin.
Görüşme Doğal, bilgilendirici ve yaratıcı sohbetler edin.

Bu özellikleri doğrudan Google Chat'in tanıdık arayüzüne entegre edebilme olanağı, kullanıcılarının deneyimini ve üretkenliğini artırmak isteyen herkes için büyük bir fırsattır.

Ön koşullar

Apps Komut Dosyası, Google Cloud ve Node.js hakkında temel bilgiler
Google Chat kavramları (olay işleyiciler, eğik çizgi komutları, iletişim kutuları, kartlar, mesajlar, uygulama kimlik doğrulaması ve API'ler dahil) hakkında temel bilgiler.

Oluşturduğunuz içerikler

Bu codelab'de, önceki bölümde tanıtılan üç kullanım alanını kapsayacak şekilde Gemini ile üç Google Chat uygulaması oluşturacaksınız.

Sorun yönetimi uygulaması (içerik oluşturma ve geliştirme)

Bu uygulama şunları yapar:

Temel etkileşimler, uygulama ana sayfası ve uygulama kimlik doğrulaması ile sorunları oluşturulmalarından kapatılmalarına kadar yönetir.
İletileri izler ve etkinlikler ile aksesuar widget'ları için kapsayıcılık konusunda yardımcı olur.

Gemini'ı kullanarak şunları yapabilirsiniz:

Mesaj geçmişine ve sorun ayrıntılarına göre sorun raporları oluşturun.
Sınırlı istemler içeren mesajlardaki kapsayıcı olmayan kelimeleri sınıflandırın.

Kullanılan temel teknolojiler Vertex AI, Gemini, Apps Komut Dosyası ve Google Workspace API'leridir (Yönetici, Chat, Dokümanlar, Etkinlikler).

Bilgi uygulaması (veri arama)

Bu uygulama, doğal dildeki soruları anlayıp yanıtlamak ve yapılandırılmamış verilerden kaynak referansları döndürmek için Gemini'ı kullanır.

Kullanılan başlıca teknolojiler Dialogflow CX veri deposu aracısı, Dialogflow CX webhook'u, Google Cloud Functions ve Gemini'dır.

Geri bildirim uygulaması (iletişim)

Bu uygulama, doğal dildeki sohbetlerle birlikte yorumları toplamak ve saklamak için Gemini'ı kullanır.

Kullanılan temel teknolojiler Dialogflow CX temsilcisi, Dialogflow CX aracı, OpenAPI, Google Cloud Functions ve Gemini'dır.

Öğrenecekleriniz

Google Chat uygulamalarını Vertex AI aracılığıyla Gemini ile entegre etme
Google Chat uygulamalarını Dialogflow CX aracılarıyla entegre etme
Google Chat'in en yeni özelliklerini (uygulama ana sayfası, Google Chat Etkinlikleri ve aksesuar widget'ları) kullanma

İhtiyacınız olanlar

Apps Komut Dosyası ile Google Chat uygulaması oluşturma hızlı başlangıç kılavuzunu tamamlamış olmanız gerekir. Bu codelab, sonuç olarak elde edilen Apps Komut Dosyası ve Google Cloud projesi üzerine kuruludur.

2. Hazırlanın

Kaynakları başlatma

Bu bölümde, tercih ettiğiniz web tarayıcısından aşağıdaki kaynaklara erişip bunları yapılandıracaksınız.

Apps Komut Dosyası projesi

Apps Komut Dosyası Konsolu'nda şu adımları uygulayın:

Ayarlar'ı tıklayın ve Google Apps Komut Dosyası API'sini etkinleştirin.

Projenizi seçin.
Proje ayarları'nı tıklayın.
Show "appsscript.json" manifest file in editor (Düzenleyicide "appsscript.json" manifest dosyasını göster) onay kutusunu işaretleyin.
Projeyi Chat Apps Gemini olarak yeniden adlandırın.

Google Cloud projesi

Google Cloud Console'da şu adımları uygulayın:

Projenizi seçin.
Menü ☰ > API'ler ve hizmetler > OAuth kullanıcı rızası ekranı > Uygulamayı düzenle'yi tıklayın ve Uygulama adı'nı Chat Apps Gemini olarak ayarlayın.

Google Chat API yapılandırmasına gidin, ardından Uygulama adı ve Açıklama'yı Chat Apps Gemini olarak ayarlayın.

Google Chat

Google Chat'te şu adımları uygulayın:

Gerekirse Google Chat uygulamanızla sohbet başlatın.
Çalıştığından emin olmak için Hello gibi bir mesaj gönderin.

Kaynak kodu ve kaynakları yerel olarak indirme

Bu GitHub deposunu indirin.

Tercih ettiğiniz geliştirme ortamında apps-script dizinini açın ve ardından terminalinizde aynı dizine gidin.

`clasp` yükleme ve yapılandırma

Kaynak kodun sürümlerini yerel ortamdan Apps Komut Dosyası projesine kolayca düzenlemek ve aktarmak için clasp kullanırız.

Yerel ortamınızda node, npm ve clasp'nin en son sürümlerini yükleyin.

npm install -g @google/clasp

Hesabınızla giriş yapın:

clasp login

İşlem başarılı olursa web tarayıcınızda temel bir onay ekranı görürsünüz ve istemci kimlik bilgilerinizin bulunduğu .clasprc.json dosyası güncellenir. Terminalinizde bulunduğu yeri görebilirsiniz.

3. 1. uygulama: Oluşturma

Kavramları inceleme

Vertex AI

Vertex AI; yapay zeka çözümleri, Agent Builder, 130'dan fazla temel model ve birleşik yapay zeka platformu dahil olmak üzere üretken yapay zeka oluşturmak ve kullanmak için ihtiyacınız olan her şeyi sunar.

Gemini

Gemini, Vertex AI üzerinden erişilebilen, Google'ın çok formatlı bir LLM'sidir. Kullanıcıların hayal güçlerini artırmalarına, meraklarını genişletmelerine ve üretkenliklerini geliştirmelerine yardımcı olarak potansiyellerini ortaya çıkarmalarını sağlar.

Gelişmiş Chat hizmeti

Gelişmiş Chat hizmeti, Apps Komut Dosyası'nda Google Chat API'yi kullanmanıza olanak tanır. Bu izin, komut dosyalarının Chat alanlarını bulmasına, oluşturmasına ve değiştirmesine, alanlara üye eklemesine veya alanlardan üye kaldırmasına, metin, kart, ek ve tepki içeren mesajları okumasına ya da yayınlamasına olanak tanır.

Mimarinin gözden geçirilmesi

Bu Google Chat sohbet uygulaması, Apps Komut Dosyası ile oluşturulmuştur. İşleyiş şekli şöyledir:

Bir kullanıcı, uygulamaya doğrudan mesaj yoluyla veya bir alanda mesaj gönderir.
Apps Komut Dosyası projesinde uygulanan ve bir Google Cloud projesiyle ilişkilendirilen uygulama, mesajı işler.
Uygulama, Google Dokümanlar ve Google Chat API'leriyle entegre olur.
Uygulama, verileri komut dosyası özelliklerinde kalıcı hale getirmek için Özellikler Hizmeti'ni kullanır.
Uygulama, doğrudan mesaj yoluyla veya orijinal alanda eşzamanlı bir yanıt gönderir.

İnceleme akışları

Sorun oluşturma

Sorunları özel alandan giderme

Sorunu özel alandan kapatma

Kaynak kodunu inceleme

Apps Komut Dosyası projesi aşağıdaki komut dosyalarını içerir:

Configuration: Ortama göre düzenlenecek sabitler.
ChatApp: Mesajlar, kart tıklamaları, eğik çizgi komutları ve iletişim kutuları dahil olmak üzere Google Chat etkileşim etkinliklerini işler.
Storage: Mülk Hizmetleri'ne dayalı yardımcı işlevler.
ChatAppAuth: Google Chat sohbet uygulaması kimlik doğrulamasına dayalı hizmet işlevleri.
Docs: Google Dokümanlar'ı temel alan yardımcı işlevler.
VertexAi: Vertex AI'ı kullanan yardımcı işlevler.

Gemini ile rapor belgeleri ve sohbet alanı geçmişleri oluşturulurken etkin olarak kullanılan bölümler şunlardır:

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 projesini güncelleme

API'leri etkinleştirme

Google Cloud Console'da Google Dokümanlar, Google Yönetici SDK'sı ve Vertex AI API'lerini etkinleştirin:

Menü ☰ > API'ler ve Hizmetler > Etkin API'ler ve Hizmetler'i tıklayın ve API'lerin etkinleştirildiğini doğrulayın.

Hizmet hesabını başlatma

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > IAM ve Yönetici > Hizmet Hesapları > + Hizmet hesabı oluştur'u tıklayın.

Hizmet hesabı adı'nı chat-app olarak ayarlayın.
Hizmet hesabı açıklaması'nı Chat app auth olarak ayarlayın.
Oluştur ve devam et'i tıklayın.
Bitti'yi tıklayın. Hizmet hesapları sayfasına yönlendirilirsiniz ve oluşturduğunuz hizmet hesabını görebilirsiniz.

Yeni oluşturulan hizmet hesabını seçin.
Anahtarlar sekmesini seçin.
Add key'yi (Anahtar ekle) tıklayın.
Yeni anahtar oluştur'u tıklayın.
JSON'ı seçin.
Oluştur'u tıklayın.

İletişim kutusu kapanır ve yeni oluşturulan herkese açık/özel anahtar çiftiniz JSON dosyası olarak yerel ortamınıza otomatik olarak indirilir. İçeriğini daha sonra Apps Komut Dosyası projenizin kaynak kodunu düzenlerken kullanırsınız.

Google Chat API yapılandırmasını güncelleme

Google Cloud Console'da şu adımları uygulayın:

Eğik çizgi komutu ekleyin.
Name (Ad) öğesini /create olarak ayarlayın.
Command ID (Komut Kimliği) değerini 1 olarak ayarlayın.
Açıklama'yı Create a new issue olarak ayarlayın.
İletişim kutusu açılır onay kutusunu seçin.
Başka bir eğik çizgi komutu ekleyin.
Name (Ad) öğesini /close olarak ayarlayın.
Command ID (Komut Kimliği) değerini 2 olarak ayarlayın.
Açıklama'yı Close an issue olarak ayarlayın.
Kaydet'i tıklayın.

Apps Komut Dosyası projesini güncelleme

Yerel terminalinizdeki mevcut dizini issue-management/1-baseline olarak değiştirin. Kaynak kodunu içerir. Kaynak kodunu Apps Komut Dosyası projenize aktarmadan önce birkaç şeyi yapılandırmanız gerekir.

Kaynak kodunu yapılandırma

Configuration.js dosyasındaki CHAT_CREDENTIALS adlı JSON sabitini, daha önce indirdiğiniz özel anahtar dosyası içeriğine ayarlayın.

Google Cloud Console'da Menü ☰ > IAM & Admin > Settings'i (Menü ☰ > IAM ve Yönetici > Ayarlar) tıklayın.

Proje kimliğini kopyalayın.

Configuration.js dosyasındaki PROJECT_ID adlı dize sabitini proje kimliğine ayarlayın.

`clasp` ayarlarını yapılandırma

Kaynak kodu doğru Apps Komut Dosyası projesine göndermek için clasp ayarlarını başlatmak üzere aşağıdaki adımları uygulayın:

Apps Komut Dosyası Konsolu'nda projenizi seçin.
Proje Ayarları'nı seçin.
Kimlikler bölümünde Kopyala'yı tıklayın.

Geçerli dizinde bir .clasp.json dosyası oluşturun.
<your-script-id> kısmını kopyalanan kimlikle değiştirin.
Sonucu .clasp.json dosyasına kopyalayın.
.clasp.json dosyasını kaydedin.

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

Kaynak kodu gönderme

Aşağıdaki komutu çalıştırın:

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

Deneyin

Google Chat'te uygulamaya doğrudan mesaj olarak Hello! gönderin. Uygulama yanıt vermez ancak yapılandırma yapmanızı isteyen bir mesaj gösterilir.

Yapılandır'ı tıklayın.
Google Hesabınızı seçin.
Kimliğinizi doğrulayın.
Uygulamaya erişimi inceleyip izin verin.

Başarılı olursa web sayfasında temel bir onay ekranı ve uygulamadan orijinal mesajınıza gerçek bir yanıt görürsünüz.

Uygulamaya başka bir doğrudan mesaj gönderin ancak /create eğik çizgi komutunu kullanın.

İletişim kutusunda Başlık'ı Issue Title 1 olarak ayarlayın.
Açıklama'yı Sorun Description 1 olarak ayarlayın.
Oluştur'u tıklayın.

Uygulama şunları yapar:

İletişim kutusunu kapatır.
Yeni oluşturulan soruna ayrılmış ve aynı başlığa sahip bir alan oluşturur.
Yeni oluşturulan alana katılır.
Yeni oluşturulan alanda sorunun açıklamasını içeren bir mesaj gönderir.
Yeni oluşturulan alanın bağlantısını içeren bir doğrudan mesaj gönderir.

Yeni oluşturulan alanda, /close eğik çizgi komutunu ve Not reproducible gibi bir çözünürlüğü içeren bir mesaj gönderin.

Uygulama şunları yapar:

Google Dokümanlar'da bir rapor dokümanı oluşturur.
Soruna ayrılmış alana, yeni oluşturulan rapor dokümanının bağlantısını içeren bir mesaj gönderir.

Rapor dokümanını açın. Temel bilgiler, geçmiş ve özet yer alır.

4. İsteğe bağlı: 1. uygulama: Uygulama ana sayfasını ekleme

Kavramları inceleme

Uygulama ana sayfası, bir sohbet uygulamasının, kullanıcı sohbet uygulamasıyla doğrudan mesajlaşırken Ana Sayfa sekmesine eriştiğinde gönderdiği özelleştirilebilir bir kart mesajıdır. Bu mesaj genellikle uygulama dokümanlarını veya genel bir bakışı göstermek için kullanılır. Teknik olarak, ele alınması gereken özel bir etkinlik vardır ve bu etkinlik, kart mesajlarıyla aynı temel ilkelere dayanır.

İnceleme akışları

Sorunları yönetme

Kaynak kodunu inceleme

Apps Komut Dosyası projesinin düzenlenmesi gerekiyor.

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 projesini güncelleme

Google Cloud Console'da şu adımları uygulayın:

Etkileşimli özellikler bölümünde Uygulama ana sayfasını destekle onay kutusunu işaretleyin.

Yerel ortamınızda şu adımları uygulayın:

Terminalinizdeki mevcut dizini issue-management/2-app-home olarak değiştirin. Kullanmanız gereken kaynak kodu içerir.
issue-management/1-baseline/.clasp.json dosyasını geçerli dizininize kopyalayın.
issue-management/1-baseline/Configuration.js dosyasını mevcut dizininize kopyalayarak mevcut dosyanın yerine geçmesini sağlayın.
Aşağıdaki komutu çalıştırın:

clasp push

Deneyin

Google Chat'te şu adımları uygulayın:

Uygulamaya /create eğik çizgi komutuyla doğrudan mesaj gönderin. Uygulama bir iletişim kutusu açar.
Başlık'ı Issue Title 2 olarak ayarlayın.
Açıklama'yı Sorun Description 2 olarak ayarlayın.
Oluştur'u tıklayın.

Google Chat uygulamasında alanınızdan Ana Sayfa sekmesini seçin. Oluşturduğunuz sorunların ayrıntılarını görebilirsiniz.

5. İsteğe bağlı: 1. uygulama: Alan izleme ekleme

Kavramları inceleme

Pub/Sub

Pub/Sub, eşzamansız ve ölçeklenebilir bir mesajlaşma hizmetidir. Mesaj üreten hizmetleri, bu mesajları işleyen hizmetlerden ayırır. Pub/Sub, yayıncılar ve aboneler olarak adlandırılan etkinlik üreticisi ve tüketicisi sistemleri oluşturmanıza olanak tanır. Yayıncılar, eşzamanlı uzak prosedür çağrıları (RPC'ler) yerine etkinlik yayınlayarak abonelerle eşzamansız şekilde iletişim kurar.

Yayıncılar, bu etkinliklerin nasıl veya ne zaman işleneceğine bakılmaksızın etkinlikleri Pub/Sub hizmetine gönderir. Ardından Pub/Sub, etkinlikleri yanıt veren tüm hizmetlere yayınlar. RPC'ler aracılığıyla iletişim kuran sistemlerde yayıncıların, verileri alması için aboneleri beklemesi gerekir. Ancak Pub/Sub'daki eşzamansız entegrasyon, genel sistemin esnekliğini ve sağlamlığını artırır.

Konu: Mesaj feed'ini temsil eden adlandırılmış bir kaynak. Yayınlayabilmek veya abone olabilmek için önce bir konu oluşturmanız gerekir.

Abonelik: Bir konuda yayınlanan mesajları almak için ilgili konuya abone olmanız gerekir. Abone istemci, konuya yayınlanan mesajları alır ve işler. Bir konunun birden fazla aboneliği olabilir ancak belirli bir abonelik tek bir konuya aittir.

Google Workspace etkinlikleri

Google Workspace etkinlikleri, kaynakların oluşturulması, güncellenmesi veya silinmesi gibi Google Workspace kaynaklarında yapılan değişiklikleri ifade eder. Uygulamalar, ilgili etkinlikleri asenkron olarak almak ve işlemek için Google Workspace kaynaklarına abone olabilir.

Google Workspace Events API, etkinlikleri bir uygulamaya abonelik üzerinden şu şekilde iletir:

Uygulama, Google Workspace uygulamasındaki bir kaynağa (ör. alan) abone olur.
Uygulamanın abone olduğu kaynak değişir.
Google Workspace uygulaması, Pub/Sub'daki bir konuya etkinlik gönderir. Bu konu, uygulamanın Google Workspace aboneliğinin bildirim uç noktası olarak işlev görür. Etkinlik, kaynakta değişenlerle ilgili verileri içerir.
Uygulama, etkinliği içeren Pub/Sub mesajını işler ve gerekirse işlem yapar.

İnceleme akışları

Sorun oluşturma (güncelleme)

Özel alandaki sorunu giderme (güncelleme)

Özel alandan sorunu kapatma (güncelleme)

Abonelikleri işleme

Kaynak kodunu inceleme

Apps Komut Dosyası projesinin düzenlenmesi gerekiyor.

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 projesini güncelleme

API'leri etkinleştirme

Google Cloud Console'da Google Workspace Events ve PubSub'ı etkinleştirin.

Menü ☰ > API'ler ve hizmetler > Etkin API'ler ve hizmetler'i tıklayın ve her ikisinin de etkinleştirildiğini doğrulayın.

Aboneliği başlatma

Tüm çalışma alanı etkinliklerinin yayınlanması için bir Pub/Sub konusu oluşturup bu konuya abone olmanız gerekir.

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > Pub/Sub > Konular'a gidin.

Create topic'i (Konu oluştur) tıklayın.
Konu kimliği'ni workspace-events olarak ayarlayın.
Varsayılan abonelik ekle onay kutusunu işaretleyin.
Oluştur'u tıklayın.

Google Chat'ten yeni oluşturduğunuz konuda Pub/Sub mesajları yayınlama erişimi vermek için aşağıdaki adımları uygulayın:

Listeden konuyu seçin.
İzinler sekmesini seçin.
chat-api-push@system.gserviceaccount.com öğesini New principals (Yeni ana hesaplar) listesine ekleyin.
Rol için Pub/Sub Yayıncısı'nı seçin.
Kaydet'i tıklayın.

Apps Komut Dosyası projesini güncelleme

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > IAM & Admin > Ayarlar'a gidin.

Proje kimliğini kopyalayın.

Yerel ortamınızda şu adımları uygulayın:

Terminalinizdeki mevcut dizini issue-management/3-message-monitoring olarak değiştirin. Gerekli kaynak kodunu içerir.
Configuration.js dosyasındaki PROJECT_ID adlı dize sabitini kopyalanan proje kimliğine ayarlayın.
Configuration.js dosyasındaki CHAT_CREDENTIALS adlı JSON sabitini, daha önce indirdiğiniz özel anahtar dosyası içeriğine ayarlayın.
issue-management/2-app-home/.clasp.json dosyasını geçerli dizininize kopyalayın.
Aşağıdaki komutu çalıştırın:

clasp push

Deneyin

Google Chat'te şu adımları uygulayın:

Uygulamaya /create eğik çizgi komutuyla doğrudan mesaj gönderin. Uygulama bir iletişim kutusu açar.
Başlık'ı Issue Title 3 olarak ayarlayın.
Açıklama'yı Sorun Description 3 olarak ayarlayın.
Oluştur'u tıklayın.
Yeni oluşturulan alanda, sorunla ilgili birkaç mesaj gönderin.
/close eğik çizgi komutu ve Fixed gibi bir çözünürlükle mesaj gönderin.

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > Pub/Sub > Abonelikler'e gidin.

workspace-events-sub aboneliğini seçin.
Mesajlar sekmesini seçin.
Çek'i tıklayın. Tabloda, yeni oluşturulan alana gönderdiğiniz içeriklerle ilgili mesajlar gösterilir.

Apps Komut Dosyası Konsolu'nda şu adımları uygulayın:

Projenizi seçin.
Düzenleyen'i seçin.
WorkspaceEvent.gs dosyasını seçin.
Çalıştır bölümünde processSubscription simgesini seçin.
Run simgesini tıklayın.Yürütme günlüğünden mesajların işlendiğini görebilirsiniz.

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > Pub/Sub > Abonelikler'e gidin.

workspace-events-sub aboneliğini seçin.
Mesajlar sekmesini seçin.
Çek'i tıklayın. Tabloda, yeni oluşturulan alana gönderdiğiniz içerikle ilgili mesajlar artık gösterilmez.

Google Chat'te, eğik çizgi komutu /create ile oluşturduğunuz üçüncü soruna ayrılmış alanda, sorunla ilgili birkaç mesaj daha gönderin.

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > Pub/Sub > Abonelikler'e gidin.

workspace-events-sub aboneliğini seçin.
Mesajlar sekmesini seçin.
Çek'i tıklayın. Tabloda, yeni oluşturulan alana gönderdiğiniz içeriklerle ilgili mesajlar gösterilmez.

6. İsteğe bağlı: 1. uygulama: Kapsayıcılıkla ilgili yardım ekleme

Kavramları inceleme

Üretken yapay zeka istemi, üretken yapay zeka modelini istenen belirli çıkış türüne yönlendirmek için talimat veya soru oluşturma sanatıdır. İstemlere kural ve koşul ekleyerek yanıtları sınırlamak yaygın bir uygulamadır. Bu sayede, çıkışın güvenli, alakalı, tutarlı ve beklentilere uygun olması sağlanabilir.

İnceleme akışları

Abonelikleri işleme (güncelleme)

Kaynak kodunu inceleme

Apps Komut Dosyası projesinin düzenlenmesi gerekiyor.

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 Komut Dosyası projesini güncelleme

Yerel ortamınızda şu adımları uygulayın:

Terminalinizdeki mevcut dizini issue-management/4-inclusivity-help olarak değiştirin. İhtiyacınız olan kaynak kodu içerir.
issue-management/3-message-monitoring/.clasp.json dosyasını geçerli dizininize kopyalayın.
issue-management/3-message-monitoring/Configuration.js dosyasını mevcut dizininize kopyalayarak mevcut dosyanın yerine geçmesini sağlayın.
Aşağıdaki komutu çalıştırın:

clasp push

Deneyin

Google Chat'te şu adımları uygulayın:

Uygulamaya /create eğik çizgi komutuyla doğrudan mesaj gönderin. Uygulama bir iletişim kutusu açar.
Başlık'ı Issue Title 4 olarak ayarlayın.
Açıklama'yı Sorun Description 4 olarak ayarlayın.
Oluştur'u tıklayın.
Yeni oluşturulan alanda It happened to me last week as well gönderin.

Apps Komut Dosyası Konsolu'nda şu adımları uygulayın:

Projenizi seçin.
Düzenleyen'i seçin.
WorkspaceEvent.gs dosyasını seçin.
Çalıştır bölümünde processSubscription simgesini seçin.
Çalıştır'ı tıklayın. Yürütme günlüğünden, mesajların işlendiğini görebilirsiniz.

Google Chat'te şu adımları uygulayın:

Uygulamanın, yeni oluşturulan alanda kapsayıcılıkla ilgili herhangi bir yardım göndermediğini fark edeceksiniz.
Yeni oluşturulan alanda mesajı gönderin I had to add myself from the master to fix it.

Apps Komut Dosyası Konsolu'nda şu adımları uygulayın:

Projenizi seçin.
Düzenleyen'i seçin.
WorkspaceEvent.gs dosyasını seçin.
Çalıştır bölümünde processSubscription simgesini seçin.
Çalıştır'ı tıklayın. Yürütme günlüğünden, mesajların işlendiğini görebilirsiniz. Uygulama, Google Chat'te yeni oluşturulan alana kapsayıcılıkla ilgili bir yardım mesajı gönderdi.

7. İsteğe bağlı: 1. uygulama: Tercih ekleme

Kavramları inceleme

Aksesuar widget'ı, bir uygulama tarafından gönderilen mesajın altına eklenen, kenarlığı olmayan bir widget'tır. Genellikle kullanıcının mesaj bağlamında hızlı tepki vermesini sağlamak için kullanılır. Teknik olarak, kart düğmeleriyle aynı temel ilkelere dayanır.

İnceleme akışları

Kapsayıcılık yardımını devre dışı bırakma

Kaynak kodunu inceleme

Apps Komut Dosyası projesinin düzenlenmesi gerekiyor.

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 Komut Dosyası projesini güncelleme

Yerel ortamınızda şu adımları uygulayın:

Terminalinizdeki mevcut dizini issue-management/5-disable-help olarak değiştirin. Gerekli kaynak kodunu içerir.
issue-management/4-inclusivity-help/.clasp.json dosyasını geçerli dizininize kopyalayın.
issue-management/4-inclusivity-help/Configuration.js dosyasını mevcut dizininize kopyalayarak mevcut dosyanın yerine geçmesini sağlayın.
Aşağıdaki komutu çalıştırın:

clasp push

Deneyin

Yardımı devre dışı bırakma

Google Chat'te, eğik çizgi komutu /create ile oluşturduğunuz dördüncü sayıya ayrılmış alanda I had to add myself from the master to fix mesajını gönderin.

Apps Komut Dosyası Konsolu'nda şu adımları uygulayın:

Projenizi seçin.
Düzenleyen'i seçin.
WorkspaceEvent.gs dosyasını seçin.
Çalıştır bölümünde processSubscription simgesini seçin.
Çalıştır'ı tıklayın. Yürütme günlüğünden, mesajların işlendiğini görebilirsiniz.

Google Chat'te şu adımları uygulayın:

Uygulamanın, aksesuar widget'ıyla ilgili soruna ayrılmış alana kapsayıcılıkla ilgili yardım içeren bir mesaj gönderdiğini fark edin.
Kapsayıcılık yardımını devre dışı bırakmak için aksesuar widget'ını tıklayın.

Çekle ödeme özelliğinin devre dışı bırakılması

Google Chat'te, eğik çizgi komutu /create ile oluşturduğunuz dördüncü sayıya ayrılmış alanda I had to add myself from the master to fix mesajını gönderin.

Apps Komut Dosyası Konsolu'nda şu adımları uygulayın:

Projenizi seçin.
Düzenleyen'i seçin.
WorkspaceEvent.gs dosyasını seçin.
Çalıştır bölümünde processSubscription simgesini seçin.
Çalıştır'ı tıklayın. Yürütme günlüğünden, mesajların işlendiğini görebilirsiniz. Google Chat'te, kapsayıcılıkla ilgili yardım mesajı, devre dışı bırakıldığı için soruna ayrılmış alana gönderilmedi.

8. 2. uygulama: Build

Kavramları inceleme

Üretken yapay zeka temellendirmesi

Bu, yapay zeka modellerini doğrulanabilir bilgi kaynaklarına bağlayarak daha doğru ve güvenilir hale getirmekle ilgilidir. Bu teknik, yapay zekanın bilgi uydurmasını önlemeye yardımcı olur ve yanıtların bağlamsal olarak alakalı ve daha az taraflı olmasını sağlayabilir.

Doğal dil

Yapay veya bilgisayar tabanlı dillerin aksine, insanların günlük iletişim için konuştuğu veya yazdığı herhangi bir dil.

Cloud Storage

Cloud Storage, her büyüklükteki verilerin herhangi bir zamanda tüm dünyada depolanmasına ve alınmasına olanak tanır. Web sitesi içeriği sunma, arşiv ve olağanüstü durum kurtarma amacıyla veri depolama veya doğrudan indirme yoluyla büyük veri nesnelerini kullanıcılara dağıtma gibi çeşitli senaryolar için kullanılabilir.

Dialogflow CX veri deposu

Dialogflow CX, veri depolarıyla entegre olur. Veri depoları, veri deposu aracıları tarafından son kullanıcının sorularına belirli verilerden yanıt bulmak için kullanılan web siteleri ve belgeler koleksiyonlarıdır. Veri deposu aracısı, belirli bir soru için verilen kaynak içerikte yanıt arar ve bulguları tutarlı bir yanıt şeklinde özetler. Ayrıca, son kullanıcının daha fazla bilgi edinmesi için yanıtın kaynaklarına destekleyici bağlantılar da sağlar.

Mimarinin gözden geçirilmesi

Bu Google Chat sohbet uygulaması Dialogflow CX ile oluşturulmuştur ve aşağıdaki şekilde çalışır:

Bir kullanıcı, uygulamaya doğrudan mesaj yoluyla veya bir alanda mesaj gönderir.
Dialogflow CX temsilcisi olan ve bir Google Cloud projesiyle ilişkilendirilmiş uygulama, mesajı işler.
Uygulama, Cloud Storage'da bulunan bir veri deposuyla entegre olur.
Uygulama, doğrudan mesaj yoluyla veya orijinal alanda eşzamanlı bir yanıt gönderir.

Akışları inceleme

Soruyu yanıtlayın

Kaynak kodunu inceleme

İhtiyacınız olan tek kaynak kod değil, temellendirme için kullandığınız verilerdir.

google-chat-overview.pdf

Google Chat uygulamalarının yapılandırılmamış bilgilerini, Google Workspace geliştiricileri web sitesindeki bir sayfanın yazdırılmış versiyonunu içerir.

Google Cloud projesini güncelleme

Google Cloud Console'da şu adımları uygulayın:

Dialogflow ve Cloud Storage API'lerini etkinleştirin.

Vertex AI Agent Builder API'yi etkinleştirin.

Menü ☰ > API'ler ve hizmetler > Etkin API'ler ve hizmetler'i tıklayın ve tüm API'lerin etkinleştirildiğini doğrulayın.

Dialogflow CX veri deposu aracısı oluşturma

Bilgi verilerini başlatma

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > Cloud Storage > Paketler'i tıklayın.

Oluştur'u tıklayın.
Ad'ı gchat-knowledge olarak ayarlayın.
Oluştur'u tıklayın.

gchat-knowledge paketini seçin.
Dosyaları yükle'yi tıklayın.
Yerel ortamınızdan google-chat-overview.pdf dosyasını indirip seçin.

Uygulama oluşturma

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > Agent Builder > Uygulamalar'ı tıklayın.

Yeni uygulama'yı tıklayın.
Chat türünü seçin.

Company name alanına şirket adınızı girin.
Agent name öğesini knowledge olarak ayarlayın.
Devam'ı tıklayın.

Yeni veri deposu oluştur'u tıklayın.
Veri kaynağı olarak Cloud Storage'ı seçin.

Dosya'yı seçin.
Göz at'ı tıklayın.
google-chat-overview.pdf dosyasını seçin.
Devam'ı tıklayın.
Veri deposu adını gchat-knowledge-ds olarak ayarlayın.
Oluştur'u tıklayın.

Tabloda gchat-knowledge-ds veri deposunu seçin.
Oluştur'u tıklayın.

Birkaç dakika sonra Menü ☰ > Agent Builder > Uygulamalar'ı tıklayın. Uygulamayı görebilirsiniz.

Menü ☰ > Agent Builder > Veri depoları'nı tıklayın.

gchat-knowledge-ds veri deposunu tıklayın. Doküman sayısı 1'dır. Bu, dokümanın hazır olduğunu gösterir.

Uygulamayı tamamlama ve test etme

Dialogflow CX konsolunda şu adımları uygulayın:

Google Cloud projenizi seçin.
Bilgi aracısını seçin.

Aracı ayarları > Üretken yapay zeka > Üretken aracı'yı seçin.
Modeli Text Bison'dan Gemini Pro'ya değiştirin.
Kaydet'i tıklayın.

Test agent'ı (Test aracısı) tıklayın.
What is Google Chat? gönderin. Müşteri temsilcisi anlamlı bir yanıt veriyor.

Google Chat uygulamasını entegre etme

Dialogflow CX konsolunda şu adımları uygulayın:

Google Cloud projenizi seçin.
Bilgi aracısının satırında > Adı kopyala'yı tıklayın.

Google Cloud Console'da şu adımları uygulayın:

Google Chat API yapılandırmasına gidin.

Bağlantı ayarları bölümünde Dialogflow'u seçin.
Dialogflow ayarları bölümünde Dialogflow CX'i seçin.
Temsilci veya Ortam kaynak adı'nı kopyaladığınız temsilci adına ayarlayın.
İki eğik çizgi komutunu kaldırın.

Google Chat'te, Google Chat uygulamasına doğrudan mesaj olarak What is Google Chat? gönderin. Temsilci, anlamlı bir yanıt verir.

9. İsteğe bağlı: 2. uygulama: Kaynak ekleme

Kavramları inceleme

Dialogflow CX webhook'u

İşletme mantığını barındıran veya diğer hizmetleri çağıran bir hizmet. Webhook'lar, Dialogflow CX oturumu sırasında doğal dil işleme tarafından çıkarılan verileri kullanarak dinamik yanıtlar oluşturabilir, toplanan verileri doğrulayabilir veya arka uçta işlemleri tetikleyebilir.

Cloud Functions

Cloud Functions, sunucusuz arka uçlar oluşturmak, gerçek zamanlı veri işleme yapmak ve akıllı uygulamalar oluşturmak için idealdir. Sağlama, yönetim, yama uygulama veya güncelleme için sunucu gerekmez. Otomatik olarak ölçeklendirilir, yüksek düzeyde kullanılabilir ve hatadan etkilenmez.

Akışları inceleme

Soruyu yanıtlama (güncelleme)

Kaynak kodunu inceleme

İhtiyacınız olan tek kaynak kodu, aracı yanıtlarını Google Chat mesajlarına uyarlayan işlevdir. Webhook olarak kullanılır.

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 projesini güncelleme

Google Cloud Console'da şu adımları uygulayın:

Cloud Build, Cloud Functions, Cloud Logging, Artifact Registry ve Cloud Run API'lerini etkinleştirin.

Menü ☰ > API'ler ve hizmetler > Etkin API'ler ve hizmetler'i tıklayın ve API'lerin etkinleştirildiğini doğrulayın.

Dialogflow CX veri deposu aracısını güncelleme

Bir Cloud Functions işlevi dağıtmanız ve mümkün olduğunda birden fazla kaynakla tetiklemek için Dialogflow CX webhook'unu güncellemeniz gerekir.

Birden fazla kaynak döndürme

Varsayılan olarak, yeni bir veri deposu aracısı en fazla bir kaynak döndürür ancak bunu daha fazla kaynak döndürecek şekilde değiştirebilirsiniz.

Dialogflow CX konsolunda şu adımları uygulayın:

Google Cloud projenizi seçin.
Bilgi aracısını seçin.
Başlangıç sayfası'nı seçin.
Veri depolarını düzenle'yi seçin.
Aracı yanıtları bölümünde, Veri deposu yanıt seçenekleri'ni 5 olarak ayarlayın.
Kaydet'i tıklayın.

Cloud Function'ı başlatma

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > Cloud Functions'ı tıklayın.

Create function'ı (İşlev oluştur) tıklayın.
Temel bilgiler bölümünde ad'ı function-1 olarak ayarlayın.
Kimlik doğrulama bölümünde Kimliği doğrulanmayan çağrılara izin ver radyo düğmesini seçin.
Çalışma zamanı, derleme, bağlantılar ve güvenlik ayarları bölümünde Maksimum örnek sayısı'nı 3 olarak ayarlayın.
İleri'yi tıklayın.

Giriş noktası'nı agent-response-adapter olarak ayarlayın.
Varsayılan içeriği package.json ve index.js dosyalarıyla değiştirin.
Dağıt'ı tıklayın.

İşlevin dağıtılması için birkaç dakika beklerken URL'yi kopyalayın.

Webhook'u başlatma

Yeni dağıtılan işlevi tetikleyen bir webhook kullanmak için Dialogflow CX aracısını yapılandırmanız gerekir.

Dialogflow CX konsolunda şu adımları uygulayın:

Google Cloud projenizi seçin.
Bilgi aracısını seçin.
Yönet > Web kancaları > Oluştur'u seçin.
Görünen ad'ı Google Chat Response Adapter olarak ayarlayın.
Webhook URL'sini daha önce kopyaladığınız URL olarak ayarlayın.
Kaydet'i tıklayın.

Build'ı (Derle) tıklayın.
Başlangıç sayfası'nı seçin.
Veri depolarını düzenle'yi seçin.
Webhook ayarları bölümünde Webhook'u etkinleştir açma/kapatma düğmesini tıklayın.
Google Chat Response Adapter for Webhook'u seçin.
Etiketi arbitrary_tag olarak ayarlayın.
Kaydet'i tıklayın.

Test uygulaması

Google Chat'te, Google Chat uygulamasına doğrudan mesaj olarak What is Google Chat? gönderin. Temsilci, anlamlı bir yanıt ve varsa kaynakların yer aldığı bir kartla yanıt verir.

10. 3. uygulama: Build

Kavramları inceleme

Sohbet etkileşimleri

Bunlar, doğal dil aracılığıyla iki veya daha fazla kişi arasında bilgi ya da fikir alışverişidir. Bu durum, genellikle durum bilgisiz, son derece yapılandırılmış ve toleranssız değişimlere dayanan teknik arayüzlerle çelişir.

OpenAPI Specification

API yaşam döngüsünün her aşamasında bilgilerin tutarlı bir şekilde aktarılmasını sağlar. Bu, HTTP API'leri için bir spesifikasyon dilidir. Yapıyı ve söz dizimini, API'nin oluşturulduğu programlama diline bağlı olmayacak şekilde tanımlar. API spesifikasyonları genellikle YAML veya JSON ile yazılır. Bu sayede spesifikasyonun kolayca paylaşılması ve kullanılması sağlanır.

Dialogflow CX aracısı

Aracı uygulamalarının temel yapı taşıdır. Aracı uygulamalarında genellikle birçok aracı bulunur. Her aracı, belirli görevleri yerine getirmek üzere tanımlanır. LLM'ye aracı verileri sağlanır. Böylece LLM, soruları yanıtlamak ve görevleri yürütmek için ihtiyaç duyduğu bilgilere sahip olur. Her temsilci bilgi sağlayabilir, harici hizmetlere sorgu gönderebilir veya alt görevleri işlemek için sohbet işlemeyi bir Dialogflow CX akışına ya da başka bir temsilciye erteleyebilir.

Dialogflow CX aracı

Araçlar, aracı uygulamalarını harici sistemlere bağlamak için kullanılır. Bu sistemler, aracı uygulamalarının bilgilerini artırabilir ve karmaşık görevleri verimli bir şekilde yürütmelerini sağlayabilir.

Mimarinin gözden geçirilmesi

Bu Google Chat sohbet uygulaması Dialogflow CX ile oluşturulmuştur ve aşağıdaki şekilde çalışır:

Bir kullanıcı, uygulamaya doğrudan mesaj yoluyla veya bir alanda mesaj gönderir.
Dialogflow CX temsilcisi olan ve bir Google Cloud projesiyle ilişkilendirilmiş uygulama, mesajı işler.
Uygulama, bir temsilciyle entegre olmalıdır.
Uygulama, doğrudan mesaj yoluyla veya orijinal alanda eşzamanlı bir yanıt gönderir.

Akışları inceleme

Yorum toplama

Kaynak kodunu inceleme

İhtiyacınız olan tek kaynak kodu, aracının araç olarak kullandığı arka uç hizmetini taklit etme işlevidir.

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

Arka uç hizmeti sahtesini başlatma

Dialogflow CX temsilci uygulamasının entegre etmesi ve araç olarak çağırması gereken bir arka uç hizmetini simüle etmek için Cloud Functions işlevi dağıtırsınız.

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > Cloud Functions'ı tıklayın.

Create function'ı (İşlev oluştur) tıklayın.
Temel bilgiler bölümünde ad'ı function-2 olarak ayarlayın.
Kimlik Doğrulama bölümünde Kimliği doğrulanmayan çağrılara izin ver radyo düğmesini seçin.
Çalışma zamanı, derleme, bağlantılar ve güvenlik ayarları bölümünde Maksimum örnek sayısı'nı 3 olarak ayarlayın.
İleri'yi tıklayın.

Giriş noktası'nı feedback-app-backend olarak ayarlayın.
Varsayılan içeriği package.json ve index.js dosyalarıyla değiştirin.
Dağıt'ı tıklayın.

İşlevin dağıtılması için birkaç dakika beklerken URL'yi kopyalayın.

Dialogflow CX aracısı uygulaması oluşturma

Uygulama oluşturma

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > Agent Builder > Uygulamalar'ı tıklayın.

Yeni uygulama'yı tıklayın.
Agent'ı (Ajan) seçin.
Görünen ad'ı Feedback App olarak ayarlayın.
Oluştur'u tıklayın.

Aracı başlatma

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > Agent Builder > Uygulamalar'ı tıklayın.

Geri Bildirim Uygulaması aracısını seçin.
Araçlar > + Oluştur'u tıklayın.
Name (Ad) öğesini review olarak ayarlayın.
OpenAPI'yi seçin.
description değerini aşağıdaki gibi ayarlayın:

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

service-openapi.yaml dosyasında $URL değerini indirip daha önce kopyaladığınız URL ile değiştirin.
YAML Schema değerini service-openapi.yaml dosyasının düzenlenmiş içeriği olarak ayarlayın.
Kaydet'i tıklayın.

Aracıyı başlatma

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > Agent Builder > Uygulamalar'ı tıklayın.

Geri Bildirim Uygulaması aracısını seçin.
Aracılar > Varsayılan Üretken Yapay Zeka Aracı'nı seçin.
Agent name (Aracı adı) değerini Feedback collector olarak ayarlayın.
goal değerini aşağıdakine ayarlayın:

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.

instructions değerini aşağıdakine ayarlayın:

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.

Kaydet'i tıklayın.

Test uygulaması

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > Agent Builder > Uygulamalar'ı tıklayın.

Geri Bildirim Uygulaması aracısını seçin.
Ajanı önizle'ye gidin.
Aracı bölümünde Geri bildirim toplayıcı'yı seçin.
Üretken model seçin bölümünde gemini-pro'yu seçin.
Başlamak için Hello! mesajını gönderin.

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > Cloud Functions'ı tıklayın.

function-2 > Günlükler'i seçin. Bazı günlüklerde arayan olarak Google-Dialogflow gösteriliyor.

Google Chat uygulamasını entegre etme

Dialogflow CX konsolunda şu adımları uygulayın:

Google Cloud projenizi seçin.
Feedback App aracısının işlem menüsünü tıklayın.
Adı kopyala'yı tıklayın.

Google Cloud Console'da şu adımları uygulayın:

Google Chat API yapılandırmasına gidin.

Agent or Environment resource name (Aracı veya Ortam kaynak adı) alanını daha önce kopyaladığınız aracı adı olarak ayarlayın.

Başlamak için Google Chat'te Google Chat uygulamasına doğrudan mesaj olarak Hello! gönderin. Temsilci, Dialogflow CX konsolundaki testinize benzer şekilde yanıt verir.

11. Temizleme

Google Cloud projesini silme

Bu codelab'de kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini önlemek istiyorsanız Google Cloud projesini silmenizi öneririz.

Google Cloud Console'da şu adımları uygulayın:

Menü ☰ > IAM ve Yönetici > Ayarlar'ı tıklayın.

Kapat'ı tıklayın.
Proje kimliğini girin.
Yine de kapat'ı tıklayın.

Apps Komut Dosyası projesini silme

Apps Komut Dosyası projenizi de silmenizi öneririz.

Apps Komut Dosyası Konsolu'nda şu adımları uygulayın:

Projenizi seçin.
İşlem menüsünü tıklayın.
Kaldır'ı tıklayın.

12. Tebrikler

Tebrikler! Gemini ile Google Chat uygulamaları geliştirdiniz.

Yapabilecekleriniz

Bu codelab'de yalnızca basit kullanım alanları gösterilmiştir ancak Google Chat uygulamalarınızda dikkate almak isteyebileceğiniz birçok genişletme alanı vardır. Örneğin:

Özel olanlar da dahil olmak üzere diğer üretken yapay zeka modelleriyle entegrasyon
Ses, resim ve video gibi diğer medya türlerini destekler.
Çok formatlılık özelliğini kullanın.
Daha uzun bağlam pencerelerinden ve geri bildirim döngülerinden yararlanın.
Üretime hazır Google Chat uygulamalarını pazar yerinde yayınlayın. Geliştiriciler için YouTube videoları, doküman web siteleri, kod örnekleri ve eğitici içerikler gibi birçok kaynak mevcuttur.
Kuruluşunuz için Google Chat'i etkinleştirin. İçe aktarma modu özelliği, başlangıçta işinizi kolaylaştırır.

Gemini ile Google Chat için uygulamalar oluşturma

1. Başlamadan önce

Gemini'ı içeren Google Chat uygulamaları nedir?

Google Chat uygulamaları neden Gemini ile entegre edilmelidir?

Ön koşullar

Oluşturduğunuz içerikler

Sorun yönetimi uygulaması (içerik oluşturma ve geliştirme)

Bilgi uygulaması (veri arama)

Geri bildirim uygulaması (iletişim)

Öğrenecekleriniz

İhtiyacınız olanlar

2. Hazırlanın

Kaynakları başlatma

Apps Komut Dosyası projesi

Google Cloud projesi

Google Chat

Kaynak kodu ve kaynakları yerel olarak indirme

clasp yükleme ve yapılandırma

3. 1. uygulama: Oluşturma

Kavramları inceleme

Vertex AI

Gemini

Gelişmiş Chat hizmeti

Mimarinin gözden geçirilmesi

İnceleme akışları

Sorun oluşturma

Sorunları özel alandan giderme

Sorunu özel alandan kapatma

Kaynak kodunu inceleme

Google Cloud projesini güncelleme

API'leri etkinleştirme

Hizmet hesabını başlatma

Google Chat API yapılandırmasını güncelleme

Apps Komut Dosyası projesini güncelleme

Kaynak kodunu yapılandırma

clasp ayarlarını yapılandırma

Kaynak kodu gönderme

Deneyin

4. İsteğe bağlı: 1. uygulama: Uygulama ana sayfasını ekleme

Kavramları inceleme

İnceleme akışları

Sorunları yönetme

Kaynak kodunu inceleme

Google Cloud projesini güncelleme

Deneyin

5. İsteğe bağlı: 1. uygulama: Alan izleme ekleme

Kavramları inceleme

Pub/Sub

Google Workspace etkinlikleri

İnceleme akışları

Sorun oluşturma (güncelleme)

Özel alandaki sorunu giderme (güncelleme)

Özel alandan sorunu kapatma (güncelleme)

Abonelikleri işleme

Kaynak kodunu inceleme

Google Cloud projesini güncelleme

API'leri etkinleştirme

Aboneliği başlatma

Apps Komut Dosyası projesini güncelleme

Deneyin

6. İsteğe bağlı: 1. uygulama: Kapsayıcılıkla ilgili yardım ekleme

Kavramları inceleme

İnceleme akışları

Abonelikleri işleme (güncelleme)

Kaynak kodunu inceleme

Apps Komut Dosyası projesini güncelleme

Deneyin

7. İsteğe bağlı: 1. uygulama: Tercih ekleme

Kavramları inceleme

İnceleme akışları

Kapsayıcılık yardımını devre dışı bırakma

Kaynak kodunu inceleme

Apps Komut Dosyası projesini güncelleme

Deneyin

Yardımı devre dışı bırakma

Çekle ödeme özelliğinin devre dışı bırakılması

8. 2. uygulama: Build

Kavramları inceleme

Üretken yapay zeka temellendirmesi

Doğal dil

`clasp` yükleme ve yapılandırma

`clasp` ayarlarını yapılandırma