با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
پاسخ‌های ساده از نظر بصری به شکل حباب چت هستند و از متن به گفتار (TTS) یا زبان نشانه‌گذاری ترکیبی گفتار (SSML) برای صدا استفاده می‌کنند. با استفاده از پاسخ‌های ساده کوتاه در مکالمه، می‌توانید کاربران را با یک رابط بصری و صوتی واضح که می‌تواند با سایر عناصر مکالمه جفت شود، درگیر نگه دارید.
محتوای حباب چت در یک پاسخ ساده باید یک زیر مجموعه آوایی یا رونوشت کامل خروجی TTS/SSML باشد. این به کاربران کمک می کند تا آنچه را که Action شما می گوید ترسیم کنند و درک مطلب را در شرایط مختلف افزایش می دهد.
در یک اعلان، متنی که در اشیاء first_simple و last_simple ارائه می کنید، از ویژگی های یک پاسخ ساده استفاده می کند. Google Assistant همه پاسخ‌های ساده را در یک درخواست ارسال می‌کند، سپس پاسخ غنی نهایی را در صف درخواست ارسال می‌کند.
خواص
نوع پاسخ ساده دارای ویژگی های زیر است:
اموال
تایپ کنید
مورد نیاز
توضیحات
speech
رشته
اختیاری
بیانگر کلماتی است که باید به کاربر در SSML یا تبدیل متن به گفتار گفته شود. اگر فیلد override در دستور حاوی "true" باشد، گفتار تعریف شده در این قسمت جایگزین گفتار دستور ساده قبلی می شود.
text
رشته
اختیاری
متن برای نمایش در حباب چت. رشته های بیش از 640 کاراکتر در اولین شکست کلمه (یا فضای خالی) قبل از 640 کاراکتر کوتاه می شوند. توصیه می کنیم از کمتر از 300 کاراکتر برای جلوگیری از امتداد محتوا به صفحه نمایش استفاده کنید، به خصوص زمانی که با کارت یا عناصر بصری دیگر جفت می شود.
اگر «دستیار» ارائه نشود، به جای آن یک نسخه نمایشگر از قسمت 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(newSimple({speech:'This is the first simple response.',text:'This is the 1st simple response.'}));conv.add(newSimple({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 خود بگنجانید.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eSimple responses use chat bubbles with text-to-speech or SSML for audio, keeping users engaged with a clear interface.\u003c/p\u003e\n"],["\u003cp\u003eChat bubble content should be a phonetic subset or a complete transcript of the audio output for better user comprehension.\u003c/p\u003e\n"],["\u003cp\u003eSimple responses are sent before the final rich response, and some surfaces may only display the rich response.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003espeech\u003c/code\u003e property defines what the Assistant says, while the \u003ccode\u003etext\u003c/code\u003e property defines what's displayed in the chat bubble.\u003c/p\u003e\n"],["\u003cp\u003eSSML and sounds can be used to enhance simple responses, with a sound library available for use.\u003c/p\u003e\n"]]],[],null,["# Simple responses take the form of a chat bubble visually and use text-to-speech\n(TTS) or Speech Synthesis Markup Language (SSML) for sound. By using short\nsimple responses in conversation, you can keep users engaged with a clear visual\nand audio interface that can be paired with other conversational elements.\n\nChat bubble content in a simple response must be a phonetic subset or a complete\ntranscript of the TTS/SSML output. This helps users map out what your Action\nsays and increases comprehension in various conditions.\n\nIn a prompt, text you provide in the `first_simple` and `last_simple` objects\nuse the properties of a simple response. Google Assistant sends all simple\nresponses in a prompt, then sends the final rich response in the prompt queue.\n| **Note:** Some surfaces (like smart displays) only display one piece of content at a time instead of using the chat bubble format. As a result, only the rich response appears when you provide both a simple and a rich response.\n\nProperties\n----------\n\nThe simple response type has the following properties:\n\n| Property | Type | Requirement | Description |\n|----------|--------|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `speech` | string | Optional | Represents the words to be spoken to the user in SSML or text-to-speech. If the `override` field in the containing prompt is \"true\", then speech defined in this field replaces the previous simple prompt's speech. |\n| `text` | string | Optional | Text to display in the chat bubble. Strings longer than 640 characters are truncated at the first word break (or whitespace) before 640 characters. We recommend using less than 300 characters to prevent content from extending past the screen, especially when paired with a card or other visual element. If not provided, Assistant renders a display version of the `speech` field instead. If the `override` field in the containing prompt is \"false\", then text defined in this field is appended to the previous simple prompt's text. |\n\nSample code\n-----------\n\n### YAML\n\n```yaml\ncandidates:\n - first_simple:\n variants:\n - speech: This is the first simple response.\n text: This is the 1st simple response.\n last_simple:\n variants:\n - speech: This is the last simple response.\n text: This is the last simple response.\n```\n\n### JSON\n\n```gdscript\n{\n \"candidates\": [\n {\n \"first_simple\": {\n \"variants\": [\n {\n \"speech\": \"This is the first simple response.\",\n \"text\": \"This is the 1st simple response.\"\n }\n ]\n },\n \"last_simple\": {\n \"variants\": [\n {\n \"speech\": \"This is the last simple response.\",\n \"text\": \"This is the last simple response.\"\n }\n ]\n }\n }\n ]\n}\n```\n\n### Node.js\n\n```javascript\napp.handle('Simple', conv =\u003e {\n conv.add(new Simple({\n speech: 'This is the first simple response.',\n text: 'This is the 1st simple response.'\n }));\n conv.add(new Simple({\n speech: 'This is the last simple response.',\n text: 'This is the last simple response.'\n }));\n});\n```\n\n### JSON\n\n```carbon\n{\n \"responseJson\": {\n \"session\": {\n \"id\": \"session_id\",\n \"params\": {}\n },\n \"prompt\": {\n \"override\": false,\n \"firstSimple\": {\n \"speech\": \"This is the first simple response.\",\n \"text\": \"This is the 1st simple response.\"\n },\n \"lastSimple\": {\n \"speech\": \"This is the last simple response.\",\n \"text\": \"This is the last simple response.\"\n }\n }\n }\n}\n```\n\nSSML and sounds\n---------------\n\nUse SSML and sounds in your responses to give them more polish and enhance the\nuser experience. See the [SSML documentation](/assistant/conversational/ssml) for more information.\n\nSound library\n-------------\n\nWe provide a variety of free, short sounds in our [sound library](/assistant/tools/sound-library). These\nsounds are hosted for you, so all you need to do is include them in your SSML."]]
