Gemini API

‫Gemini Interactions API هي واجهة برمجة تطبيقات تجريبية تتيح للمطوّرين إنشاء تطبيقات تستخدم الذكاء الاصطناعي التوليدي من خلال نماذج Gemini. ‫Gemini هو نموذجنا الأكثر تطورًا، وقد تم تصميمه من البداية ليكون متعدّد الوسائط. يمكنه تعميم وفهم أنواع مختلفة من المعلومات والتعامل معها ودمجها بسلاسة، بما في ذلك اللغة والصور والمحتوى الصوتي والفيديوهات والرموز البرمجية. يمكنك استخدام Gemini API لحالات استخدام مثل الاستدلال على النصوص والصور، وإنشاء المحتوى، ووكلاء الحوار، وأنظمة التلخيص والتصنيف، وغير ذلك.

عرض بتنسيق Markdown عرض مواصفات OpenAPI

إنشاء تفاعل

post https://generativelanguage.googleapis.com/v1beta/interactions

تُنشئ هذه الطريقة تفاعلاً جديدًا.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

model ModelOption  (اختياري)

اسم `النموذج` المستخدَم لإنشاء التفاعل.
مطلوبة إذا لم يتم تقديم `agent`.

القيم المحتملة:

  • gemini-2.5-computer-use-preview-10-2025

    نموذج قدرات مستند إلى الذكاء الاصطناعي الوكيل ومصمَّم للتفاعل المباشر مع الواجهة، ما يتيح لـ Gemini إدراك البيئات الرقمية والتنقّل فيها.

  • gemini-2.5-flash

    نموذجنا الأول للاستدلال المختلط الذي يتيح قدرة استيعاب مليون رمز مميّز ويتضمّن ميزانيات للتفكير.

  • gemini-2.5-flash-image

    نموذجنا الأصلي لإنشاء الصور، وهو محسّن من حيث السرعة والمرونة والفهم السياقي. يتم تسعير إدخال النص وإخراجه بنفس سعر 2.5 Flash.

  • gemini-2.5-flash-lite

    هذا النموذج هو الأصغر والأكثر فعالية من حيث التكلفة، وهو مصمّم للاستخدام على نطاق واسع.

  • gemini-2.5-flash-lite-preview-09-2025

    أحدث نموذج يستند إلى Gemini 2.5 Flash lite المحسَّن لتحقيق فعالية من حيث التكلفة ومعدّل أعلى لنقل البيانات وجودة عالية.

  • gemini-2.5-flash-native-audio-preview-12-2025

    تم تحسين نماذج الصوت الأصلية لإنتاج نتائج صوتية بجودة أعلى مع تحسين السرعة والطبيعية والوضوح والمزاج.

  • gemini-2.5-flash-preview-09-2025

    أحدث نموذج يستند إلى نموذج 2.5 Flash ‫2.5‎ Flash Preview هو الخيار الأفضل للمهام التي تتطلّب التفكير ومعالجة البيانات على نطاق واسع، والمهام التي تتطلّب وقت استجابة منخفضًا، والمهام التي تتطلّب معالجة كميات كبيرة من البيانات، وحالات الاستخدام التي تستند إلى الذكاء الاصطناعي الوكيل.

  • gemini-2.5-flash-preview-tts

    نموذج تحويل النص إلى كلام 2.5 Flash محسّن لإنشاء كلام قوي يمكن التحكّم فيه مع وقت استجابة منخفض.

  • gemini-2.5-pro

    نموذجنا المتطوّر المتعدّد الأغراض، والذي يتفوّق في الترميز ومهام الاستدلال المعقّدة.

  • gemini-2.5-pro-preview-tts

    نموذجنا الصوتي 2.5‎ Pro لتحويل النص إلى كلام محسّن لإنشاء كلام قوي بزمن استجابة منخفض، ما يتيح الحصول على نتائج أكثر طبيعية وتوجيه الطلبات بسهولة أكبر.

  • gemini-3-flash-preview

    أكثر نماذجنا ذكاءً والمصمَّم للعمل بسرعة، فهو يجمع بين الذكاء المتطوّر والبحث الفائق والقدرة على الاستناد إلى مصادر موثوقة.

  • gemini-3-pro-image-preview

    نموذج متطوّر لإنشاء الصور وتعديلها

  • gemini-3-pro-preview

    نموذجنا الأكثر ذكاءً الذي يتميّز بقدرات استدلالية وفهم لمختلف الوسائط على أعلى مستوى، بالإضافة إلى إمكانات البرمجة الوصفية وميزات تستند إلى الذكاء الاصطناعي الوكيل.

  • gemini-3.1-pro-preview

    أحدث نموذج استدلالي متطوّر لدينا يتميّز بعمق ودقة غير مسبوقَين، بالإضافة إلى إمكانات ترميز وفهم قوي للمحتوى المتعدد الوسائط.

  • gemini-3.1-flash-image-preview

    يقدّم هذا النموذج إمكانات ذكاء مرئي احترافية مع سرعة فائقة وكفاءة عالية وقدرات إنشاء تستند إلى الواقع.

  • gemini-3.1-flash-lite-preview

    هذا النموذج هو الأكثر فعالية من حيث التكلفة، وهو محسّن لتنفيذ المهام التي تتطلب وكلاء الذكاء الاصطناعي بكميات كبيرة، والترجمة، ومعالجة البيانات البسيطة.

  • gemini-3.1-flash-tts-preview

    ‫Gemini 3.1 Flash TTS: إنشاء كلام قوي وبزمن استجابة منخفض استمتِع بمخرجات طبيعية ومطالبات قابلة للتوجيه وعلامات صوتية تعبيرية جديدة للتحكّم الدقيق في السرد.

  • lyria-3-clip-preview

    نموذجنا المصمَّم لإنشاء الموسيقى بزمن استجابة منخفض، وهو محسّن لإنشاء مقاطع صوتية عالية الدقة والتحكّم الدقيق في الإيقاع.

  • lyria-3-pro-preview

    نموذجنا المتقدّم لإنشاء الأغاني الكاملة يتيح فهمًا عميقًا للتركيب الموسيقي، وهو محسَّن للتحكّم الدقيق في البنية الموسيقية والانتقالات المعقّدة بين الأنماط الموسيقية المتنوعة.

