Сервис искусственного интеллекта Vertex

Сервис Vertex AI позволяет использовать API Vertex AI в Apps Script. Этот API предоставляет доступ к Gemini и другим моделям генеративного ИИ для генерации текста, изображений и многого другого.

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

• Проект Google Cloud с включенной оплатой. Чтобы проверить, включена ли оплата в существующем проекте, см. раздел «Проверка статуса оплаты ваших проектов ». Чтобы создать проект и настроить оплату, см. раздел «Создание проекта Google Cloud» .

• В консоли Google Cloud перейдите к своему проекту Cloud и включите API Vertex AI:

  Включить API

• Настройте свой проект Apps Script:

  • Включите сервис Vertex AI. Инструкции см. в разделе «Расширенные сервисы Google» .
  • В настройках проекта добавьте свой облачный проект .

Ссылка

Для получения дополнительной информации об этом сервисе см. справочную документацию по API Vertex AI . Как и все расширенные сервисы в Apps Script, сервис Vertex AI использует те же объекты, методы и параметры, что и публичный API.

Пример кода

В приведенном ниже примере кода используется версия 1 API Vertex AI.

Сгенерировать текст

Этот пример кода показывает, как заставить модель Gemini 2.5 Flash генерировать текст. Функция возвращает результат в журнал выполнения Apps Script.

/**
 * 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 на идентификатор вашего облачного проекта.