الردود البسيطة

مثال لردّ بسيط على جهاز جوّال

تأخذ الردود البسيطة شكل فقاعة محادثة بشكل مرئي وتستخدم أداة تحويل النص إلى كلام (TTS) أو لغة ترميز تركيب الكلام (SSML) للصوت. باستخدام ردود قصيرة وبسيطة في المحادثة، يمكنك الحفاظ على تفاعل المستخدمين من خلال واجهة مرئية وصوتية واضحة يمكن إقرانها مع عناصر المحادثة الأخرى.

يجب أن يكون محتوى فقاعات المحادثة في استجابة بسيطة مجموعة فرعية صوتية أو نصًا كاملاً من مخرجات TTS/SSML. يساعد هذا المستخدمين على تحديد ما يقوله الإجراء الخاص بك ويزيد من الفهم في ظروف مختلفة.

في الطلب، يستخدم النص الذي تقدّمه في العنصرَين first_simple وlast_simple خصائص استجابة بسيطة. يرسل "مساعد Google" جميع الردود البسيطة في طلب، ثم يرسل الردّ المنسّقة النهائي في قائمة انتظار الطلبات.

أماكن إقامة

يضم نوع الرد البسيط الخصائص التالية:

الموقع Type المتطلب الوصف
speech سلسلة إجراء اختياري تمثّل هذه السمة الكلمات التي سيتم قولها إلى المستخدم في تنسيق SSML أو ميزة "تحويل النص إلى كلام". إذا كان الحقل override في الطلب الذي يتضمّن الطلب هو "صحيح"، سيحل الكلام المحدّد في هذا الحقل محل الكلام السابق للطلب البسيط.
text سلسلة إجراء اختياري

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

وفي حال عدم توفيرها، سيعرض "مساعد Google" نسخة معروضة من الحقل speech بدلاً من ذلك. إذا كان الحقل override في الطلب الذي يتضمّن الطلب "خطأ"، سيتم إلحاق النص المحدّد في هذا الحقل بنص الطلب البسيط السابق.

مثال على ردّ بسيط على الشاشة الذكية

نموذج التعليمات البرمجية

YAML

candidates:
  - first_simple:
      variants:
        - speech: This is the first simple response.
          text: This is the 1st simple response.
    last_simple:
      variants:
        - speech: This is the last simple response.
          text: This is the last simple response.

تنسيق JSON

{
  "candidates": [
    {
      "first_simple": {
        "variants": [
          {
            "speech": "This is the first simple response.",
            "text": "This is the 1st simple response."
          }
        ]
      },
      "last_simple": {
        "variants": [
          {
            "speech": "This is the last simple response.",
            "text": "This is the last simple response."
          }
        ]
      }
    }
  ]
}

Node.js

app.handle('Simple', conv => {
  conv.add(new Simple({
    speech: 'This is the first simple response.',
    text: 'This is the 1st simple response.'
  }));
  conv.add(new Simple({
    speech: 'This is the last simple response.',
    text: 'This is the last simple response.'
  }));
});

تنسيق JSON

{
  "responseJson": {
    "session": {
      "id": "session_id",
      "params": {}
    },
    "prompt": {
      "override": false,
      "firstSimple": {
        "speech": "This is the first simple response.",
        "text": "This is the 1st simple response."
      },
      "lastSimple": {
        "speech": "This is the last simple response.",
        "text": "This is the last simple response."
      }
    }
  }
}

SSML والأصوات

يمكنك استخدام SSML والأصوات في ردودك لمنحها طابعًا أكثر صقلًا وتحسين تجربة المستخدم. راجِع وثائق SSML للحصول على مزيد من المعلومات.

مكتبة الملفات الصوتية

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