النموذج الذي سيكمل طلبك.\n\nراجِع [النماذج](https://ai.google.dev/gemini-api/docs/models) للحصول على تفاصيل إضافية.

agent AgentOption  (اختياري)

اسم `الوكيل` المستخدَم لإنشاء التفاعل.
مطلوبة إذا لم يتم تقديم `model`.

القيم المحتملة:

  • deep-research-pro-preview-12-2025

    وكيل Deep Research من Gemini

  • deep-research-preview-04-2026

    وكيل Deep Research من Gemini

  • deep-research-max-preview-04-2026

    ‫Gemini Deep Research Max Agent

الوكيل الذي سيتم التفاعل معه

input المحتوى أو الصفيف (المحتوى) أو الصفيف (الخطوة) أو السلسلة  (مطلوبة)

تمثّل هذه السمة المعلومات التي يتم إدخالها للتفاعل (وهي مشترَكة بين النموذج ووكيل الذكاء الاصطناعي).

system_instruction string  (اختيارية)

تعليمات النظام للتفاعل

tools array (Tool)  (اختياري)

قائمة بتعريفات الأدوات التي قد يستدعيها النموذج أثناء التفاعل

response_format ResponseFormat أو ResponseFormatList  (اختيارية)

يفرض أن تكون الاستجابة التي تم إنشاؤها عبارة عن كائن JSON يتوافق مع مخطط JSON المحدّد في هذا الحقل.

response_mime_type string  (اختيارية)

نوع MIME الخاص بالردّ. هذا الإجراء مطلوب في حال ضبط response_format.

stream boolean  (اختياري)

الإدخال فقط تُستخدَم لتحديد ما إذا كان سيتم بث التفاعل.

store boolean  (اختياري)

الإدخال فقط تحديد ما إذا كان سيتم تخزين الرد والطلب لاستردادهما لاحقًا

الخلفية منطقي  (اختياري)

الإدخال فقط تحديد ما إذا كان سيتم تشغيل التفاعل مع النموذج في الخلفية

generation_config GenerationConfig  (optional)

إعدادات النموذج
مَعلمات الإعداد للتفاعل مع النموذج
بديل عن `agent_config`. لا ينطبق إلا عند ضبط `model`.

مَعلمات الإعداد لتفاعلات النموذج

الحقول

temperature number  (اختياري)

تتحكّم هذه السمة في عشوائية الناتج.

top_p number  (اختياري)

الحدّ الأقصى للاحتمال التراكمي للرموز المميّزة التي يجب أخذها في الاعتبار عند أخذ العيّنات.

seed عدد صحيح  (اختياري)

القيمة الأولية المستخدَمة في فك الترميز لضمان إمكانية إعادة الإنتاج

stop_sequences array (string)  (اختيارية)

قائمة بسلاسل الأحرف التي ستوقف تفاعل الإخراج

thinking_level ThinkingLevel  (اختيارية)

مستوى الرموز المميزة للأفكار التي يجب أن ينشئها النموذج

القيم المحتملة:

  • minimal
  • low
  • medium
  • high

thinking_summaries ThinkingSummaries  (اختيارية)

تحديد ما إذا كان سيتم تضمين ملخّصات الأفكار في الردّ.

القيم المحتملة:

  • auto
  • none

max_output_tokens integer  (اختياري)

الحد الأقصى لعدد الرموز المميّزة التي سيتم تضمينها في الردّ

speech_config SpeechConfig  (اختياري)

إعدادات التفاعل مع الكلام

إعدادات التفاعل الصوتي

الحقول

voice string  (اختياري)

صوت المتحدث

language string  (اختياري)

لغة الكلام

speaker string  (اختياري)

اسم المتحدث، ويجب أن يتطابق مع اسم المتحدث الوارد في الطلب

image_config ImageConfig  (اختياري)

إعدادات التفاعل مع الصور

إعدادات التفاعل مع الصور

الحقول

aspect_ratio تعداد (سلسلة)  (اختيارية)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • 1:1
  • 2:3
  • 3:2
  • 3:4
  • 4:3
  • 4:5
  • 5:4
  • 9:16
  • 16:9
  • 21:9
  • 1:8
  • 8:1
  • 1:4
  • 4:1
image_size enum (string)  (اختياري)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • 1K
  • 2K
  • 4K
  • 512
tool_choice ToolChoiceConfig أو ToolChoiceType  (اختيارية)

إعدادات اختيار الأداة

agent_config object  (اختياري)

إعدادات الوكيل
إعدادات الوكيل
بديل عن `generation_config`. لا ينطبق إلا عند ضبط `agent`.

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

DynamicAgentConfig

إعدادات الوكلاء الديناميكيين

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "dynamic".

DeepResearchAgentConfig

إعدادات وكيل Deep Research

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "deep-research".

thinking_summaries ThinkingSummaries  (اختيارية)

تحديد ما إذا كان سيتم تضمين ملخّصات الأفكار في الردّ.

القيم المحتملة:

  • auto
  • none

visualization enum (string)  (اختياري)

تحديد ما إذا كان سيتم تضمين التصورات في الرد.

القيم المحتملة:

  • off
  • auto
collaborative_planning boolean  (اختيارية)

تفعيل التخطيط بمساعدة الإنسان لوكيل Deep Research إذا تم ضبطها على true، سيقدّم وكيل Deep Research خطة بحث في رده. ولن يتابع الوكيل إلا إذا أكّد المستخدم الخطة في المحادثة التالية.

previous_interaction_id string  (اختياري)

رقم تعريف التفاعل السابق، إن وُجد.

response_modalities ResponseModality  (اختيارية)

أنواع الردود المطلوبة (TEXT أو IMAGE أو AUDIO).

القيم المحتملة:

  • text
  • image
  • audio
  • video
  • document

service_tier ServiceTier  (اختيارية)

فئة الخدمة للتفاعل

القيم المحتملة:

  • flex
  • standard
  • priority

webhook_config WebhookConfig  (اختياري)

اختياريّ. إعدادات Webhook لتلقّي الإشعارات عند اكتمال التفاعل

رسالة لإعداد أحداث ويب هوك لطلب معيّن

الحقول

uris مصفوفة (سلسلة)  (اختيارية)

اختياريّ. في حال ضبطها، سيتم استخدام معرّفات الموارد الموحّدة الخاصة بخطافات الويب هذه لأحداث خطافات الويب بدلاً من خطافات الويب المسجّلة.

user_metadata object  (اختيارية)

اختياريّ. البيانات الوصفية للمستخدم التي سيتم عرضها عند كل عملية إرسال حدث إلى خطافات الويب.

الردّ

تعرض هذه الطريقة مورد Interaction.

طلب بسيط

مثال على الرد

{
  "created": "2025-11-26T12:25:15Z",
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "type": "text",
          "text": "Hello! I'm functioning perfectly and ready to assist you.\n\nHow are you doing today?"
        }
      ]
    }
  ],
  "status": "completed",
  "updated": "2025-11-26T12:25:15Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 20,
    "total_thought_tokens": 22,
    "total_tokens": 49,
    "total_tool_use_tokens": 0
  }
}

محادثة متعدّدة الجولات

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "type": "text",
          "text": "The capital of France is Paris."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 50
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 50,
    "total_output_tokens": 10,
    "total_thought_tokens": 0,
    "total_tokens": 60,
    "total_tool_use_tokens": 0
  }
}

إدخال صورة

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "type": "text",
          "text": "A white humanoid robot with glowing blue eyes stands holding a red skateboard."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 10
      },
      {
        "modality": "image",
        "tokens": 258
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 268,
    "total_output_tokens": 20,
    "total_thought_tokens": 0,
    "total_tokens": 288,
    "total_tool_use_tokens": 0
  }
}

استدعاء الدوال

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "requires_action",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "steps": [
    {
      "type": "function_call",
      "id": "gth23981",
      "name": "get_weather",
      "arguments": {
        "location": "Boston, MA"
      }
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 100
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 100,
    "total_output_tokens": 25,
    "total_thought_tokens": 0,
    "total_tokens": 125,
    "total_tool_use_tokens": 50
  }
}

Deep Research

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "type": "text",
          "text": "Here is a comprehensive research report on the current state of cancer research..."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 20
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 20,
    "total_output_tokens": 1000,
    "total_thought_tokens": 500,
    "total_tokens": 1520,
    "total_tool_use_tokens": 0
  }
}

استرداد تفاعل

get https://generativelanguage.googleapis.com/v1beta/interactions/{id}

تسترد هذه الطريقة التفاصيل الكاملة لتفاعل واحد استنادًا إلى `Interaction.id`.

مَعلمات المسار / طلب البحث

id string  (مطلوبة)

المعرّف الفريد للتفاعل المطلوب استرداده.

stream boolean  (اختياري)

في حال ضبطها على "صحيح"، سيتم بث المحتوى الذي تم إنشاؤه بشكل تدريجي.

الإعداد التلقائي هو: False

last_event_id string  (اختياري)

اختياريّ. في حال ضبط هذه السمة، يتم استئناف بث التفاعل من الجزء التالي بعد الحدث الذي تم تحديده بمعرّف الحدث. لا يمكن استخدامها إلا إذا كانت قيمة `stream` هي "صحيح".

include_input boolean  (اختياري)

إذا تم ضبطها على "صحيح"، سيتم تضمين الإدخال في الرد.

الإعداد التلقائي هو: False

api_version string  (اختيارية)

إصدار واجهة برمجة التطبيقات الذي سيتم استخدامه

الردّ

تعرض هذه الطريقة مورد Interaction.

Get Interaction

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "type": "text",
          "text": "I'm doing great, thank you for asking! How can I help you today?"
        }
      ]
    }
  ]
}

حذف تفاعل

delete https://generativelanguage.googleapis.com/v1beta/interactions/{id}

يحذف هذا الإجراء التفاعل حسب معرّفه.

مَعلمات المسار / طلب البحث

id string  (مطلوبة)

المعرّف الفريد للتفاعل المطلوب حذفه.

api_version string  (اختيارية)

إصدار واجهة برمجة التطبيقات الذي سيتم استخدامه

الردّ

إذا كانت الاستجابة ناجحة، ستكون فارغة.

حذف التفاعل

إلغاء تفاعل

post https://generativelanguage.googleapis.com/v1beta/interactions/{id}/cancel

تلغي هذه الطريقة تفاعلاً حسب رقم التعريف. ينطبق ذلك فقط على التفاعلات التي لا تزال قيد التشغيل في الخلفية.

مَعلمات المسار / طلب البحث

id string  (مطلوبة)

المعرّف الفريد للتفاعل المطلوب إلغاؤه.

api_version string  (اختيارية)

إصدار واجهة برمجة التطبيقات الذي سيتم استخدامه

الردّ

تعرض هذه الطريقة مورد Interaction.

إلغاء التفاعل

مثال على الرد

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "cancelled",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z"
}

الموارد

التفاعل

مورد Interaction

الحقول

model ModelOption  (اختياري)

اسم `النموذج` المستخدَم لإنشاء التفاعل.

