Gemini: إنشاء نص

استخدم Gemini: إنشاء نص لطلب نص قصير من نموذج Google Gemini في منتصف الرحلة، ثم أعد استخدامه لاحقًا في رسالة push أو بريد إلكتروني أو رسالة SMS. تتم المصادقة في هذه النقطة باستخدام مفتاح Gemini API الخاص بها. وهي لا تستخدم أي تكامل على مستوى الحساب تم تكوينه في مكان آخر في الإعدادات.

الاستخدامات النموذجية:

• تخصيص سطر الرسالة: صياغة سطر جذاب من علامات (tags) المسافر، ثم إدراجه في رسالة push أو البريد الإلكتروني التالية باستخدام المحتوى الديناميكي (Dynamic Content).
• التلخيص قبل الإرسال: تحويل بعض العلامات (tags)، مثل آخر طلب أو فئة التصفح، إلى سطر قصير بلغة طبيعية يمكن للقالب عرضه.
• تنويع الصياغة: طلب صياغة مختلفة قليلاً في كل مرة حتى لا يرى المسافرون نصًا متطابقًا في كل مرة يمرون فيها.

تكوين النقطة

1. اسحب Gemini: إنشاء نص من قسم التكاملات (Integrations) في اللوحة اليسرى إلى لوحة العمل (canvas).
2. انقر نقرًا مزدوجًا على النقطة وأدخل اسم الخطوة (Step Name).
3. في مفتاح Gemini API، أدخل مفتاح Gemini API الخاص بك. يتم تخزينه بشكل مقنّع، مثل رأس سري لـ webhook.

4. في النموذج (Model)، اختر نموذج Gemini المراد استخدامه. الإعداد الافتراضي هو gemini-2.5-flash-lite.

   • gemini-2.5-flash-lite: الافتراضي.
   • gemini-2.5-flash: تكلفته لكل توكن (token) أعلى من Flash Lite.

   لا يتم تقديم Gemini 2.5 Pro هنا: لا يمكنه إيقاف خطوة الاستدلال الخاصة به، لذلك ليس من المضمون أن ينتهي في غضون مهلة 10 ثوانٍ للنقطة.

   كل استدعاء يتم محاسبته على مفتاح Gemini الخاص بك لكل مسافر يصل إلى هذه الخطوة.

5. في الموجه (Prompt)، اكتب ما تريد أن ينشئه النموذج. يأخذ نفس وحدات الماكرو (macros) مثل أي جسم Webhook، على سبيل المثال {{device:hwid}}.

6. انقر على حفظ (Save).

يتم إيقاف الاستدلال وتقتصر الاستجابات على حوالي 300 توكن (token) (فقرة قصيرة تقريبًا) للحفاظ على الطلب ضمن مهلة Webhook. اطلب شيئًا قصيرًا. الموجه الأطول أو الأكثر تفصيلاً لا يحصل على مساحة أكبر للإجابة.

الاستجابة

يستمر المسافر إلى أي خطوة تقوم بتوصيلها بعد ذلك على لوحة العمل (canvas).

السمات بعد تشغيل الخطوة

السمة	ما تحتويه
llm_text	النص الذي تم إنشاؤه
llm_input_tokens	عدد التوكنات (tokens) لمدخلات الطلب
llm_output_tokens	عدد التوكنات (tokens) لمخرجات الطلب

كيفية استخدام llm_text في الخطوات اللاحقة

• إدراجه في رسالة push أو بريد إلكتروني أو رسالة SMS: استخدم المحتوى الديناميكي (Dynamic Content).
• التفرع بناءً عليه باستخدام تقسيم الشرط (Condition split): احفظه في علامة (Tag) أولاً باستخدام تحديث ملف تعريف المستخدم (Update user profile)، ثم قم بالتقسيم بناءً على تلك العلامة (Tag).

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

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

الاستجابة التي تعود ولكنها ليست كما توقعت تبقي المسافر في الرحلة:

• النص مقطوع عند حد 300 توكن (token): تحتوي llm_text على النص المبتور.
• رفض النموذج الإجابة: تحتوي llm_text على أي شيء أجاب به بدلاً من ذلك.

سيناريو مثال: صياغة نصيحة متابعة الطلب في رسالة SMS باستخدام Gemini

يريد فريق أن تتضمن رسالة SMS لتأكيد الطلب نصيحة رعاية قصيرة خاصة بالمنتج بدلاً من مجرد رقم الطلب.

1. أضف Gemini: إنشاء نص مباشرة بعد الخطوة التي تؤكد الطلب. في الموجه (Prompt)، اكتب Write one short care tip for someone who just bought {{tag:Last Purchased Category}}.
2. أضف خطوة إرسال SMS مباشرة بعدها، باستخدام المحتوى الديناميكي (Dynamic Content) لإدراج llm_text في نص رسالة SMS.

بمجرد تشغيل هذا، يتضمن كل تأكيد طلب نصيحة ذات صلة بما اشتراه المسافر، بدلاً من نفس السطر لكل طلب.