نمای کلی ساخت
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
برای ایجاد کنش های مکالمه، اجزای زیر را ایجاد و اجرا می کنید:
- پروژه اقدامات - محفظه منطقی برای همه کنش‌های مکالمه، سرویس‌های وب و برنامه‌های وب شما. همچنین تنظیمات پروژه و منابعی را تعریف می کند که نحوه استقرار پروژه خود را در Actions on Google توضیح می دهد.
- مدل Invocation - نحوه کشف و شروع عملیات درون پروژه توسط کاربران را مشخص می کند. شما مدل فراخوانی خود را با مقاصد و انواع می سازید.
- مدل مکالمه - تعریف می کند که کاربران می توانند به Actions شما بگویند و چگونه Actions شما به کاربران پاسخ می دهند. شما مدل مکالمه خود را با مقاصد ، انواع ، صحنه ها و درخواست ها می سازید.
- Webhooks - کنش‌ها می‌توانند وب‌قلاب‌ها را برای واگذاری منطق اضافی به خدمات تکمیلی شما، مانند ایجاد درخواست‌ها، اعتبارسنجی داده‌ها و موارد دیگر، فعال کنند.
- بوم تعاملی - به جای ارسال پاسخ های متنی ساده یا کارت ها و تصاویر غنی، می توانید یک برنامه وب تمام صفحه و تعاملی با HTML، CSS و جاوا اسکریپت ارائه دهید.
بخش‌های زیر ابزارهایی را که برای ساخت Actions استفاده می‌کنید توضیح می‌دهند.
اقدامات
Action API مجموعه ای از ابزارهای توسعه دهنده برای ساخت Actions برای دستیار Google است. از ویژگی های زیر تشکیل شده است:
یک نمایش باز و مبتنی بر فایل از یک پروژه Actions - مدل‌های فراخوانی و مکالمه خود را با هدف‌ها ، انواع ، صحنه‌ها و درخواست‌ها بسازید. می‌توانید پروژه‌های Actions خود را با ویرایشگر متن مورد علاقه خود ویرایش کنید، آنها را در کنترل منبع بررسی کنید، فرآیندهای خودکار بسازید، و موارد دیگر.
یک رابط خط فرمان (CLI) - ابزار gactions یک CLI برای راه‌اندازی و خودکارسازی توسعه اقدامات شما فراهم می‌کند. این به شما امکان می‌دهد فایل‌های پروژه Action استاندارد را مقداردهی اولیه کنید، به‌روزرسانی‌ها را به کنسول Actions فشار دهید، پروژه‌های Action را مستقر کنید و موارد دیگر. این ابزار به شما امکان می دهد بسیاری از گردش های کاری رایج را انجام دهید، مانند وارد کردن پروژه های موجود یا شروع کار بر روی شاخه ویژگی با استفاده از سیستم کنترل منبع مورد علاقه خود.
Action API - Action API همان API است که توسط ابزار gactions استفاده می شود. Action API فهرستی از نقاط پایانی REST را برای مدیریت کنش‌های شما، از جمله برای آزمایش و ساخت، ارائه می‌کند. API به شما امکان می دهد از درخواست های JSON برای انجام بسیاری از گردش های کاری رایج استفاده کنید. هنگام استفاده از Action API محدودیت ها و بهترین شیوه هایی وجود دارد که باید در نظر بگیرید.
Webhooks و یک کتابخانه تکمیل Node.js - Actions شما می‌تواند منطق تجاری را به سرویس‌های وب شما با webhooks و قالب پیام‌رسانی مبتنی بر JSON واگذار کند. ما یک کتابخانه تکمیل Node.js ارائه می‌کنیم که رابط‌های اصطلاحی را برای Conversation Webhook فراهم می‌کند. این کتابخانه پیاده سازی بسیاری از جریان های کاربری رایج را آسان می کند. به عنوان مثال، برخی از ویژگی‌ها شامل استخراج پارامترها از درخواست کاربر و ایجاد یک تجربه چندوجهی (فقط صدا و صوت و تصاویر) برای Google Assistant است.
Actions Builder
Actions Builder به شما یک IDE مبتنی بر وب قدرتمند و آسان برای استفاده می دهد که در کنسول Actions ادغام شده است. از آنجایی که Actions Builder بر اساس فناوری های مشابه API Action ساخته شده است، می توانید بسته به نیاز خود از آن به تنهایی یا همراه با API Action استفاده کنید.
رابط کاربری Actions Builder به بخش های زیر تقسیم می شود:
- منوی بالا دسترسی به قسمت های مختلف کنسول Actions را فراهم می کند و می توانید در تب Develop به Actions Builder دسترسی داشته باشید.
- منوی سمت چپ به شما امکان می دهد به تمام اجزای سازنده Actions مانند intent ها و صحنه ها دسترسی داشته باشید.
- ناحیه ساخت به شما امکان می دهد کامپوننتی را که روی آن کار می کنید بسازید.
- قسمت جزئیات به شما امکان می دهد جزئیات بیشتری را در مورد مؤلفه ای که روی آن کار می کنید پیکربندی کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-28 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-28 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