القيم المحتملة:

  • gemini-2.5-computer-use-preview-10-2025

    نموذج قدرات مستند إلى الذكاء الاصطناعي الوكيل ومصمَّم للتفاعل المباشر مع الواجهة، ما يتيح لـ Gemini إدراك البيئات الرقمية والتنقّل فيها.

  • gemini-2.5-flash

    نموذجنا الأول للاستدلال المختلط الذي يتيح قدرة استيعاب مليون رمز مميّز ويتضمّن ميزانيات للتفكير.

  • gemini-2.5-flash-image

    نموذجنا الأصلي لإنشاء الصور، وهو محسّن من حيث السرعة والمرونة والفهم السياقي. يتم تسعير إدخال النص وإخراجه بنفس سعر 2.5 Flash.

  • gemini-2.5-flash-lite

    هذا النموذج هو الأصغر والأكثر فعالية من حيث التكلفة، وهو مصمّم للاستخدام على نطاق واسع.

  • gemini-2.5-flash-lite-preview-09-2025

    أحدث نموذج يستند إلى Gemini 2.5 Flash lite المحسَّن لتحقيق فعالية من حيث التكلفة ومعدّل أعلى لنقل البيانات وجودة عالية.

  • gemini-2.5-flash-native-audio-preview-12-2025

    تم تحسين نماذج الصوت الأصلية لإنتاج نتائج صوتية بجودة أعلى مع تحسين السرعة والطبيعية والوضوح والمزاج.

  • gemini-2.5-flash-preview-09-2025

    أحدث نموذج يستند إلى نموذج 2.5 Flash ‫2.5‎ Flash Preview هو الخيار الأفضل للمهام التي تتطلّب التفكير ومعالجة البيانات على نطاق واسع، والمهام التي تتطلّب وقت استجابة منخفضًا، والمهام التي تتطلّب معالجة كميات كبيرة من البيانات، وحالات الاستخدام التي تستند إلى الذكاء الاصطناعي الوكيل.

  • gemini-2.5-flash-preview-tts

    نموذج تحويل النص إلى كلام 2.5 Flash محسّن لإنشاء كلام قوي يمكن التحكّم فيه مع وقت استجابة منخفض.

  • gemini-2.5-pro

    نموذجنا المتطوّر المتعدّد الأغراض، والذي يتفوّق في الترميز ومهام الاستدلال المعقّدة.

  • gemini-2.5-pro-preview-tts

    نموذجنا الصوتي 2.5‎ Pro لتحويل النص إلى كلام محسّن لإنشاء كلام قوي بزمن استجابة منخفض، ما يتيح الحصول على نتائج أكثر طبيعية وتوجيه الطلبات بسهولة أكبر.

  • gemini-3-flash-preview

    أكثر نماذجنا ذكاءً والمصمَّم للعمل بسرعة، فهو يجمع بين الذكاء المتطوّر والبحث الفائق والقدرة على الاستناد إلى مصادر موثوقة.

  • gemini-3-pro-image-preview

    نموذج متطوّر لإنشاء الصور وتعديلها

  • gemini-3-pro-preview

    نموذجنا الأكثر ذكاءً الذي يتميّز بقدرات استدلالية وفهم لمختلف الوسائط على أعلى مستوى، بالإضافة إلى إمكانات البرمجة الوصفية وميزات تستند إلى الذكاء الاصطناعي الوكيل.

  • gemini-3.1-pro-preview

    أحدث نموذج استدلالي متطوّر لدينا يتميّز بعمق ودقة غير مسبوقَين، بالإضافة إلى إمكانات ترميز وفهم قوي للمحتوى المتعدد الوسائط.

  • gemini-3.1-flash-image-preview

    يقدّم هذا النموذج إمكانات ذكاء مرئي احترافية مع سرعة فائقة وكفاءة عالية وقدرات إنشاء تستند إلى الواقع.

  • gemini-3.1-flash-lite-preview

    هذا النموذج هو الأكثر فعالية من حيث التكلفة، وهو محسّن لتنفيذ المهام التي تتطلب وكلاء الذكاء الاصطناعي بكميات كبيرة، والترجمة، ومعالجة البيانات البسيطة.

  • gemini-3.1-flash-tts-preview

    ‫Gemini 3.1 Flash TTS: إنشاء كلام قوي وبزمن استجابة منخفض استمتِع بمخرجات طبيعية ومطالبات قابلة للتوجيه وعلامات صوتية تعبيرية جديدة للتحكّم الدقيق في السرد.

  • lyria-3-clip-preview

    نموذجنا المصمَّم لإنشاء الموسيقى بزمن استجابة منخفض، وهو محسّن لإنشاء مقاطع صوتية عالية الدقة والتحكّم الدقيق في الإيقاع.

  • lyria-3-pro-preview

    نموذجنا المتقدّم لإنشاء الأغاني الكاملة يتيح فهمًا عميقًا للتركيب الموسيقي، وهو محسَّن للتحكّم الدقيق في البنية الموسيقية والانتقالات المعقّدة بين الأنماط الموسيقية المتنوعة.

