سرویس هوش مصنوعی ورتکس

سرویس هوش مصنوعی ورتکس (Vertex AI) به شما امکان می‌دهد از API هوش مصنوعی ورتکس در Apps Script استفاده کنید. این API به شما امکان دسترسی به Gemini و سایر مدل‌های هوش مصنوعی مولد را برای تولید متن، تصویر و موارد دیگر می‌دهد.

پیش‌نیازها

مرجع

برای اطلاعات بیشتر در مورد این سرویس، به مستندات مرجع Vertex AI API مراجعه کنید. مانند تمام سرویس‌های پیشرفته در Apps Script، سرویس Vertex AI از همان اشیاء، روش‌ها و پارامترهای API عمومی استفاده می‌کند.

کد نمونه

کد نمونه زیر از نسخه ۱ رابط برنامه‌نویسی کاربردی هوش مصنوعی ورتکس (Vertex AI API) استفاده می‌کند.

تولید متن

این نمونه کد نشان می‌دهد که چگونه مدل 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 را با شناسه پروژه Cloud خود جایگزین کنید.