Derlemeye genel bakış
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Etkileşimli işlemler oluşturmak için aşağıdaki bileşenleri oluşturup dağıtırsınız:
- İşlemler projesi: Tüm etkileşimli işlemleriniz, web hizmetleriniz ve web uygulamalarınız için mantıksal kapsayıcı. Ayrıca projenizi Google'da İşlemler'e nasıl dağıtacağınızı açıklayan proje ayarlarını ve kaynaklarını da tanımlar.
- Çağırma modeli: Kullanıcıların projenizdeki işlemleri nasıl keşfedip başlatacağını tanımlar. Çağırma modelinizi amaçlar ve türlerle oluşturursunuz.
- Konuşma modeli: Kullanıcıların İşlemlerinize ne söyleyebileceğini ve İşlemlerinizin kullanıcılara nasıl yanıt vereceğini tanımlar. Sohbet modelinizi amaçlar, türler, sahneler ve istemlerle oluşturursunuz.
- Webhook'lar: İşlemler, ek mantığı (ör. istem oluşturma, verileri doğrulama) karşılama hizmetlerinize devretmek için webhook'ları tetikleyebilir.
- Interactive Canvas: Basit metin yanıtları veya zengin kartlar ve resimler göndermek yerine HTML, CSS ve JavaScript ile desteklenen tam ekran, etkileşimli bir web uygulaması sunabilirsiniz.
Aşağıdaki bölümlerde, İşlemler oluşturmak için kullanacağınız araçlar açıklanmaktadır.
İşlemler
Actions API, Google Asistan için İşlemler oluşturmaya yönelik bir geliştirici araçları grubudur. Aşağıdaki özelliklerden oluşur:
Actions Console projesinin açık, dosya tabanlı temsili: Niyetler, türler, sahneler ve istemler ile çağırma ve görüşme modellerinizi oluşturun. İşlemler projelerinizi favori metin düzenleyicinizle düzenleyebilir, kaynak kontrolüne ekleyebilir, otomatik süreçler oluşturabilir ve daha fazlasını yapabilirsiniz.
Komut satırı arayüzü (CLI): gactions aracı, İşlemlerinizin geliştirilmesini başlatmak ve otomatikleştirmek için bir CLI sağlar. Bu araçla standart Action proje dosyalarını başlatabilir, güncellemeleri Actions Console'a gönderebilir, Action projelerini dağıtabilir ve daha birçok işlem yapabilirsiniz. Bu araç, mevcut projeleri içe aktarma veya en sevdiğiniz kaynak kontrol sistemini kullanarak bir özellik dalında çalışmaya başlama gibi birçok yaygın iş akışını gerçekleştirmenize olanak tanır.
Actions API: Actions API, gactions aracı tarafından kullanılan API ile aynıdır. Actions API, test etme ve oluşturma da dahil olmak üzere İşlemlerinizi yönetmek için bir REST uç noktaları listesi sağlar. API, birçok yaygın iş akışını gerçekleştirmek için JSON isteklerini kullanmanıza olanak tanır. İşlemler API'sini kullanırken dikkate almanız gereken belirli sınırlar ve en iyi uygulamalar vardır.
Webhook'lar ve Node.js karşılama kitaplığı: İşlemleriniz, webhook'lar ve JSON tabanlı mesajlaşma biçimiyle iş mantığını web hizmetlerinize devredebilir. Conversation Webhook için deyimsel arayüzler sağlayan bir Node.js istek karşılama kitaplığı sunuyoruz. Bu kitaplık, birçok yaygın kullanıcı akışının uygulanmasını kolaylaştırır. Örneğin, bazı özellikler arasında kullanıcı sorgusundan parametreleri çıkarma ve Google Asistan için çok formatlı bir deneyim (yalnızca ses ve ses ile görseller) oluşturma yer alır.
İşlem Oluşturucu
Actions Builder, Actions Console'a entegre edilmiş, web tabanlı, güçlü ve kullanımı kolay bir IDE sunar. Actions Builder, Actions API ile aynı teknolojiler üzerine kurulduğundan ihtiyaçlarınıza bağlı olarak tek başına veya Actions API ile birlikte kullanabilirsiniz.
Actions Builder kullanıcı arayüzü aşağıdaki alanlara ayrılmıştır:
- Üst menü, Actions konsolunun farklı alanlarına erişim sağlar. Actions Builder'a Geliştir sekmesinden erişebilirsiniz.
- Soldaki menü, niyetler ve sahneler gibi işlemleri oluşturmak için gereken tüm bileşenlere erişmenizi sağlar.
- Derleme alanı, üzerinde çalıştığınız bileşeni oluşturmanıza olanak tanır.
- Ayrıntılar alanı, üzerinde çalıştığınız bileşenle ilgili daha fazla ayrıntı yapılandırmanıza olanak tanır.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-24 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-24 UTC."],[[["\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."]]
