Быстрый старт: Создание текста с помощью Vertex AI

На этой странице объясняется, как использовать расширенный сервис Vertex AI в Apps Script для того, чтобы заставить модель Gemini 2.5 Flash генерировать текст.

Чтобы узнать больше о расширенном сервисе Vertex AI, ознакомьтесь с справочной документацией .

Текст, сгенерированный искусственным интеллектом с помощью передового сервиса Vertex AI от Apps Script.
Рисунок 1. Ответ службы Vertex AI в журнале выполнения Apps Script.

Цели

  • Настройте свою среду.
  • Создайте проект Apps Script, использующий расширенный сервис Vertex AI.
  • Запустите скрипт для генерации текста.

Предварительные требования

Настройте свою среду

В этом разделе объясняется, как настроить и подготовить среду в консоли Google Cloud и Apps Script.

Включите API Vertex AI в своем облачном проекте.

  1. В консоли Google Cloud откройте свой проект Google Cloud и включите API Vertex AI:

    Включить API

  2. Убедитесь, что вы включаете API в правильном облачном проекте, затем нажмите «Далее» .

  3. Убедитесь, что вы включаете правильный API, затем нажмите «Включить» .

Создайте и настройте свой проект Apps Script.

Для создания и настройки проекта Apps Script выполните следующие шаги:

  1. Перейдите на script.google.com .
  2. Нажмите «Создать проект» , чтобы создать проект Apps Script.
  3. В левом верхнем углу нажмите «Безымянный проект» .
  4. Назовите свой скрипт Vertex AI quickstart и нажмите «Переименовать» .

Настройте расширенную службу Vertex AI.

Для активации расширенного сервиса Vertex AI и настройки кода выполните следующие действия:

  1. В редакторе скриптов перейдите в раздел «Службы» и нажмите «Добавить службу». Значок для добавления услуги .
  2. В выпадающем меню выберите Vertex AI API и нажмите «Добавить» .

  3. Откройте файл Code.gs и замените его содержимое следующим кодом:

    /**
 * Main entry point to test the Vertex AI integration.
 */
function main() {
  const prompt = 'What is Apps Script in one sentence?';

  try {
    const response = callVertexAI(prompt);
    console.log(`Response: ${response}`);
  } catch (error) {
    console.error(`Failed to call Vertex AI: ${error.message}`);
  }
}

/**
 * Calls the Vertex AI Gemini model.
 *
 * @param {string} prompt - The user's input prompt.
 * @return {string} The text generated by the model.
 */
function callVertexAI(prompt) {
  // Configuration
  const projectId = 'GOOGLE_CLOUD_PROJECT_ID';
  const region = 'us-central1';
  const modelName = 'gemini-2.5-flash';

  const model = `projects/${projectId}/locations/${region}/publishers/google/models/${modelName}`;

  const payload = {
    contents: [{
      role: 'user',
      parts: [{
        text: prompt
      }]
    }],
    generationConfig: {
      temperature: 0.1,
      maxOutputTokens: 2048
    }
  };

  // Execute the request using the Vertex AI Advanced Service
  const response = VertexAI.Endpoints.generateContent(payload, model);

  // Use optional chaining for safe property access
  return response?.candidates?.[0]?.content?.parts?.[0]?.text || 'No response generated.';
}

    Замените GOOGLE_CLOUD_PROJECT_ID на идентификатор вашего облачного проекта.

  4. Нажмите «Сохранить». значок сохранения .

Протестируйте скрипт

  1. В редакторе скриптов нажмите кнопку «Выполнить» , чтобы запустить main функцию.
  2. При появлении запроса авторизуйте выполнение скрипта.
  3. Нажмите «Журнал выполнения» , чтобы просмотреть ответ от Vertex AI.

Vertex AI возвращает ответ на вопрос: What is Apps Script in one sentence? . Например, журнал выполнения возвращает ответ следующего вида:

Response: Google Apps Script is a cloud-based, JavaScript platform that lets you
automate, integrate, and extend Google Workspace applications like Sheets, Docs,
and Gmail.

Уборка

Чтобы избежать списания средств с вашего аккаунта Google Cloud за ресурсы, использованные в этом руководстве, мы рекомендуем удалить проект Cloud.

  1. В консоли Google Cloud перейдите на страницу «Управление ресурсами» > IAM и администрирование > Управление ресурсами .

    Перейдите в Диспетчер ресурсов

  2. В списке проектов выберите проект, который хотите удалить, и нажмите кнопку «Удалить .
  3. В диалоговом окне введите идентификатор проекта, а затем нажмите «Завершить» , чтобы удалить проект.

Чтобы избежать списания средств с вашего аккаунта Google Cloud за ресурсы, использованные в этом кратком руководстве, мы рекомендуем удалить проект Cloud.