النموذج الذي سيكمل طلبك.\n\nراجِع [النماذج](https://ai.google.dev/gemini-api/docs/models) للحصول على تفاصيل إضافية.

agent AgentOption  (اختياري)

اسم `الوكيل` المستخدَم لإنشاء التفاعل.

القيم المحتملة:

  • deep-research-pro-preview-12-2025

    وكيل Deep Research من Gemini

  • deep-research-preview-04-2026

    وكيل Deep Research من Gemini

  • deep-research-max-preview-04-2026

    ‫Gemini Deep Research Max Agent

الوكيل الذي سيتم التفاعل معه

id string  (اختياري)

الحقل مطلوب. النتائج فقط. معرّف فريد لإكمال التفاعل.

الحالة تعداد (سلسلة)  (اختياري)

الحقل مطلوب. النتائج فقط. تمثّل هذه السمة حالة التفاعل.

القيم المحتملة:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
created string  (اختياري)

الحقل مطلوب. النتائج فقط. تمثّل هذه السمة وقت إنشاء الردّ بالتنسيق ISO 8601 (YYYY-MM-DDThh:mm:ssZ).

updated string  (اختياري)

الحقل مطلوب. النتائج فقط. تمثّل هذه السمة وقت آخر تعديل أُجري على الردّ بتنسيق ISO 8601 ‏(YYYY-MM-DDThh:mm:ssZ).

role string  (اختياري)

النتائج فقط. دور التفاعل

system_instruction string  (اختيارية)

تعليمات النظام للتفاعل

tools array (Tool)  (اختياري)

قائمة بتعريفات الأدوات التي قد يستدعيها النموذج أثناء التفاعل

usage Usage  (اختياري)

النتائج فقط. إحصاءات حول استخدام الرمز المميز لطلب التفاعل.

إحصاءات حول استخدام الرمز المميز لطلب التفاعل.

الحقول

total_input_tokens integer  (اختياري)

عدد الرموز المميزة في الطلب (السياق).

input_tokens_by_modality ModalityTokens  (اختياري)

تفصيل لاستخدام الرموز المميزة للإدخال حسب نوع البيانات

عدد الرموز المميزة لنمط استجابة واحد

الحقول

modality ResponseModality  (اختياري)

الوسيط المرتبط بعدد الرموز المميزة.

القيم المحتملة:

  • text
  • image
  • audio
  • video
  • document

tokens عدد صحيح  (اختياري)

عدد الرموز المميّزة للوسائط

total_cached_tokens integer  (optional)

عدد الرموز المميزة في الجزء المخزّن مؤقتًا من الطلب (المحتوى المخزّن مؤقتًا)

cached_tokens_by_modality ModalityTokens  (اختياري)

تفاصيل استخدام الرمز المميز المخزّن مؤقتًا حسب طريقة الاستخدام

عدد الرموز المميزة لنمط استجابة واحد

الحقول

modality ResponseModality  (اختياري)

الوسيط المرتبط بعدد الرموز المميزة.

القيم المحتملة:

  • text
  • image
  • audio
  • video
  • document

tokens عدد صحيح  (اختياري)

عدد الرموز المميّزة للوسائط

total_output_tokens عدد صحيح  (اختياري)

إجمالي عدد الرموز المميزة في جميع الردود التي تم إنشاؤها

output_tokens_by_modality ModalityTokens  (اختياري)

تفصيل لاستخدام الرموز المميزة للناتج حسب نوع البيانات

عدد الرموز المميزة لنمط استجابة واحد

الحقول

modality ResponseModality  (اختياري)

الوسيط المرتبط بعدد الرموز المميزة.

القيم المحتملة:

  • text
  • image
  • audio
  • video
  • document

tokens عدد صحيح  (اختياري)

عدد الرموز المميّزة للوسائط

total_tool_use_tokens integer  (اختيارية)

عدد الرموز المميزة المتوفّرة في طلبات استخدام الأدوات

tool_use_tokens_by_modality ModalityTokens  (اختياري)

تفصيل لاستخدام الرموز المميزة الخاصة باستخدام الأدوات حسب نوع البيانات

عدد الرموز المميزة لنمط استجابة واحد

الحقول

modality ResponseModality  (اختياري)

الوسيط المرتبط بعدد الرموز المميزة.

القيم المحتملة:

  • text
  • image
  • audio
  • video
  • document

tokens عدد صحيح  (اختياري)

عدد الرموز المميّزة للوسائط

total_thought_tokens integer  (اختيارية)

عدد الرموز المميّزة للأفكار في نماذج التفكير

total_tokens integer  (optional)

إجمالي عدد الرموز المميزة لطلب التفاعل (الطلب + الردود + الرموز المميزة الداخلية الأخرى).

grounding_tool_count GroundingToolCount  (اختياري)

عدد أدوات التأسيس

عدد أدوات التأريض.

الحقول

type enum (string)  (اختياري)

نوع أداة التأسيس المرتبطة بالعدد

القيم المحتملة:

  • google_search
  • google_maps
  • retrieval
count integer  (اختياري)

عدد أدوات التأريض.

response_modalities ResponseModality  (اختيارية)

أنواع الردود المطلوبة (TEXT أو IMAGE أو AUDIO).

القيم المحتملة:

  • text
  • image
  • audio
  • video
  • document

response_mime_type string  (اختيارية)

نوع MIME الخاص بالردّ. هذا الإجراء مطلوب في حال ضبط response_format.

previous_interaction_id string  (اختياري)

رقم تعريف التفاعل السابق، إن وُجد.

service_tier ServiceTier  (اختيارية)

فئة الخدمة للتفاعل

القيم المحتملة:

  • flex
  • standard
  • priority

webhook_config WebhookConfig  (اختياري)

اختياريّ. إعدادات Webhook لتلقّي الإشعارات عند اكتمال التفاعل

رسالة لإعداد أحداث ويب هوك لطلب معيّن

الحقول

uris مصفوفة (سلسلة)  (اختيارية)

اختياريّ. في حال ضبطها، سيتم استخدام معرّفات الموارد الموحّدة الخاصة بخطافات الويب هذه لأحداث خطافات الويب بدلاً من خطافات الويب المسجّلة.

user_metadata object  (اختيارية)

اختياريّ. البيانات الوصفية للمستخدم التي سيتم عرضها عند كل عملية إرسال حدث إلى خطافات الويب.

الخطوات الخطوة  (اختيارية)

النتائج فقط. تمثّل هذه السمة الخطوات التي يتضمّنها التفاعل.

خطوة في التفاعل

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

UserInputStep

تمثّل هذه السمة الإدخال الذي يقدّمه المستخدم.

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "user_input".

content مصفوفة (Content)  (اختياري)

لم يتم تقديم أي وصف.

ModelOutputStep

الناتج الذي يصدره النموذج

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "model_output".

content مصفوفة (Content)  (اختياري)

لم يتم تقديم أي وصف.

ThoughtStep

خطوة فكرية

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "thought".

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

summary ThoughtSummaryContent  (اختياري)

ملخّص الفكرة

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

TextContent

مقطع محتوى نصي

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "text".

text string  (مطلوبة)

الحقل مطلوب. محتوى النص

annotations Annotation  (اختياري)

معلومات الاقتباس للمحتوى من إنشاء النماذج

معلومات الاقتباس للمحتوى من إنشاء النماذج

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

UrlCitation

تعليق توضيحي لاقتباس من عنوان URL

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "url_citation".

url string  (اختياري)

تمثّل هذه السمة عنوان URL.

title string  (اختياري)

تمثّل هذه السمة عنوان URL.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

FileCitation

تعليق توضيحي لاقتباس ملف

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "file_citation".

document_uri string  (اختيارية)

معرّف الموارد المنتظم (URI) للملف

file_name string  (اختيارية)

تمثّل هذه السمة اسم الملف.

source string  (اختياري)

المصدر الذي تم الاستناد إليه في جزء من النص

custom_metadata object  (اختياري)

بيانات التعريف التي قدّمها المستخدم حول السياق الذي تم استرجاعه

page_number عدد صحيح  (اختياري)

تمثّل هذه السمة رقم صفحة المستند المُقتبَس منه، إذا كان ذلك منطبقًا.

media_id string  (اختياري)

تمثّل هذه السمة رقم تعريف الوسائط في حال الاقتباس من الصور، إذا كان ذلك منطبقًا.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

PlaceCitation

تعليق توضيحي بشأن توثيق مكان

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "place_citation".

place_id string  (اختياري)

معرّف المكان بالتنسيق `places/{place_id}`

name string  (اختياري)

تمثّل هذه السمة عنوان المكان.

url string  (اختياري)

تمثّل هذه السمة مرجع معرّف الموارد المنتظم (URI) للمكان.

review_snippets ReviewSnippet  (اختياري)

مقتطفات من المراجعات تُستخدَم لإنشاء إجابات عن ميزات مكان معيّن في "خرائط Google"

تتضمّن هذه السمة مقتطفًا من مراجعة كتبها مستخدم يجيب فيها عن سؤال حول ميزات مكان معيّن في "خرائط Google".

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان المراجعة.

url string  (اختياري)

رابط يؤدي إلى مراجعة المستخدم على "خرائط Google".

review_id string  (اختياري)

رقم تعريف مقتطف من المراجعة.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

ImageContent

كتلة محتوى صورة

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "image".

data string  (اختياري)

محتوى الصورة

uri string  (اختياري)

تمثّل هذه السمة معرّف الموارد المنتظم (URI) الخاص بالصورة.

mime_type enum (string)  (اختياري)

نوع MIME الخاص بالصورة.

القيم المحتملة:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (اختياري)

تمثّل درجة دقة الوسائط.

القيم المحتملة:

  • low
  • medium
  • high
  • ultra_high

FunctionCallStep

خطوة استدعاء أداة الدالة

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "function_call".

name string  (مطلوب)

الحقل مطلوب. تمثّل هذه السمة اسم الأداة المطلوب استدعاؤها.

arguments object  (مطلوب)

الحقل مطلوب. الوسيطات التي سيتم تمريرها إلى الدالة

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

CodeExecutionCallStep

خطوة طلب تنفيذ الرمز البرمجي

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "code_execution_call".

arguments CodeExecutionCallStepArguments  (مطلوب)

الحقل مطلوب. الوسيطات التي سيتم تمريرها إلى تنفيذ الرمز البرمجي

الوسيطات التي سيتم تمريرها إلى تنفيذ الرمز البرمجي

الحقول

language enum (string)  (اختيارية)

لغة البرمجة الخاصة بالرمز البرمجي.

القيم المحتملة:

  • python
code string  (اختياري)

الرمز البرمجي المطلوب تنفيذه

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

UrlContextCallStep

خطوة طلب سياق عنوان URL

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "url_context_call".

arguments UrlContextCallStepArguments  (مطلوب)

الحقل مطلوب. الوسيطات التي سيتم تمريرها إلى سياق عنوان URL.

الوسيطات التي سيتم تمريرها إلى سياق عنوان URL.

الحقول

urls مصفوفة (سلسلة)  (اختيارية)

عناوين URL المطلوب استرجاعها

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

McpServerToolCallStep

خطوة استدعاء أداة MCPServer

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "mcp_server_tool_call".

name string  (مطلوب)

الحقل مطلوب. اسم الأداة التي تم استدعاؤها

server_name string  (مطلوبة)

الحقل مطلوب. تمثّل هذه السمة اسم خادم MCP المستخدَم.

arguments object  (مطلوب)

الحقل مطلوب. عنصر JSON الخاص بوسيطات الدالة

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

GoogleSearchCallStep

خطوة المكالمة على "بحث Google"

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "google_search_call".

arguments GoogleSearchCallStepArguments  (مطلوبة)

الحقل مطلوب. الوسيطات التي يجب تمريرها إلى "بحث Google"

الوسيطات التي يجب تمريرها إلى "بحث Google"

الحقول

queries array (string)  (اختياري)

طلبات البحث على الويب التي يتم إجراؤها بعد البحث الأولي على الويب

search_type enum (string)  (اختياري)

نوع البحث المستند إلى بيانات مفعَّل.

القيم المحتملة:

  • web_search
  • image_search
  • enterprise_web_search
id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

FileSearchCallStep

خطوة طلب البحث عن الملفات

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "file_search_call".

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

GoogleMapsCallStep

خطوة الاتصال في "خرائط Google"

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "google_maps_call".

arguments GoogleMapsCallStepArguments  (اختياري)

الوسيطات التي سيتم تمريرها إلى أداة "خرائط Google"

الوسيطات التي سيتم تمريرها إلى أداة "خرائط Google"

الحقول

queries array (string)  (اختياري)

طلبات البحث التي سيتم تنفيذها.

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

FunctionResultStep

نتيجة استدعاء أداة دالة

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "function_result".

name string  (اختياري)

تمثّل هذه السمة اسم الأداة التي تم استدعاؤها.

is_error boolean  (اختياري)

تُستخدَم لتحديد ما إذا كان استدعاء الأداة قد أدّى إلى حدوث خطأ.

call_id string  (مطلوبة)

الحقل مطلوب. معرّف يجب أن يتطابق مع المعرّف من مربّع استدعاء الدالة

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

result array (FunctionResultSubcontent) or string  (مطلوبة)

نتيجة استدعاء الأداة

CodeExecutionResultStep

خطوة نتيجة تنفيذ الرمز البرمجي

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "code_execution_result".

result string  (مطلوبة)

الحقل مطلوب. ناتج تنفيذ الرمز البرمجي

is_error boolean  (اختياري)

تُستخدَم لتحديد ما إذا كان تنفيذ الرمز البرمجي قد أدّى إلى حدوث خطأ.

call_id string  (مطلوبة)

الحقل مطلوب. معرّف يجب أن يتطابق مع المعرّف من مربّع استدعاء الدالة

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

UrlContextResultStep

خطوة نتيجة سياق عنوان URL

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "url_context_result".

result UrlContextResultItem  (مطلوب)

الحقل مطلوب. نتائج سياق عنوان URL

نتيجة سياق عنوان URL

الحقول

url string  (اختياري)

عنوان URL الذي تم استرجاعه.

الحالة تعداد (سلسلة)  (اختياري)

حالة استرداد عنوان URL

القيم المحتملة:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (اختياري)

تُستخدَم لتحديد ما إذا كان سياق عنوان URL قد أدّى إلى حدوث خطأ.

call_id string  (مطلوبة)

الحقل مطلوب. معرّف يجب أن يتطابق مع المعرّف من مربّع استدعاء الدالة

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

GoogleSearchResultStep

خطوة نتيجة البحث من Google

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "google_search_result".

result GoogleSearchResultItem  (مطلوبة)

الحقل مطلوب. نتائج بحث Google

نتيجة بحث Google.

الحقول

search_suggestions string  (اختيارية)

مقتطف من محتوى الويب يمكن تضمينه في صفحة ويب أو WebView في تطبيق

is_error boolean  (اختياري)

تُستخدَم لتحديد ما إذا كان البحث على Google قد أدّى إلى حدوث خطأ.

call_id string  (مطلوبة)

الحقل مطلوب. معرّف يجب أن يتطابق مع المعرّف من مربّع استدعاء الدالة

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

McpServerToolResultStep

خطوة نتيجة أداة MCPServer

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "mcp_server_tool_result".

name string  (اختياري)

اسم الأداة التي يتم استدعاؤها لتنفيذ طلب الأداة المحدّد هذا.

server_name string  (اختياري)

تمثّل هذه السمة اسم خادم MCP المستخدَم.

call_id string  (مطلوبة)

الحقل مطلوب. معرّف يجب أن يتطابق مع المعرّف من مربّع استدعاء الدالة

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

result array (FunctionResultSubcontent) or string  (مطلوبة)

الناتج من طلب خادم MCP يمكن أن يكون نصًا بسيطًا أو محتوًى وافيًا.

FileSearchResultStep

خطوة نتيجة البحث عن الملفات

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "file_search_result".

call_id string  (مطلوبة)

الحقل مطلوب. معرّف يجب أن يتطابق مع المعرّف من مربّع استدعاء الدالة

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

GoogleMapsResultStep

خطوة نتيجة "خرائط Google"

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "google_maps_result".

result GoogleMapsResultItem  (مطلوب)

لم يتم تقديم أي وصف.

نتيجة "خرائط Google"

الحقول

places GoogleMapsResultPlaces  (اختياري)

لم يتم تقديم أي وصف.

الحقول

place_id string  (اختياري)

لم يتم تقديم أي وصف.

name string  (اختياري)

لم يتم تقديم أي وصف.

url string  (اختياري)

لم يتم تقديم أي وصف.

review_snippets ReviewSnippet  (اختياري)

لم يتم تقديم أي وصف.

تتضمّن هذه السمة مقتطفًا من مراجعة كتبها مستخدم يجيب فيها عن سؤال حول ميزات مكان معيّن في "خرائط Google".

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان المراجعة.

url string  (اختياري)

رابط يؤدي إلى مراجعة المستخدم على "خرائط Google".

review_id string  (اختياري)

رقم تعريف مقتطف من المراجعة.

widget_context_token string  (اختياري)

لم يتم تقديم أي وصف.

call_id string  (مطلوبة)

الحقل مطلوب. معرّف يجب أن يتطابق مع المعرّف من مربّع استدعاء الدالة

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

input المحتوى أو مصفوفة (المحتوى) أو مصفوفة (الخطوة) أو سلسلة  (اختياري)

تمثّل هذه السمة الإدخال الخاص بالتفاعل.

response_format ResponseFormat أو ResponseFormatList  (اختيارية)

يفرض أن تكون الاستجابة التي تم إنشاؤها عبارة عن كائن JSON يتوافق مع مخطط JSON المحدّد في هذا الحقل.

agent_config object  (اختياري)

مَعلمات الإعداد لتفاعل موظف الدعم

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

DynamicAgentConfig

إعدادات الوكلاء الديناميكيين

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "dynamic".

DeepResearchAgentConfig

إعدادات وكيل Deep Research

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "deep-research".

thinking_summaries ThinkingSummaries  (اختيارية)

تحديد ما إذا كان سيتم تضمين ملخّصات الأفكار في الردّ.

القيم المحتملة:

  • auto
  • none

visualization enum (string)  (اختياري)

تحديد ما إذا كان سيتم تضمين التصورات في الرد.

القيم المحتملة:

  • off
  • auto
collaborative_planning boolean  (اختيارية)

تفعيل التخطيط بمساعدة الإنسان لوكيل Deep Research إذا تم ضبطها على true، سيقدّم وكيل Deep Research خطة بحث في رده. ولن يتابع الوكيل إلا إذا أكّد المستخدم الخطة في المحادثة التالية.

أمثلة

مثال

{
  "created": "2025-12-04T15:01:45Z",
  "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "steps": [
    {
      "type": "model_output",
      "content": [
        {
          "type": "text",
          "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?"
        }
      ]
    }
  ],
  "status": "completed",
  "updated": "2025-12-04T15:01:45Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 23,
    "total_thought_tokens": 49,
    "total_tokens": 79,
    "total_tool_use_tokens": 0
  }
}

