Présentation du SDK Actions (Dialogflow)

Actions on Google vous permet d'étendre les fonctionnalités de l'Assistant Google avec Actions. Les actions permettent aux utilisateurs d'effectuer des tâches via une interface de conversation pouvant aller d'une commande rapide pour allumer certaines lumières ou d'une conversation plus longue, comme jouer à un jeu de culture générale.

Le SDK Actions est une méthode permettant de développer le traitement des conversations sans utiliser Dialogflow. Lorsque vous utilisez le SDK Actions, vous utilisez un package d'action pour mapper les intents avec leur traitement. Vous devez également fournir des formats de requête dans le package d'action afin de définir des exemples de phrases que vos utilisateurs pourraient énoncer.

Attention :Pour utiliser le SDK Actions, vous devez créer ou fournir votre propre solution NLU. Bien que Dialogflow et le SDK Actions soient tous deux traités dans la documentation sur les actions personnalisées, nous vous recommandons fortement d'utiliser Dialogflow. L'expérience de développement change considérablement pour les actions conversationnelles, en fonction de ce que vous utilisez pour le traitement des conversations.

CLI gactions

Lorsque vous développez avec le SDK Actions, vous utilisez l'interface de ligne de commande (CLI) gactions pour tester et mettre à jour votre projet Actions. La CLI gactions vous aide également à créer et à gérer le package d'action pour votre action conversationnelle.

Créer des actions dans votre package d'action

Pour créer des actions dans votre package d'action, vous devez mapper les intents au fulfillment. Une action définit un point d'entrée pour démarrer des conversations avec un identifiant unique appelé intent. Les intents sont mappés aux traitements, qui traitent l'intent.

Par exemple, supposons que vous souhaitiez créer un projet contenant des actions permettant d'acheter des produits, de vérifier l'état des commandes et de présenter des offres quotidiennes. Vous pouvez définir des intents déclenchés comme suit:

• "Hey Google, parle à ExempleAction."
• "Hey Google, parle à ExempleAction pour acheter des chaussures."
• "Hey Google, parle à ExempleAction pour vérifier ma commande."
• "Hey Google, parle à ExempleAction pour me montrer les offres du jour."

Le fichier JSON du package d'action peut se présenter comme suit:

{
  "actions": [
    {
      "name": "MAIN",
      "intent": {
        "name": "actions.intent.MAIN"
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "BUY",
      "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"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "ORDER_STATUS",
      "intent": {
        "name": "com.example.ExampleAction.ORDER_STATUS",
        "trigger": {
          "queryPatterns": [
            "check on my order",
            "see order updates",
            "check where my order is"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "DAILY_DEALS",
      "intent": {
        "name": "com.example.ExampleAction.DAILY_DEALS",
        "trigger": {
          "queryPatterns": [
            "hear about daily deals",
            "buying some daily deals",
            "get today's deals"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    }
  ],
  "conversations": {
    "ExampleAction": {
      "name": "ExampleAction",
      "url": "https://www.example.com/ExampleAction"
    }
  }
}

Créer et déployer un webhook de fulfillment

Lorsqu'une action dans votre projet est appelée, Actions on Google appelle votre traitement pour lancer une conversation avec les utilisateurs afin d'exécuter l'action.

Dans chaque requête envoyée au webhook de traitement, vous recevez l'entrée utilisateur sous forme de chaîne de texte. Pour traiter l'intent, vous devez généralement analyser l'entrée de texte et renvoyer une réponse. Cet échange a lieu jusqu'à la fin de la conversation de votre action.

Importer votre package d'action

Une fois que vous avez créé votre package d'action et déployé son traitement, vous pouvez l'importer dans la console Actions. La console Actions utilise des projets d'action pour regrouper votre action conversationnelle avec des métadonnées telles que l'état de son examen et le nom à afficher dans le répertoire de l'Assistant. Le projet vous permet également de définir des métadonnées pour votre action, et de gérer et suivre votre action via le processus d'approbation.

Une fois que vous avez un projet, vous pouvez importer le package d'action qui définit toutes vos actions à l'aide de la CLI gactions.

Envoyer votre projet pour approbation et le proposer aux utilisateurs

Exemples

Pour explorer les projets terminés, consultez les exemples de SDK Java et Node.js.