Google surveille les actions déployées pour s'assurer qu'elles sont disponibles et pour répondre aux requêtes des utilisateurs.
Le point de terminaison de chaque action est nécessaire pour répondre à un appel de paramètre par défaut. Cela permet de tenir le cas où l'utilisateur demande à parler à une action sans fournir d'informations supplémentaires (par exemple, "Je veux parler à nom de l'appel").
Questions fréquentes
Dois-je implémenter des éléments spécifiques pour étayer les vérifications d'état ?
Non. Les vérifications de l'état des actions fonctionnent comme une requête standard permettant de communiquer avec une action.
À quelle fréquence l'état de mon action est-il vérifié ?
Votre action peut être surveillée tout au long de la journée.
Comment détecter qu'une requête est une vérification d'état ?
Si vous utilisez Actions Builder comme plate-forme de développement, vous recevrez une requête de vérification d'état semblable à l'extrait ci-dessous:
{ "handler": { "name": "actions.handler.HEALTH_CHECK" }, "intent": { "name": "actions.intent.HEALTH_CHECK" }, "session": { "id": "actions.session.HEALTH_CHECK" }, "user": { "locale":"en-US" }, "device": { "capabilities": [] } }
Lorsque vous recevez cette requête, vous devez répondre avec un code de réponse 200. Sinon, votre action est considérée comme non opérationnelle. L'extrait de code suivant est un exemple de réponse correctement formatée:
{"prompt":{"override":true,"firstSimple":{"speech":"ok","text":""}}}
Si vous utilisez Dialogflow comme plate-forme de développement, Google ajoute un argument "is_health_check"
et le transmet à l'intent. Cet argument se trouve dans l'objet Entrée de la requête webhook:
{ ... "originalDetectIntentRequest": { ... "payload": { ... "inputs": [{ ... "arguments": [{ "name": "is_health_check", "boolValue": true, "textValue": "1" }] }], ... } } }
Que se passe-t-il si Google détecte une action non opérationnelle ? Si Google détecte une interruption de service, il est suspendu. Les utilisateurs qui demandent une action non opérationnelle entendront le message "ACTION_NAME n'est pas disponible".
Comment serai-je informé si une action est marquée comme non opérationnelle ? Lorsque Google détecte une action non opérationnelle, nous envoyons un e-mail de notification au développeur principal associé au projet Actions.
Que se passe-t-il si mon action utilisant l'association de comptes est marquée comme non opérationnelle ? Contrairement aux autres actions, les actions qui utilisent une association de compte ne sont pas suspendues après que Google les a déclarées non opérationnelles. Les utilisateurs peuvent toujours accéder à votre action pendant sept jours après la réception de l'e-mail de notification. Cependant, si vous n'avez pas résolu le problème d'association de compte au bout de sept jours, votre action sera supprimée.
Comment consulter l'état de mon action ? Vous pouvez consulter la Play Console et connaître l'état de votre action. Les actions non opérationnelles sont associées à l'état Non opérationnel. Les actions saines sont marquées comme déployées.
Quel est le processus pour faire revenir une action à l'état déployé ? Vous devez examiner votre déploiement et résoudre les problèmes qui peuvent empêcher l'action de répondre à un intent de lancement.
Google continuera de surveiller régulièrement l'état de l'action, tant qu'elle n'est pas opérationnelle. Lorsque Google détecte que l'action répond comme prévu, elle revient à l'état déployé.