نماذج البيانات

المحتوى

محتوى الردّ

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

TextContent

مقطع محتوى نصي

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "text".

text string  (مطلوبة)

الحقل مطلوب. محتوى النص

annotations Annotation  (اختياري)

معلومات الاقتباس للمحتوى من إنشاء النماذج

معلومات الاقتباس للمحتوى من إنشاء النماذج

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

UrlCitation

تعليق توضيحي لاقتباس من عنوان URL

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "url_citation".

url string  (اختياري)

تمثّل هذه السمة عنوان URL.

title string  (اختياري)

تمثّل هذه السمة عنوان URL.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

FileCitation

تعليق توضيحي لاقتباس ملف

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "file_citation".

document_uri string  (اختيارية)

معرّف الموارد المنتظم (URI) للملف

file_name string  (اختيارية)

تمثّل هذه السمة اسم الملف.

source string  (اختياري)

المصدر الذي تم الاستناد إليه في جزء من النص

custom_metadata object  (اختياري)

بيانات التعريف التي قدّمها المستخدم حول السياق الذي تم استرجاعه

page_number عدد صحيح  (اختياري)

تمثّل هذه السمة رقم صفحة المستند المُقتبَس منه، إذا كان ذلك منطبقًا.

media_id string  (اختياري)

تمثّل هذه السمة رقم تعريف الوسائط في حال الاقتباس من الصور، إذا كان ذلك منطبقًا.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

PlaceCitation

تعليق توضيحي بشأن توثيق مكان

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "place_citation".

place_id string  (اختياري)

معرّف المكان بالتنسيق `places/{place_id}`

name string  (اختياري)

تمثّل هذه السمة عنوان المكان.

url string  (اختياري)

تمثّل هذه السمة مرجع معرّف الموارد المنتظم (URI) للمكان.

review_snippets ReviewSnippet  (اختياري)

مقتطفات من المراجعات تُستخدَم لإنشاء إجابات عن ميزات مكان معيّن في "خرائط Google"

تتضمّن هذه السمة مقتطفًا من مراجعة كتبها مستخدم يجيب فيها عن سؤال حول ميزات مكان معيّن في "خرائط Google".

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان المراجعة.

url string  (اختياري)

رابط يؤدي إلى مراجعة المستخدم على "خرائط Google".

review_id string  (اختياري)

رقم تعريف مقتطف من المراجعة.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

ImageContent

كتلة محتوى صورة

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "image".

data string  (اختياري)

محتوى الصورة

uri string  (اختياري)

تمثّل هذه السمة معرّف الموارد المنتظم (URI) الخاص بالصورة.

mime_type enum (string)  (اختياري)

نوع MIME الخاص بالصورة.

القيم المحتملة:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (اختياري)

تمثّل درجة دقة الوسائط.

القيم المحتملة:

  • low
  • medium
  • high
  • ultra_high

AudioContent

كتلة محتوى صوتي

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "audio".

data string  (اختياري)

المحتوى الصوتي

uri string  (اختياري)

تمثّل هذه السمة معرّف الموارد المنتظم (URI) الخاص بالملف الصوتي.

mime_type enum (string)  (اختياري)

نوع MIME الخاص بالمقطع الصوتي.

القيم المحتملة:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
channels عدد صحيح  (اختياري)

تمثّل هذه السمة عدد القنوات الصوتية.

sample_rate integer  (اختيارية)

معدّل البيانات في الملف الصوتي

DocumentContent

وحدة محتوى مستند

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "document".

data string  (اختياري)

محتوى المستند

uri string  (اختياري)

معرّف الموارد المنتظم (URI) للمستند

mime_type enum (string)  (اختياري)

نوع MIME للمستند.

القيم المحتملة:

  • application/pdf
VideoContent

كتلة محتوى فيديو

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "video".

data string  (اختياري)

محتوى الفيديو

uri string  (اختياري)

تمثّل هذه السمة معرّف الموارد المنتظم (URI) الخاص بالفيديو.

