تعریف کردن «کنش‌ها» (Dialogflow)

«کنش‌ها» نقاط ورودی به برنامه شما هستند که مدل فراخوانی و کاوش را برای برنامه‌تان تعریف می‌کنند. «کنش‌ها» را در فایل JSON که به‌عنوان بسته کنش شناخته می‌شود اعلام می‌کنید، که بعداً وقتی می‌خواهید پروژه «کنش‌ها» را برای تأیید آزمایش یا ارسال کنید، آن را در پروژه توسعه‌دهنده خود بارگذاری می‌کنید. بسته «کنش» فایل JSON است که «کنش‌ها» را در پروژه «کنش‌ها» تعریف می‌کند.

برای تعریف «کنش‌ها» در بسته «کنش»، قصدی ایجاد می‌کنید که نحوه فراخوانی «کنش» و نقطه پایانی اجرای متناظر را برای زمانی که قصد راه‌اندازی می‌شود تعریف می‌کند. می‌توانید انواع «کنش‌های» زیر را ایجاد کنید:

  • کنش پیش‌فرض: هر پروژه Actions باید قصد خوشامدگویی داشته باشد که به‌عنوان نقطه ورودی برای کاربران برای شروع مکالمه عمل کند. قصد خوشامدگویی زمانی راه‌اندازی می‌شود که کاربران به‌طور صریح با گفتن نام «کنش» آن را فراخوانی کنند (برای مثال، «Ok Google، با ExampleAction صحبت کن»). این قصد خوشامدگویی با نام قصد actions.intent.MAIN شناسایی می‌شود.
  • «کنش‌های» اضافی برای پیوند عمیق: می‌توانید «کنش‌های» اضافی در بسته «کنش» خود با هدف‌هایی که خودتان تعریف می‌کنید ایجاد کنید. این کار به کاربران اجازه می‌دهد با گفتن نام «کنش» به‌همراه هدف، عملکرد خاصی را فراخوانی کنند (برای مثال: «Ok Google، با ExampleAction صحبت کن تا چند کفش پیدا کند»).

برای اطلاعات بیشتر درباره نحوه عملکرد این مدل‌های فراخوانی، هدف‌ها و فراخوانی را ببینید.

تعریف کردن «کنش» پیش‌فرض

هر بسته «کنش» باید فقط و فقط یک قصد داشته باشد که قصد actions.intent.MAIN را مدیریت کند. این هدف زمانی راه‌اندازی می‌شود که کاربران «کنش» شما را با نام فراخوانی کنند (برای مثال، «Ok Google، با ExampleAction صحبت کن»).

برای تولید فایل بسته «کنش» تکراری با نام action.json، مراحل زیر را دنبال کنید:

  1. gactions CLI را بارگیری کنید.
  2. فهرست راهنمای محلی برای فایل‌های منبع پروژه «کنش» خود ایجاد کنید.
  3. فرمان‌های زیر را در پایانه اجرا کنید:

    $ cd PROJECT_DIRECTORY
    $ gactions init

وقتی فایل بسته Action تولید شد، محتوای جای‌بان را با مقادیر خودتان جایگزین کنید. در اینجا مثالی از action.json با تغییرات ExampleAction آورده شده است:

{
  "actions": [
    {
      "description": "Default welcome intent",
      "name": "MAIN",
      "fulfillment": {
        "conversationName": "ExampleAction"
      },
      "intent": {
        "name": "actions.intent.MAIN",
        "trigger": {
          "queryPatterns": [
            "talk to ExampleAction"
          ]
        }
      }
    }
  ],
  "conversations": {
    "ExampleAction": {
      "name": "ExampleAction",
      "url": "https://www.example.com/ExampleAction"
    }
  },
  "locale": "en"
}

تعریف کردن کنش‌های بیشتر

می‌توانید «کنش‌های» دیگری ارائه دهید که به‌عنوان نقطه ورود عمل می‌کنند. این کار به کاربران اجازه می‌دهد با مشخص کردن جزئیات بیشتر درباره کاری که می‌خواهند انجام دهند، ابهام قصدشان را برطرف کنند (برای مثال، «Ok Google, talk to ExampleAction to find me some shoes.»).

برای تعریف کردن «کنش‌های» بیشتر:

  1. در آرایه actions، برای هر نقطه ورودی یک «کنش» مشخص کنید.

    برای مثال، کد زیر «کنش» «خرید» دیگری را نشان می‌دهد که موارد زیر را تعریف می‌کند:
    • نام هدف com.example.ExampleAction.BUY
    • parameters برای تجزیه کردن از ورودی کاربر هنگام فعال شدن این هدف. این زمانی مفید است که به داده‌های خاصی از عبارت «کنش» نیاز دارید، وقتی کاربران «کنش» را فراخوانی می‌کنند.
    • queryPatterns که مشخص می‌کند کاربران برای راه‌اندازی قصد باید چه بگویند. الگوهای پُرسمان می‌توانند شامل انواع Schema.org باشند که پارامترها را برای تجزیه تعریف می‌کنند.
    {
      "description": "Direct access",
      "name": "BUY",
      "fulfillment": {
        "conversationName": "ExampleAction"
      },
      "intent": {
        "name": "com.example.ExampleAction.BUY",
        "parameters": [
          {
            "name": "color",
            "type": "org.schema.type.Color"
          }
        ],
        "trigger": {
          "queryPatterns": [
            "find some $org.schema.type.Color:color sneakers",
            "buy some blue suede shoes",
            "get running shoes"
          ]
        }
      }
    }
          
  2. با مشخص کردن conversationName که با موردی در شیء conversations مطابقت دارد، برآورده‌سازی این قصد را مشخص کنید.

    {
      "conversations": {
        "ExampleAction": {
          "name": "ExampleAction",
          "url": "https://www.example.com/ExampleAction"
        }
      }
    }
        

در اینجا نمونه‌ای از بسته کامل «کنش» آورده شده است:

{
  "actions": [
    {
      "description": "Default welcome intent",
      "name": "MAIN",
      "fulfillment": {
        "conversationName": "ExampleAction"
      },
      "intent": {
        "name": "actions.intent.MAIN",
        "trigger": {
          "queryPatterns": [
            "talk to ExampleAction"
          ]
        }
      }
    },
    {
      "description": "Direct access",
      "name": "BUY",
      "fulfillment": {
        "conversationName": "ExampleAction"
      },
      "intent": {
        "name": "com.example.ExampleAction.BUY",
        "parameters": [
          {
            "name": "color",
            "type": "org.schema.type.Color"
          }
        ],
        "trigger": {
          "queryPatterns": [
            "find some $org.schema.type.Color:color sneakers",
            "buy some blue suede shoes",
            "get running shoes"
          ]
        }
      }
    }
  ],
  "conversations": {
    "ExampleAction": {
      "name": "ExampleAction",
      "url": "https://www.example.com/ExampleAction"
    }
  },
  "locale": "en"
}