Google supervisa las acciones implementadas para verificar que estén disponibles y responder a las solicitudes de los usuarios.
El extremo de cada acción debe responder a una invocación predeterminada sin parámetros. Esto admite la situación en la que el usuario solicita hablar con una acción sin proporcionar información adicional (por ejemplo, "Quiero hablar con nombre de invocación").
Preguntas habituales
¿Debo implementar algo específico para admitir las verificaciones de estado?
No. Las verificaciones de estado de acciones funcionarán como una solicitud estándar para hablar con una acción.
¿Con qué frecuencia se verifica el estado de mi acción?
Es posible que tu Acción se supervise durante el día.
¿Cómo puedo detectar si una solicitud es una verificación de estado?
Si usas Actions Builder como plataforma de desarrollo, recibirás una solicitud de verificación de estado similar al fragmento que se muestra a continuación:
{
"handler": {
"name": "actions.handler.HEALTH_CHECK"
},
"intent": {
"name": "actions.intent.HEALTH_CHECK"
},
"session": {
"id": "actions.session.HEALTH_CHECK"
},
"user": {
"locale":"en-US"
},
"device": {
"capabilities": []
}
}
Cuando recibes esta solicitud, debes responder con un código de respuesta 200; de lo contrario, tu acción se considerará en mal estado. El siguiente fragmento es un ejemplo de una respuesta con el formato correcto:
{"prompt":{"override":true,"firstSimple":{"speech":"ok","text":""}}}
Si usas Dialogflow como plataforma de desarrollo, Google agrega un argumento "is_health_check" y lo pasa al intent. Este argumento se encuentra en el objeto Input de la solicitud de webhook:
{
...
"originalDetectIntentRequest": {
...
"payload": {
...
"inputs": [{
...
"arguments": [{
"name": "is_health_check",
"boolValue": true,
"textValue": "1"
}]
}],
...
}
}
}
¿Qué sucede si Google detecta una Acción en mal estado? Si Google detecta que la acción experimenta una interrupción, esta se suspende. Los usuarios que soliciten esta acción escucharán que "ACTION_NAME no está disponible".
¿Cómo se me notificará si una acción está marcada como en mal estado? Cuando Google detecta una acción en mal estado, enviamos una notificación por correo electrónico al desarrollador principal asociado con el proyecto de acciones.
¿Qué sucede si mi acción que usa la vinculación de cuentas está marcada como en mal estado? A diferencia de otras acciones, las que usan la vinculación de cuentas no se suspenden después de que Google las declara en mal estado. Los usuarios pueden acceder a tu acción durante 7 días después de que recibas la notificación por correo electrónico. Sin embargo, si no solucionas el problema relacionado con la vinculación de cuentas después de 7 días, esta se eliminará.
¿Cómo puedo consultar el estado de mi acción? Puedes consultar tu consola para desarrolladores y ver el estado de tu acción. Las acciones en mal estado tendrán el estado Unhealthy. Las acciones en buen estado se marcarán como Implementadas.
¿Cómo es el proceso para devolver una acción al estado implementado? Debes revisar la implementación y abordar cualquier problema que pueda hacer que la acción no responda a un intent de inicio.
Google continuará supervisando periódicamente el estado de la acción mientras esté en mal estado. Cuando Google detecta que la acción responde como se espera, la acción volverá al estado implementado.