mime_type enum (string)  (اختياري)

نوع MIME الخاص بالفيديو.

القيم المحتملة:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (اختياري)

تمثّل درجة دقة الوسائط.

القيم المحتملة:

  • low
  • medium
  • high
  • ultra_high

أمثلة

نص

{
  "type": "text",
  "text": "Hello, how are you?"
}

صورة

{
  "type": "image",
  "data": "BASE64_ENCODED_IMAGE",
  "mime_type": "image/png"
}

الصوت

{
  "type": "audio",
  "data": "BASE64_ENCODED_AUDIO",
  "mime_type": "audio/wav"
}

مستند

{
  "type": "document",
  "data": "BASE64_ENCODED_DOCUMENT",
  "mime_type": "application/pdf"
}

فيديو

{
  "type": "video",
  "uri": "https://www.youtube.com/watch?v=9hE5-98ZeCg"
}

الأداة

أداة يمكن أن يستخدمها النموذج

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

الوظيفة

أداة يمكن أن يستخدمها النموذج

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "function".

name string  (اختياري)

اسم الدالة

description string  (اختياري)

تمثّل هذه السمة وصفًا للدالة.

parameters object  (اختيارية)

مخطط JSON الخاص بمعلَمات الدالة.

CodeExecution

أداة يمكن أن يستخدمها النموذج لتنفيذ الرمز البرمجي

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "code_execution".

UrlContext

أداة يمكن أن يستخدمها النموذج لجلب سياق عنوان URL.

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "url_context".

ComputerUse

أداة يمكن أن يستخدمها النموذج للتفاعل مع الكمبيوتر

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "computer_use".

environment enum (string)  (اختياري)

البيئة التي يتم تشغيلها

القيم المحتملة:

  • browser
excluded_predefined_functions array (string)  (اختيارية)

قائمة الدوال المحدّدة مسبقًا والتي تم استبعادها من طلب النموذج

McpServer

‫MCPServer هو خادم يمكن أن يستدعيه النموذج لتنفيذ إجراءات.

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "mcp_server".

name string  (اختياري)

تمثّل هذه السمة اسم MCPServer.

url string  (اختياري)

عنوان URL الكامل لنقطة نهاية MCPServer مثال: "https://api.example.com/mcp"

العناوين كائن  (اختياري)

اختياري: حقول لعناوين المصادقة ومهلات الانتظار وما إلى ذلك، إذا لزم الأمر

allowed_tools AllowedTools  (اختياري)

الأدوات المسموح بها

إعدادات الأدوات المسموح بها

الحقول

mode ToolChoiceType  (اختياري)

وضع اختيار الأداة

القيم المحتملة:

  • auto
  • any
  • none
  • validated

tools array (string)  (اختياري)

تمثّل هذه السمة أسماء الأدوات المسموح بها.

GoogleSearch

أداة يمكن أن يستخدمها النموذج للبحث على Google

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "google_search".

search_types array (enum (string))  (اختياري)

أنواع البحث المستند إلى معلومات أساسية التي يجب تفعيلها

القيم المحتملة:

  • web_search
  • image_search
  • enterprise_web_search
FileSearch

أداة يمكن للنموذج استخدامها للبحث في الملفات

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "file_search".

file_search_store_names array (string)  (اختياري)

أسماء متاجر البحث عن الملفات

top_k integer  (optional)

عدد أجزاء الاسترجاع الدلالي المطلوب استرجاعها.

metadata_filter string  (اختياري)

فلتر البيانات الوصفية الذي سيتم تطبيقه على المستندات والأجزاء التي يتم استرجاعها دلاليًا.

GoogleMaps

أداة يمكن أن يستخدمها النموذج للاتصال بخدمة "خرائط Google"

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "google_maps".

enable_widget boolean  (اختياري)

تحديد ما إذا كان سيتم عرض رمز مميّز لسياق التطبيق المصغّر في نتيجة استدعاء الأداة ضمن الردّ.

latitude number  (اختياري)

تمثّل هذه السمة خط العرض للموقع الجغرافي للمستخدم.

longitude number  (اختياري)

تمثّل هذه السمة خط الطول للموقع الجغرافي للمستخدم.

الاسترجاع

أداة يمكن أن يستخدمها النموذج لاسترداد الملفات

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "retrieval".

retrieval_types array (enum (string))  (اختيارية)

أنواع استرداد الملفات التي يجب تفعيلها

القيم المحتملة:

  • vertex_ai_search
vertex_ai_search_config VertexAISearchConfig  (اختياري)

تُستخدَم لتحديد إعدادات VertexAISearch.

تُستخدَم لتحديد إعدادات VertexAISearch.

الحقول

engine string  (اختياري)

اختياريّ. تُستخدَم لتحديد محرّك بحث Vertex AI Search.

datastores array (string)  (اختياري)

اختياريّ. تُستخدَم لتحديد مخازن بيانات Vertex AI Search.

أمثلة

الوظيفة

CodeExecution

UrlContext

ComputerUse

McpServer

GoogleSearch

FileSearch

GoogleMaps

الاسترجاع

لا تتوفّر أمثلة لهذا النوع.

InteractionSseEvent

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: event_type

InteractionCreatedEvent

event_type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "interaction.created".

interaction Interaction  (حقل مطلوب)

لم يتم تقديم أي وصف.

event_id string  (اختياري)

الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.

InteractionCompletedEvent

event_type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "interaction.completed".

interaction Interaction  (حقل مطلوب)

الحقل مطلوب. التفاعل المكتمل مع مخرجات فارغة لتقليل حجم حمولة البيانات استخدِم أحداث ContentDelta السابقة للحصول على الناتج الفعلي.

event_id string  (اختياري)

الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.

InteractionStatusUpdate

event_type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "interaction.status_update".

interaction_id string  (مطلوبة)

لم يتم تقديم أي وصف.

الحالة enum (string)  (مطلوبة)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
event_id string  (اختياري)

الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.

ErrorEvent

event_type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "error".

error Error  (اختياري)

لم يتم تقديم أي وصف.

رسالة الخطأ من تفاعل.

الحقول

code string  (اختياري)

تمثّل هذه السمة معرّف الموارد المنتظم (URI) الذي يحدّد نوع الخطأ.

message string  (اختياري)

رسالة خطأ يمكن لشخص عادي قراءتها

event_id string  (اختياري)

الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.

StepStart

event_type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "step.start".

index عدد صحيح  (مطلوب)

لم يتم تقديم أي وصف.

الخطوة الخطوة  (مطلوبة)

لم يتم تقديم أي وصف.

خطوة في التفاعل

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

UserInputStep

تمثّل هذه السمة الإدخال الذي يقدّمه المستخدم.

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "user_input".

content مصفوفة (Content)  (اختياري)

لم يتم تقديم أي وصف.

ModelOutputStep

الناتج الذي يصدره النموذج

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "model_output".

content مصفوفة (Content)  (اختياري)

لم يتم تقديم أي وصف.

ThoughtStep

خطوة فكرية

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "thought".

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

summary ThoughtSummaryContent  (اختياري)

ملخّص الفكرة

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

TextContent

مقطع محتوى نصي

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "text".

text string  (مطلوبة)

الحقل مطلوب. محتوى النص

annotations Annotation  (اختياري)

معلومات الاقتباس للمحتوى من إنشاء النماذج

معلومات الاقتباس للمحتوى من إنشاء النماذج

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

UrlCitation

تعليق توضيحي لاقتباس من عنوان URL

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "url_citation".

url string  (اختياري)

تمثّل هذه السمة عنوان URL.

title string  (اختياري)

تمثّل هذه السمة عنوان URL.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

FileCitation

تعليق توضيحي لاقتباس ملف

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "file_citation".

document_uri string  (اختيارية)

معرّف الموارد المنتظم (URI) للملف

file_name string  (اختيارية)

تمثّل هذه السمة اسم الملف.

source string  (اختياري)

المصدر الذي تم الاستناد إليه في جزء من النص

custom_metadata object  (اختياري)

بيانات التعريف التي قدّمها المستخدم حول السياق الذي تم استرجاعه

page_number عدد صحيح  (اختياري)

تمثّل هذه السمة رقم صفحة المستند المُقتبَس منه، إذا كان ذلك منطبقًا.

media_id string  (اختياري)

تمثّل هذه السمة رقم تعريف الوسائط في حال الاقتباس من الصور، إذا كان ذلك منطبقًا.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

PlaceCitation

تعليق توضيحي بشأن توثيق مكان

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "place_citation".

place_id string  (اختياري)

معرّف المكان بالتنسيق `places/{place_id}`

name string  (اختياري)

تمثّل هذه السمة عنوان المكان.

url string  (اختياري)

تمثّل هذه السمة مرجع معرّف الموارد المنتظم (URI) للمكان.

review_snippets ReviewSnippet  (اختياري)

مقتطفات من المراجعات تُستخدَم لإنشاء إجابات عن ميزات مكان معيّن في "خرائط Google"

تتضمّن هذه السمة مقتطفًا من مراجعة كتبها مستخدم يجيب فيها عن سؤال حول ميزات مكان معيّن في "خرائط Google".

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان المراجعة.

