מדריך | הוספת צ'אט AI בגוגל צ'אט

[menachem fine]

המדריך‌​‌‌​‌​​​​​‌ נכתב בעמל והשקעה ללא AI קראו ברצינות כי כל פרט חשוב!

יצירת הפרוייקט

כנסו ל Google Apps Script
צרו פרויקט חדש ותנו לו שם (למשל: Gemini Chat Bot )

תבדקו שאתם פה

ויש לכם דף עם קוד של שורה או שתיים
תמחקו את מה שכתוב ותדביקו את זה

const GEMINI_API_KEY = "יש להדביק פה את הקוד שלכם";

function onMessage(event) {
  let userMessage = "";

  if (event && event.chat && event.chat.messagePayload && event.chat.messagePayload.message && event.chat.messagePayload.message.text) {
    userMessage = event.chat.messagePayload.message.text;
  } else if (event && event.messagePayload && event.messagePayload.message && event.messagePayload.message.text) {
    userMessage = event.messagePayload.message.text;
  } else if (event && event.message && event.message.text) {
    userMessage = event.message.text;
  } else if (event && event.message && event.message.argumentText) {
    userMessage = event.message.argumentText;
  }

  userMessage = userMessage ? userMessage.trim() : "";

  if (!userMessage) {
    return buildResponse("לא התקבל טקסט בהודעה.");
  }

  const replyText = callGeminiApi(userMessage);

  return buildResponse(replyText);
}

function buildResponse(text) {
  return {
    "hostAppDataAction": {
      "chatDataAction": {
        "createMessageAction": {
          "message": {
            "text": text
          }
        }
      }
    }
  };
}

function onAddedToSpace(event) {
  return buildResponse("שלום! אני הבוט של Gemini. איך אפשר לעזור?");
}

function onRemovedFromSpace(event) {
  Logger.log("Bot removed");
}

function callGeminiApi(promptText) {
  const modelsToTry = [
    "gemini-3.6-flash",
    "gemini-3.1-pro"
  ];

  const payload = {
    "system_instruction": {
      "parts": [
        { "text": "אתה עוזר טכני תמציתי וישיר. ענה תמיד בקצרה לעניין, בלי חפירות מיותרות." }
      ]
    },
    "contents": [
      {
        "parts": [
          { "text": promptText }
        ]
      }
    ]
  };

  const options = {
    "method": "post",
    "contentType": "application/json",
    "payload": JSON.stringify(payload),
    "muteHttpExceptions": true
  };

  for (let i = 0; i < modelsToTry.length; i++) {
    const modelName = modelsToTry[i];
    const url = `https://generativelanguage.googleapis.com/v1beta/models/${modelName}:generateContent?key=${GEMINI_API_KEY}`;

    try {
      const response = UrlFetchApp.fetch(url, options);
      const json = JSON.parse(response.getContentText());

      if (json.candidates && json.candidates[0] && json.candidates[0].content && json.candidates[0].content.parts[0].text) {
        return json.candidates[0].content.parts[0].text;
      }
      
      if (json.error && json.error.code !== 404) {
        return "שגיאה מ-Gemini API: " + json.error.message;
      }
    } catch (error) {
      Logger.log("Error with model " + modelName + ": " + error.toString());
    }
  }

  return "שגיאה: לא נמצא מודל Gemini זמין עבור המפתח שסופק.";
}

יצירת מפתח API

עכשיו תוציאו מפתח API מגוגל AI סטודיו
מדריך פשוט ומהיר כאן

תעתיקו את המפתח שיצרתם
|
|||

ותדביקו בשורה הראשונה של הקוד איפה שכתוב "יש להדביק פה את הקוד שלכם"
שימו לב לא למחוק את המרכאות לפני ואחרי וגם לא את זה - ; זה חשוב!
אז פשוט תדביקו בין המרכאות!

לחצו האייקון של השמירה בצד ימין למעלה (או לחילופין - ctrl+s)
ואז לחצו על 'לפריסה' (בצד שמאל למעלה)

Spoiler

ואז על 'פריסה חדשה'
ושם :
אפשר ככה -
ואפשר לעשות את זה פרטי.

(בתיאור לא משנה מה לכתוב...)
ואז לחצו על פריסה ואל תגעו עוד בעמוד!

#anchor(חיבור הקוד לממשק הגוגל צאט)
הכנסו לאתר הזה

בשורת החיפוש למעלה הקלידו Google Chat API ובחרו באפשרות הראשונה

Spoiler

אתם אמורים להגיע לדף הזה ולבחור Manage:

ואז:

גלגלו ל Application info
בשורה הראשונה שימו את השם של הבוט למשל: Gemini Bot
בשורה השנייה שימו קישור לתמונה של הבוט למשל: https://developers.google.com/chat/images/quickstart-app-avatar.png
ובשורה השלישית: AI Assistant

גלגלו עוד טיפה לInteractive features
ותוודאו שזה המצב

רדו עוד טיפה לConnection settings
ושם תוודאו:

עכשיו חזרו לפרויקט שלכם ב Google Apps Script איפה שעזבתם והעתיקו את מזהה הפריסה

Spoiler

חזרו לדף הקודם ובשורה למטה של Deployment ID איפה שעצרתם הדביקו את מזהה הפריסה
המשיכו לגלגל עד למטה ולחצו על save

Spoiler

עכשיו לכו לגוגל צאט שלכם, לחצו על צאט חדש והקלידו בשורת החיפוש את השם שנתתם לבוט

Spoiler

לא שם הפרויקט אלא שם הבוט!

והוא יופיע לכם!!!
התחילו שיחה!!!

אשמח מאוד לשמוע תגובות ושיפור כי גם אני בשלב הבדיקות....

הכיף הוא שכל אחד יוצר בעצמו בוט!