Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Dialogflow'da Actions'ı tanımlamak için Dialogflow aracınızda niyet oluşturur ve bunları İşleminize giriş noktaları olarak atarsınız. Aşağıdaki Eylem türlerini oluşturabilirsiniz:
Varsayılan İşlem: Her Dialogflow aracısı, kullanıcılar İşleminizi adıyla istediğinde (ör. "Ok Google Doğru bilgiler ile Google" veya "Ok Google. Google Hakkında Bilgiler ile
konuşayım").
Görüşmenize derin bağlantı oluşturmak için ek amaçlar: Bu işlemler, kullanıcılar İşleminizi adıyla çağırdığında ve bir çağrı ifadesi belirttiğinde (örneğin, "Geçmişle ilgili bilgiler için Google hakkındaki bilgiler ile görüşme") tetiklenir.
Bu çağrı modellerinin işleyiş şekli hakkında daha fazla bilgi edinmek için Amaçlar ve çağrı bölümüne bakın.
Varsayılan İşlem tanımlama
Her Dialogflow aracısının GOOGLE_ASSISTANT_WELCOME etkinliğini işleyen tek bir amacı olmalıdır. Bu amaç, kullanıcılar İşleminizi adıyla çağırdığında (örneğin, "Ok Google, Google hakkındaki bilgiler ile konuş") tetiklenir.
GOOGLE_ASSISTANT_WELCOME etkinliğini aşağıdaki şekillerde tanımlayabilirsiniz:
Dialogflow konsolundaki intent düzenleyiciden:
Gezinme menüsünde Niyetler'i tıklayın.
Karşılama etkinliği olarak ayarlamak istediğiniz amacı seçin.
Niyetin Etkinlikler bölümünü görüntülediğinizde, amacın artık GOOGLE_ASSISTANT_WELCOME etkinliğinin ayarlandığını görmeniz gerekir (Şekil 1'e bakın).
Sipariş karşılamayı etkinleştir
Varsayılan olarak Dialogflow niyeti, amacın Yanıt bölümünde belirtilen statik bir yanıt döndürür. Bu ayar, çağrıldığında yalnızca aynı mesajla yanıt vermesi gereken basit İşlemler için yeterli olabilir. Bununla birlikte, niyetin dinamik yanıt döndürmesini istiyorsanız karmaşık mantığı işleyebilen ve amaç için gerçek zamanlı bir yanıt oluşturabilen istek karşılama sağlamanız gerekir.
Bir amaç için istek karşılamayı etkinleştirmek üzere aşağıdakileri yapın:
Bir amacın intent düzenleyicisinin alt kısmına gidin.
Karşılama'yı tıklayın ve Bu niyet için webhook çağrısını etkinleştir'i seçin.
Bu niyetin tetiklendiğinde nasıl ele alınacağı hakkında bilgi için Karşılama derleme bölümüne bakın.
Ek İşlemler tanımlayın
Görüşmenize giriş noktası görevi gören ek İşlemler sağlayabilirsiniz. Bu kurulum, kullanıcıların ne yapmak istedikleriyle ilgili daha fazla ayrıntı belirtmelerine olanak tanır (örneğin, "Geçmişteki bilgileri bulmak için Google hakkındaki bilgiler ile konuşun").
Dialogflow'da ek İşlemler tanımlamak için şu adımları uygulayın:
Oluşturmak istediğiniz belirli bir işlem için amaç oluşturun.
Niyetin Eğitim ifadeleri bölümünde bu İşlemi tetikleyen kalıpları belirtin. Örneğin, İşlem'in "Geçmişle ilgili bilgileri bulmak için Google hakkındaki gerçeklerle ilgili bilgiler ile konuşun" ifadesiyle çalıştırılmasını istiyorsanız aşağıdaki Eğitim ifadelerini sağlayın:
"Tarihle ilgili bilgileri bul"
"Geçmişle ilgili gerçekleri araştır"
"Şirketin tarihçesi hakkında bilgi ver"
"Genel merkezle ilgili bilgileri oku"
"Genel merkez hakkında biraz bilgi ver"
Niyet başına en az 10 eğitim ifadesi öneririz.
Niyetin karşılanmasını etkinleştirmek için ekranın alt kısmına gidin, Karşılama'yı tıklayın ve Bu niyet için webhook çağrısını etkinleştir'i seçin.
(İstek karşılama hakkında daha fazla bilgi için Sipariş karşılama bölümüne bakın.)
Kaydet'i tıklayın.
Gezinme menüsünde Entegrasyonlar'ı ve Google Asistan'ı tıklayın.
(Google Asistan kalıcı penceresi görünür.)
İşlemler tanımlanırken aşağıdaki kısıtlamalar ve yönergeler geçerlidir:
Çağrı ifadelerine ayrılmış kelimeleri eklemeyin.
Örneğin, çağrı ifadelerinizin başına "talk to" (şunla konuş) veya "biz konuşayım" ile başlamayın.
Yalnızca @sys.any varlığı içeren eğitim ifadeleri belirtmeyin.
Çok daha spesifik bir açıklama girin (örneğin, find recipes for @sys.any).
Tanınmayan bir işlemi işleme
Kullanıcılar, İşlemlerinizin tanımadığı bir İşlemi çağırmaya çalıştığında,
Dialogflow bu durumları ele almak için bir niyet tetikleyebilir.
Bu davranışı etkinleştirmek için google_assistant_welcome giriş bağlamına sahip yeni bir intent oluşturun ve kullanıcılara uygun yanıtları belirtin:
Gezinme menüsünde Niyetler'i tıklayın.
Niyet Oluştur'u tıklayın ve amacınızı adlandırın.
Bağlamlar bölümünde, giriş bağlamı olarak google_assistant_welcome öğesini belirtin ve Enter tuşuna basın. (Giriş bağlamı girildikten sonra google_assistant_welcome, çıkış bağlamı olarak görünür).
Bu çıkış bağlamını kaldırmak için x simgesini tıklayın.
Eğitim ifadeleri bölümünde, kullanıcı ifadesi olarak banana (veya başka bir isim) ifadesini ekleyin.
Muz'u çift tıklayın ve @sys.any'yi seçin. (Dialogflow'u ifadeyi yalnızca muz değil, dil bilgisine genelleştirmesini söylemek için @sys.any varlığını kullanırız.)
Yanıt bölümünde $any kullanarak bir yanıt belirtin. Örneğin, aşağıdaki yanıtı kullanın:
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-07-26 UTC."],[[["\u003cp\u003eDialogflow Actions are entry points into your Google Action, defined by intents, with a mandatory default Action triggered when users invoke your Action by name.\u003c/p\u003e\n"],["\u003cp\u003eAdditional intents can be created to handle deep links, allowing users to specify invocation phrases for more detailed requests.\u003c/p\u003e\n"],["\u003cp\u003eFulfillment can be enabled for intents to provide dynamic responses based on complex logic and real-time processing.\u003c/p\u003e\n"],["\u003cp\u003eWhen unrecognized Actions are invoked, Dialogflow can trigger a specific intent to handle these scenarios, using input context and the \u003ccode\u003e@sys.any\u003c/code\u003e entity for generalization.\u003c/p\u003e\n"],["\u003cp\u003eIt is generally recommended to utilize fallback intents to reprompt users for invalid input instead of overriding Assistant's default no-match behavior.\u003c/p\u003e\n"]]],["Dialogflow Actions are defined by creating intents in a Dialogflow agent. A **Default Action**, triggered by the Action's name, is mandatory, utilizing the `GOOGLE_ASSISTANT_WELCOME` event. Additional Actions allow deeper linking with specific invocation phrases. To define these, create intents with relevant training phrases, enable webhook fulfillment for dynamic responses, and add them to the Google Assistant integration. Handling unrecognized actions involves creating an intent with `google_assistant_welcome` input context, using `@sys.any` for general expressions.\n"],null,["# Define Actions (Dialogflow)\n\nTo define Actions in Dialogflow, you create intents in your Dialogflow agent and\nassign them as entry points into your Action. You can create the following types\nof Actions:\n\n- **Default Action** : Every Dialogflow agent must have one and only one Action that's invoked when users ask for your Action by name (for example, *\"Ok\n Google. Talk to Facts about Google\"* or *\"Ok, Google. Let me talk to Facts\n about Google\"*).\n- **Additional intents to deep link into your conversation** : These Actions are triggered when users invoke your Action by its name **and** specify an invocation phrase (for example, *\"talk to Facts about Google for history\n facts\"*).\n\nSee [Intents and invocation](/assistant/df-asdk/discovery) for more information on how\nthese invocation models work.\n\nDefine a default Action\n-----------------------\n\n| **Dialogflow Tip**\n|\n| Because Dialogflow supports many products, there are\n| welcome event triggers for specific platforms, such as\n| **GOOGLE_ASSISTANT_WELCOME** for Actions. The generic\n| **WELCOME** event lets you handle invocations across many platforms if you\n| deploy the agent on multiple platforms.\n\nEvery Dialogflow agent must have one and only one intent that handles\nthe **GOOGLE_ASSISTANT_WELCOME** event. This intent is triggered\nwhen users invoke your Action by its name (for example, *\"Ok Google, talk to\nFacts about Google\"*).\n\nYou can define the **GOOGLE_ASSISTANT_WELCOME** event in\nthe following ways:\n\n**From the intent editor on the Dialogflow console:**\n\n1. Click **Intents** in the navigation menu.\n2. Select the intent that you want to set as the welcome event.\n3. In the **Events** section of the intent, enter `GOOGLE_ASSISTANT_WELCOME`.\n4. Click **Save**.\n\n **Figure 1**. A screenshot of the Events section of a Dialogflow intent.\n\n**From the Google Assistant integration modal window:**\n\n1. Click **Integrations** in the navigation menu and click **Google Assistant**.\n2. Click **X** to remove the current item in the **Explicit invocation** field.\n3. In the **Welcome intent** box, select the intent that you want to set as the\n welcome event.\n\n **Figure 2**. A screenshot of the Google Assistant integration modal window\n on the Dialogflow console.\n\nWhen you view the intent's **Events** section, you should see that the intent\nnow has the **GOOGLE_ASSISTANT_WELCOME** event set (see **Figure 1**).\n\n### Enable fulfillment\n\nBy default, a Dialogflow intent returns a static response, which is specified\nin **Response** section of the intent. This setting might be enough for simple\nActions that only need to respond with the same message when invoked. However,\nif you want the intent to return a dynamic response, you need to provide\nfulfillment that can process complex logic and compose a response in real time\nfor the intent.\n\nTo enable fulfillment for an intent, do the following:\n\n1. Scroll to the bottom of the intent editor of an intent.\n2. Click **Fulfillment** and select **Enable webhook call for this intent**.\n\n **Figure 3**. A screenshot of the Fulfillment section of a Dialogflow intent.\n\nSee [Build fulfillment](/assistant/df-asdk/dialogflow/fulfillment) for information on how to handle this\nintent when it's triggered.\n\nDefine additional Actions\n-------------------------\n\nYou can provide additional Actions that act as entry points into your\nconversation. This setup allows users to specify more details about what they\nwant to do (for example, *\"Talk to Facts about Google to find me history\nfacts\"*).\n\nTo define additional Actions in Dialogflow, follow these steps:\n\n1. Create an intent for a specific Action that you want to build.\n2. In the intent's **Training phrases** section, specify the patterns that\n trigger this Action. For example, if you want the Action to be invoked by the\n phrase *\"Talk to Facts about Google to find me history facts\"* , provide the\n following *Training phrases*:\n\n - *\"Find me history facts\"*\n - *\"Look up history facts\"*\n - *\"Get me facts about history of the company\"*\n - *\"Read me some headquarters facts\"*\n - *\"Tell me a few facts about its headquarters\"*\n\n We recommend at least 10 training phrases per intent.\n3. To enable fulfillment for the intent, scroll to the bottom of the screen,\n click **Fulfillment** , and select **Enable webhook call for this intent** .\n (See [Build fulfillment](/assistant/df-asdk/dialogflow/fulfillment) for more details on\n fulfillment.)\n\n4. Click **Save**.\n\n5. Click **Integrations** in the navigation menu and click **Google Assistant**.\n (the Google Assistant modal window appears.)\n\n6. In the **Implicit invocation** section, add the intent.\n\n **Figure 4**. A screenshot of the Implicit invocation section on the Google\n Assistant integration modal window.\n\nWhen defining Actions, the following restrictions and guidelines apply:\n\n- Don't include the *reserved words* in invocation phrases.\n - For example, don't start your invocation phrases with *\"talk to\"* or \"let me talk to\".\n- Don't specify training phrases that contain only a `@sys.any` entity.\n - Be much more specific; for example, `find recipes for @sys.any`.\n\nHandling an unrecognized Action\n-------------------------------\n\nWhen users attempt to invoke an Action that your Actions don't recognize,\nDialogflow can trigger an intent to handle these cases.\n| **Warning:** You should avoid globally overriding Assistant's [default no-match behavior](#no-match_yielding), as it may negatively impact the ability of users to move between Actions. Generally, your Action should *not* try to handle all no-match and no-input scenarios. We recommend using [fallback intents](/assistant/df-asdk/dialogflow/fulfillment#no-match_reprompting) to reprompt the user when your Action receives invalid input.\n\nTo enable this behavior,\ncreate a new intent with an input context of `google_assistant_welcome` and\nspecify the appropriate responses to users:\n\n1. In the navigation menu, click **Intents**.\n2. Click **Create Intent** and name your intent.\n3. In the **Contexts** section, Specify `google_assistant_welcome` as the input context and press enter key. (After entering the input context, `google_assistant_welcome` appears as an output context).\n4. Click **x** to remove that output context.\n\n5. In the **Training phrases** , add `banana` (or any other noun) as a user\n expression.\n\n6. Double-click on **banana** and select `@sys.any`. (We use the `@sys.any`\n entity to tell Dialogflow to generalize the expression to any grammar, not\n just *banana*.)\n\n7. In the **Response** section, specify a responses using `$any`. For example,\n use the following response:\n\n - `I'm sorry, I don't know how to help with $any.`\n\n8. Click **Save**.\n\n| **Note:** While you can use Dialogflow to return simple text responses as a fallback, you can turn on **Enable webhook call for this intent** and provide more advanced fulfillment in your webhook code."]]