url string  (اختياري)

رابط يؤدي إلى مراجعة المستخدم على "خرائط Google".

review_id string  (اختياري)

رقم تعريف مقتطف من المراجعة.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

ImageContent

كتلة محتوى صورة

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "image".

data string  (اختياري)

محتوى الصورة

uri string  (اختياري)

تمثّل هذه السمة معرّف الموارد المنتظم (URI) الخاص بالصورة.

mime_type enum (string)  (اختياري)

نوع MIME الخاص بالصورة.

القيم المحتملة:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (اختياري)

تمثّل درجة دقة الوسائط.

القيم المحتملة:

  • low
  • medium
  • high
  • ultra_high

FunctionCallStep

خطوة استدعاء أداة الدالة

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "function_call".

name string  (مطلوب)

الحقل مطلوب. تمثّل هذه السمة اسم الأداة المطلوب استدعاؤها.

arguments object  (مطلوب)

الحقل مطلوب. الوسيطات التي سيتم تمريرها إلى الدالة

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

CodeExecutionCallStep

خطوة طلب تنفيذ الرمز البرمجي

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "code_execution_call".

arguments CodeExecutionCallStepArguments  (مطلوب)

الحقل مطلوب. الوسيطات التي سيتم تمريرها إلى تنفيذ الرمز البرمجي

الوسيطات التي سيتم تمريرها إلى تنفيذ الرمز البرمجي

الحقول

language enum (string)  (اختيارية)

لغة البرمجة الخاصة بالرمز البرمجي.

القيم المحتملة:

  • python
code string  (اختياري)

الرمز البرمجي المطلوب تنفيذه

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

UrlContextCallStep

خطوة طلب سياق عنوان URL

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "url_context_call".

arguments UrlContextCallStepArguments  (مطلوب)

الحقل مطلوب. الوسيطات التي سيتم تمريرها إلى سياق عنوان URL.

الوسيطات التي سيتم تمريرها إلى سياق عنوان URL.

الحقول

urls مصفوفة (سلسلة)  (اختيارية)

عناوين URL المطلوب استرجاعها

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

McpServerToolCallStep

خطوة استدعاء أداة MCPServer

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "mcp_server_tool_call".

name string  (مطلوب)

الحقل مطلوب. اسم الأداة التي تم استدعاؤها

server_name string  (مطلوبة)

الحقل مطلوب. تمثّل هذه السمة اسم خادم MCP المستخدَم.

arguments object  (مطلوب)

الحقل مطلوب. عنصر JSON الخاص بوسيطات الدالة

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

GoogleSearchCallStep

خطوة المكالمة على "بحث Google"

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "google_search_call".

arguments GoogleSearchCallStepArguments  (مطلوبة)

الحقل مطلوب. الوسيطات التي يجب تمريرها إلى "بحث Google"

الوسيطات التي يجب تمريرها إلى "بحث Google"

الحقول

queries array (string)  (اختياري)

طلبات البحث على الويب التي يتم إجراؤها بعد البحث الأولي على الويب

search_type enum (string)  (اختياري)

نوع البحث المستند إلى بيانات مفعَّل.

القيم المحتملة:

  • web_search
  • image_search
  • enterprise_web_search
id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

FileSearchCallStep

خطوة طلب البحث عن الملفات

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "file_search_call".

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

GoogleMapsCallStep

خطوة الاتصال في "خرائط Google"

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "google_maps_call".

arguments GoogleMapsCallStepArguments  (اختياري)

الوسيطات التي سيتم تمريرها إلى أداة "خرائط Google"

الوسيطات التي سيتم تمريرها إلى أداة "خرائط Google"

الحقول

queries array (string)  (اختياري)

طلبات البحث التي سيتم تنفيذها.

id string  (مطلوبة)

الحقل مطلوب. معرّف فريد لطلب استخدام الأداة المحدّدة هذا.

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

FunctionResultStep

نتيجة استدعاء أداة دالة

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "function_result".

name string  (اختياري)

تمثّل هذه السمة اسم الأداة التي تم استدعاؤها.

is_error boolean  (اختياري)

تُستخدَم لتحديد ما إذا كان استدعاء الأداة قد أدّى إلى حدوث خطأ.

call_id string  (مطلوبة)

الحقل مطلوب. معرّف يجب أن يتطابق مع المعرّف من مربّع استدعاء الدالة

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

result array (FunctionResultSubcontent) or string  (مطلوبة)

نتيجة استدعاء الأداة

CodeExecutionResultStep

خطوة نتيجة تنفيذ الرمز البرمجي

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "code_execution_result".

result string  (مطلوبة)

الحقل مطلوب. ناتج تنفيذ الرمز البرمجي

is_error boolean  (اختياري)

تُستخدَم لتحديد ما إذا كان تنفيذ الرمز البرمجي قد أدّى إلى حدوث خطأ.

call_id string  (مطلوبة)

الحقل مطلوب. معرّف يجب أن يتطابق مع المعرّف من مربّع استدعاء الدالة

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

UrlContextResultStep

خطوة نتيجة سياق عنوان URL

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "url_context_result".

result UrlContextResultItem  (مطلوب)

الحقل مطلوب. نتائج سياق عنوان URL

نتيجة سياق عنوان URL

الحقول

url string  (اختياري)

عنوان URL الذي تم استرجاعه.

الحالة تعداد (سلسلة)  (اختياري)

حالة استرداد عنوان URL

القيم المحتملة:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (اختياري)

تُستخدَم لتحديد ما إذا كان سياق عنوان URL قد أدّى إلى حدوث خطأ.

call_id string  (مطلوبة)

الحقل مطلوب. معرّف يجب أن يتطابق مع المعرّف من مربّع استدعاء الدالة

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

GoogleSearchResultStep

خطوة نتيجة البحث من Google

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "google_search_result".

result GoogleSearchResultItem  (مطلوبة)

الحقل مطلوب. نتائج بحث Google

نتيجة بحث Google.

الحقول

search_suggestions string  (اختيارية)

مقتطف من محتوى الويب يمكن تضمينه في صفحة ويب أو WebView في تطبيق

is_error boolean  (اختياري)

تُستخدَم لتحديد ما إذا كان البحث على Google قد أدّى إلى حدوث خطأ.

call_id string  (مطلوبة)

الحقل مطلوب. معرّف يجب أن يتطابق مع المعرّف من مربّع استدعاء الدالة

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

McpServerToolResultStep

خطوة نتيجة أداة MCPServer

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "mcp_server_tool_result".

name string  (اختياري)

اسم الأداة التي يتم استدعاؤها لتنفيذ طلب الأداة المحدّد هذا.

server_name string  (اختياري)

تمثّل هذه السمة اسم خادم MCP المستخدَم.

call_id string  (مطلوبة)

الحقل مطلوب. معرّف يجب أن يتطابق مع المعرّف من مربّع استدعاء الدالة

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

result array (FunctionResultSubcontent) or string  (مطلوبة)

الناتج من طلب خادم MCP يمكن أن يكون نصًا بسيطًا أو محتوًى وافيًا.

FileSearchResultStep

خطوة نتيجة البحث عن الملفات

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "file_search_result".

call_id string  (مطلوبة)

الحقل مطلوب. معرّف يجب أن يتطابق مع المعرّف من مربّع استدعاء الدالة

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

GoogleMapsResultStep

خطوة نتيجة "خرائط Google"

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "google_maps_result".

result GoogleMapsResultItem  (مطلوب)

لم يتم تقديم أي وصف.

نتيجة "خرائط Google"

الحقول

places GoogleMapsResultPlaces  (اختياري)

لم يتم تقديم أي وصف.

الحقول

place_id string  (اختياري)

لم يتم تقديم أي وصف.

name string  (اختياري)

لم يتم تقديم أي وصف.

url string  (اختياري)

لم يتم تقديم أي وصف.

review_snippets ReviewSnippet  (اختياري)

لم يتم تقديم أي وصف.

تتضمّن هذه السمة مقتطفًا من مراجعة كتبها مستخدم يجيب فيها عن سؤال حول ميزات مكان معيّن في "خرائط Google".

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان المراجعة.

url string  (اختياري)

رابط يؤدي إلى مراجعة المستخدم على "خرائط Google".

review_id string  (اختياري)

رقم تعريف مقتطف من المراجعة.

widget_context_token string  (اختياري)

لم يتم تقديم أي وصف.

call_id string  (مطلوبة)

الحقل مطلوب. معرّف يجب أن يتطابق مع المعرّف من مربّع استدعاء الدالة

signature string  (اختياري)

تجزئة توقيع للتحقّق من صحة البيانات في الخلفية

event_id string  (اختياري)

الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.

StepDelta

event_type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "step.delta".

index عدد صحيح  (مطلوب)

لم يتم تقديم أي وصف.

delta StepDeltaData  (مطلوبة)

لم يتم تقديم أي وصف.

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

TextDelta

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "text".

text string  (مطلوبة)

لم يتم تقديم أي وصف.

ImageDelta

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "image".

data string  (اختياري)

