تم إيقاف إجراءات المحادثات نهائيًا في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على
إنهاء إجراءات المحادثة.
نظرة عامة حول عملية الإنشاء
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لإنشاء "مهام قائمة على المحادثة"، عليك إنشاء المكوّنات التالية ونشرها:
- مشروع الإجراءات: هو الحاوية المنطقية لكل
الإجراءات الحوارية وخدمات الويب وتطبيقات الويب. ويحدّد أيضًا إعدادات المشروع والموارد التي تشرح كيفية نشر مشروعك على "إجراءات Google".
- نموذج الاستدعاء: يحدّد هذا النموذج الطريقة التي يكتشف بها المستخدمون الإجراءات داخل مشروعك ويبدؤون بها. يمكنك إنشاء نموذج الاستدعاء باستخدام النوايا والأنواع.
- نموذج المحادثة: يحدّد ما يمكن للمستخدمين قوله لـ "الإجراءات" وكيفية استجابة "الإجراءات" للمستخدمين. يمكنك إنشاء نموذج المحادثة باستخدام النوايا والأنواع والمشاهد والطلبات.
- خطافات الويب: يمكن أن تؤدي الإجراءات إلى تشغيل خطافات الويب لتفويض منطق إضافي إلى خدمات التنفيذ، مثل إنشاء الطلبات والتحقّق من صحة البيانات وغير ذلك.
- Interactive Canvas: بدلاً من إرسال ردود نصية بسيطة أو بطاقات وصور تفاعلية، يمكنك تقديم تطبيق ويب تفاعلي بملء الشاشة يستند إلى HTML وCSS وJavaScript.
توضّح الأقسام التالية الأدوات التي ستستخدمها لإنشاء الإجراءات.
المهام
واجهة برمجة التطبيقات Actions API هي مجموعة من أدوات المطوّرين لإنشاء "مهام" لـ "مساعد Google". وتتكوّن من الميزات التالية:
تمثيل مفتوح يستند إلى الملفات لمشروع "الإجراءات على Google": يمكنك إنشاء نماذج طلبات التفعيل والمحادثات باستخدام النوايا والأنواع والمشاهد والطلبات. يمكنك تعديل مشاريع "الإجراءات" باستخدام محرّر النصوص المفضّل لديك، وإضافتها إلى نظام التحكّم بالمصادر، وإنشاء عمليات مبرمَجة، وغير ذلك.
واجهة سطر الأوامر (CLI): توفّر أداة
gactions واجهة سطر الأوامر لتسريع عملية إعداد التطبيقات وتنفيذها آليًا. يتيح لك ذلك تهيئة ملفات مشاريع Action العادية، وإرسال التحديثات إلى Actions Console، ونشر مشاريع Action، وغير ذلك. تتيح لك الأداة تنفيذ العديد من مهام سير العمل الشائعة، مثل استيراد المشاريع الحالية أو بدء العمل على فرع ميزة باستخدام نظام التحكّم بالمصادر المفضّل لديك.
واجهة Actions API: هي واجهة برمجة التطبيقات نفسها التي تستخدمها أداة gactions. توفّر Actions API قائمة بنقاط نهاية REST لإدارة "الإجراءات"، بما في ذلك الاختبار والإنشاء. تتيح لك واجهة برمجة التطبيقات استخدام طلبات JSON لتنفيذ العديد من مهام سير العمل الشائعة. عند
استخدام Actions API، هناك
بعض الحدود وأفضل الممارسات التي يجب مراعاتها.
خطافات الويب ومكتبة تنفيذ Node.js: يمكن أن تفوّض "إجراءاتك" منطق النشاط التجاري إلى خدمات الويب باستخدام خطافات الويب وتنسيق مراسلة مستند إلى JSON. نوفّر مكتبة تنفيذ Node.js توفّر واجهات اصطلاحية لبرنامج Conversation Webhook. تسهّل هذه المكتبة تنفيذ العديد من مسارات المستخدمين الشائعة. على سبيل المثال، تتضمّن بعض الميزات استخراج المَعلمات من طلب بحث يقدّمه المستخدم وإنشاء تجربة متعددة الوسائط (صوت فقط وصوت ومرئيات) لـ "مساعد Google".
Actions Builder
توفّر لك أداة Actions Builder بيئة تطوير متكاملة (IDE) فعّالة وسهلة الاستخدام ومستندة إلى الويب، وهي مدمجة في Actions Console. بما أنّ Actions Builder تستند إلى التكنولوجيات نفسها التي تستخدمها Actions API، يمكنك استخدامها بمفردها أو مع Actions API حسب احتياجاتك.
تنقسم واجهة مستخدم "أداة إنشاء الإجراءات" إلى الأقسام التالية:
- تتيح القائمة العلوية الوصول إلى الأقسام المختلفة في Actions Console، ويمكنك الوصول إلى Actions Builder من خلال علامة التبويب تطوير.
- تتيح لك القائمة اليمنى الوصول إلى جميع المكوّنات اللازمة لإنشاء الإجراءات، مثل النوايا والمَشاهد.
- تتيح لك منطقة الإنشاء إنشاء المكوّن الذي تعمل عليه.
- تتيح لك منطقة التفاصيل ضبط المزيد من التفاصيل حول المكوّن الذي تعمل عليه.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-24 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-24 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eConversational Actions are built using an Actions project, an invocation model, a conversation model, webhooks, and optionally Interactive Canvas.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can utilize the Actions API, which includes an open file-based project representation, a command-line interface, a REST API, and webhook support with a Node.js library.\u003c/p\u003e\n"],["\u003cp\u003eActions Builder provides a web-based IDE within the Actions console, offering a user-friendly interface for building and managing conversational actions, integrated with the Actions API.\u003c/p\u003e\n"]]],[],null,["# Build overview\n\nTo build Conversational Actions, you create and deploy the following components:\n\n- **[Actions project](/assistant/conversational/build/projects)** - The logical container for all of your Conversational Actions, web services, and web apps. It also defines project settings and resources that describe how to deploy your project to Actions on Google.\n- **[Invocation model](/assistant/conversational/build/invocation)** - Defines how users discover and start the Actions inside your project. You build your invocation model with [intents](../intents) and [types](../types).\n- **[Conversation model](/assistant/conversational/build/conversation)** - Defines what users can say to your Actions and how your Actions respond to users. You build your conversational model with [intents](../intents), [types](../types), [scenes](../scenes), and [prompts](../prompts).\n- **[Webhooks](../webhooks)** - Actions can trigger webhooks to delegate additional logic to your fulfillment services, like generating prompts, validating data, and more.\n- **[Interactive Canvas](/assistant/interactivecanvas)** - Instead of sending simple text responses or rich cards and images, you can deliver a full-screen, interactive web app powered by HTML, CSS, and JavaScript.\n\nThe following sections describe the tools that you'll use to build Actions.\n\n### Actions\n\nThe Actions API is a set of developer tools for building Actions for the\nGoogle Assistant. It consists of the following features:\n\n- **An open, file-based representation of an Actions project** - Build your\n invocation and conversation models with\n [intents](/assistant/conversational/intents),\n [types](/assistant/conversational/types),\n [scenes](/assistant/conversational/scenes), and\n [prompts](/assistant/conversational/prompts). You can edit your Actions\n projects with your favorite text editor, check them into source control, build\n automated processes, and more.\n\n- **A command-line interface (CLI)** - The\n [`gactions` tool](/assistant/actionssdk/gactions) provides a CLI to bootstrap and\n automate development of your Actions. It lets you initialize standard Action\n project files, push updates to the Actions console, deploy Action projects,\n and more. The tool lets you perform many common workflows, such as importing\n existing projects or starting work on a feature branch using your favorite\n source control system.\n\n- **The Actions API** - The Actions API is the same API used by\n the `gactions` tool. The Actions API provides a list of REST endpoints to\n manage your Actions, including for testing and building. The API lets you use\n JSON requests to perform many common workflows. When\n [using the Actions API](/assistant/actions/api) there are\n certain limits and best practices that you should consider.\n\n- **Webhooks and a Node.js fulfillment library** - Your Actions can delegate\n business logic to your web services with webhooks and a JSON based messaging\n format. We provide a Node.js fulfillment library that provides idiomatic interfaces for the\n [Conversation Webhook](/assistant/conversational/webhooks). This library makes it\n easy to implement many common user flows. For example, some features include\n extracting parameters from a user query and generating a multimodal experience\n (voice only and voice and visuals) for Google Assistant.\n\n### Actions Builder\n\nActions Builder gives you a powerful and easy-to-use, web-based IDE that's\nintegrated into the Actions console. Since Actions Builder is built on the\nsame technologies as the Actions API, you can use it on its own or together with\nthe Actions API depending on your needs. \n\nThe Actions Builder UI is split into the following areas:\n\n1. The top menu provides access to the different areas of the Actions console, and you can access Actions Builder on the **Develop** tab.\n2. The left menu lets you access all the components to build Actions, like intents and scenes.\n3. The build area lets you build the component you're working on.\n4. The details area lets you configure more details about the component you're working on."]]