لم يتم تقديم أي وصف.

uri string  (اختياري)

لم يتم تقديم أي وصف.

mime_type enum (string)  (اختياري)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (اختياري)

تمثّل درجة دقة الوسائط.

القيم المحتملة:

  • low
  • medium
  • high
  • ultra_high

AudioDelta

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "audio".

data string  (اختياري)

لم يتم تقديم أي وصف.

uri string  (اختياري)

لم يتم تقديم أي وصف.

mime_type enum (string)  (اختياري)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
rate عدد صحيح  (اختياري)

تمّ الإيقاف. استخدِم sample_rate بدلاً من ذلك. يتم تجاهل القيمة.

sample_rate integer  (اختيارية)

معدّل عيّنة الصوت

channels عدد صحيح  (اختياري)

تمثّل هذه السمة عدد القنوات الصوتية.

DocumentDelta

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "document".

data string  (اختياري)

لم يتم تقديم أي وصف.

uri string  (اختياري)

لم يتم تقديم أي وصف.

mime_type enum (string)  (اختياري)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • application/pdf
VideoDelta

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "video".

data string  (اختياري)

لم يتم تقديم أي وصف.

uri string  (اختياري)

لم يتم تقديم أي وصف.

mime_type enum (string)  (اختياري)

لم يتم تقديم أي وصف.

القيم المحتملة:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (اختياري)

تمثّل درجة دقة الوسائط.

القيم المحتملة:

  • low
  • medium
  • high
  • ultra_high

ThoughtSummaryDelta

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "thought_summary".

content ThoughtSummaryContent  (اختياري)

عنصر ملخّص جديد ستتم إضافته إلى الفكرة.

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

TextContent

مقطع محتوى نصي

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "text".

text string  (مطلوبة)

الحقل مطلوب. محتوى النص

annotations Annotation  (اختياري)

معلومات الاقتباس للمحتوى من إنشاء النماذج

معلومات الاقتباس للمحتوى من إنشاء النماذج

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

UrlCitation

تعليق توضيحي لاقتباس من عنوان URL

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "url_citation".

url string  (اختياري)

تمثّل هذه السمة عنوان URL.

title string  (اختياري)

تمثّل هذه السمة عنوان URL.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

FileCitation

تعليق توضيحي لاقتباس ملف

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "file_citation".

document_uri string  (اختيارية)

معرّف الموارد المنتظم (URI) للملف

file_name string  (اختيارية)

تمثّل هذه السمة اسم الملف.

source string  (اختياري)

المصدر الذي تم الاستناد إليه في جزء من النص

custom_metadata object  (اختياري)

بيانات التعريف التي قدّمها المستخدم حول السياق الذي تم استرجاعه

page_number عدد صحيح  (اختياري)

تمثّل هذه السمة رقم صفحة المستند المُقتبَس منه، إذا كان ذلك منطبقًا.

media_id string  (اختياري)

تمثّل هذه السمة رقم تعريف الوسائط في حال الاقتباس من الصور، إذا كان ذلك منطبقًا.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

PlaceCitation

تعليق توضيحي بشأن توثيق مكان

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "place_citation".

place_id string  (اختياري)

معرّف المكان بالتنسيق `places/{place_id}`

name string  (اختياري)

تمثّل هذه السمة عنوان المكان.

url string  (اختياري)

تمثّل هذه السمة مرجع معرّف الموارد المنتظم (URI) للمكان.

review_snippets ReviewSnippet  (اختياري)

مقتطفات من المراجعات تُستخدَم لإنشاء إجابات عن ميزات مكان معيّن في "خرائط Google"

تتضمّن هذه السمة مقتطفًا من مراجعة كتبها مستخدم يجيب فيها عن سؤال حول ميزات مكان معيّن في "خرائط Google".

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان المراجعة.

url string  (اختياري)

رابط يؤدي إلى مراجعة المستخدم على "خرائط Google".

review_id string  (اختياري)

رقم تعريف مقتطف من المراجعة.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

ImageContent

كتلة محتوى صورة

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "image".

data string  (اختياري)

محتوى الصورة

uri string  (اختياري)

تمثّل هذه السمة معرّف الموارد المنتظم (URI) الخاص بالصورة.

mime_type enum (string)  (اختياري)

نوع MIME الخاص بالصورة.

القيم المحتملة:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (اختياري)

تمثّل درجة دقة الوسائط.

القيم المحتملة:

  • low
  • medium
  • high
  • ultra_high

ThoughtSignatureDelta

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "thought_signature".

signature string  (اختياري)

توقيع لمطابقة المصدر الخلفي الذي سيتم تضمينه في عملية الإنشاء

TextAnnotationDelta

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "text_annotation_delta".

annotations Annotation  (اختياري)

معلومات الاقتباس للمحتوى من إنشاء النماذج

معلومات الاقتباس للمحتوى من إنشاء النماذج

الأنواع المحتمَلة

المميّز المتعدّد الأشكال: type

UrlCitation

تعليق توضيحي لاقتباس من عنوان URL

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "url_citation".

url string  (اختياري)

تمثّل هذه السمة عنوان URL.

title string  (اختياري)

تمثّل هذه السمة عنوان URL.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

FileCitation

تعليق توضيحي لاقتباس ملف

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "file_citation".

document_uri string  (اختيارية)

معرّف الموارد المنتظم (URI) للملف

file_name string  (اختيارية)

تمثّل هذه السمة اسم الملف.

source string  (اختياري)

المصدر الذي تم الاستناد إليه في جزء من النص

custom_metadata object  (اختياري)

بيانات التعريف التي قدّمها المستخدم حول السياق الذي تم استرجاعه

page_number عدد صحيح  (اختياري)

تمثّل هذه السمة رقم صفحة المستند المُقتبَس منه، إذا كان ذلك منطبقًا.

media_id string  (اختياري)

تمثّل هذه السمة رقم تعريف الوسائط في حال الاقتباس من الصور، إذا كان ذلك منطبقًا.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

PlaceCitation

تعليق توضيحي بشأن توثيق مكان

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "place_citation".

place_id string  (اختياري)

معرّف المكان بالتنسيق `places/{place_id}`

name string  (اختياري)

تمثّل هذه السمة عنوان المكان.

url string  (اختياري)

تمثّل هذه السمة مرجع معرّف الموارد المنتظم (URI) للمكان.

review_snippets ReviewSnippet  (اختياري)

مقتطفات من المراجعات تُستخدَم لإنشاء إجابات عن ميزات مكان معيّن في "خرائط Google"

تتضمّن هذه السمة مقتطفًا من مراجعة كتبها مستخدم يجيب فيها عن سؤال حول ميزات مكان معيّن في "خرائط Google".

الحقول

title string  (اختياري)

تمثّل هذه السمة عنوان المراجعة.

url string  (اختياري)

رابط يؤدي إلى مراجعة المستخدم على "خرائط Google".

review_id string  (اختياري)

رقم تعريف مقتطف من المراجعة.

start_index integer  (اختياري)

بداية جزء الردّ الذي يعود إلى هذا المصدر يشير الفهرس إلى بداية المقطع، ويتم قياسه بالبايت.

end_index عدد صحيح  (اختياري)

نهاية الجزء الذي تم تحديد مصدره، غير مشمولة.

ArgumentsDelta

type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "arguments_delta".

partial_arguments string  (اختيارية)

لم يتم تقديم أي وصف.

event_id string  (اختياري)

الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.

StepStop

event_type object  (مطلوبة)

لم يتم تقديم أي وصف.

يجب ضبطها دائمًا على "step.stop".

index عدد صحيح  (مطلوب)

لم يتم تقديم أي وصف.

event_id string  (اختياري)

الرمز المميّز event_id الذي سيتم استخدامه لاستئناف بث التفاعل، بدءًا من هذا الحدث.

أمثلة

تم إنشاء التفاعل

{
  "event_type": "interaction.created",
  "interaction": {
    "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
    "model": "gemini-3-flash-preview",
    "status": "in_progress",
    "created": "2025-12-04T15:01:45Z",
    "updated": "2025-12-04T15:01:45Z"
  },
  "event_id": "evt_123"
}

اكتمل التفاعل

{
  "event_type": "interaction.completed",
  "interaction": {
    "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
    "model": "gemini-3-flash-preview",
    "status": "completed",
    "created": "2025-12-04T15:01:45Z",
    "updated": "2025-12-04T15:01:45Z"
  },
  "event_id": "evt_123"
}

تعديل حالة التفاعل

{
  "event_type": "interaction.status_update",
  "interaction_id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
  "status": "in_progress"
}

حدث الخطأ

{
  "event_type": "error",
  "error": {
    "message": "Failed to get completed interaction: Result not found.",
    "code": "not_found"
  }
}

بدء الخطوة

{
  "event_type": "step.start",
  "index": 0,
  "step": {
    "type": "model_output"
  }
}

الفرق بين الخطوات

{
  "event_type": "step.delta",
  "index": 0,
  "delta": {
    "type": "text",
    "text": "Hello"
  }
}

Step Stop

{
  "event_type": "step.stop",
  "index": 0
}