O Google monitora as ações implantadas para verificar se elas estão disponíveis e respondendo às solicitações do usuário.
O endpoint de cada ação é necessário para responder a uma invocação de parâmetro padrão. Isso oferece suporte ao cenário em que o usuário pede para falar com uma ação sem fornecer informações adicionais (por exemplo, "Quero falar com nome da invocação").
Dúvidas comuns
Preciso implementar algo específico para dar suporte às verificações de integridade?
Não. As verificações de integridade de ação funcionam como uma solicitação padrão para se comunicar com uma ação.
Com que frequência a integridade do meu Action é verificada?
Sua ação pode ser monitorada durante o dia inteiro.
Como posso detectar que uma solicitação é uma verificação de integridade?
Se você estiver usando o Actions Builder como sua plataforma de desenvolvimento, receberá uma solicitação de verificação de integridade semelhante ao snippet abaixo:
{
"handler": {
"name": "actions.handler.HEALTH_CHECK"
},
"intent": {
"name": "actions.intent.HEALTH_CHECK"
},
"session": {
"id": "actions.session.HEALTH_CHECK"
},
"user": {
"locale":"en-US"
},
"device": {
"capabilities": []
}
}
Ao receber essa solicitação, responda com um código de resposta 200. Caso contrário, sua ação será considerada não íntegra. O snippet a seguir é um exemplo de uma resposta formatada corretamente:
{"prompt":{"override":true,"firstSimple":{"speech":"ok","text":""}}}
Se você estiver usando o Dialogflow como sua plataforma de desenvolvimento, o Google adicionará um argumento "is_health_check" e o transmitirá para o intent. Esse argumento é encontrado no objeto Input da solicitação do webhook:
{
...
"originalDetectIntentRequest": {
...
"payload": {
...
"inputs": [{
...
"arguments": [{
"name": "is_health_check",
"boolValue": true,
"textValue": "1"
}]
}],
...
}
}
}
O que acontece quando o Google detecta uma ação não íntegra? Se o Google detectar que a ação está passando por uma interrupção, ela será suspensa. Os usuários que solicitarem a ação não íntegra ouvirão "ACTION_NAME não está disponível".
Como serei notificado se uma ação for marcada como não íntegra? Quando o Google detecta uma ação não íntegra, enviamos um e-mail de notificação ao desenvolvedor principal associado ao projeto do Actions.
O que acontecerá se minha ação que usa a vinculação de contas for marcada como não íntegra? Ao contrário de outras ações, as que usam vinculação de contas não são suspensas depois que o Google as declara não íntegras. Os usuários ainda poderão acessar sua ação por sete dias após receber o e-mail de notificação. No entanto, se você não corrigir o problema de vinculação da conta após sete dias, sua ação será removida.
Como posso verificar o status de integridade do meu Action? É possível verificar o console do desenvolvedor e ver o status da ação. O status "Não íntegro" terá o status Não íntegro. Ações íntegras serão marcadas como Implantado.
Qual é o processo para retornar uma ação ao estado implantado? Revise a implantação e resolva todos os problemas que possam estar causando a falha da ação ao responder a uma intent de inicialização.
O Google vai continuar monitorando periodicamente a integridade da ação enquanto ela não estiver íntegra. Quando o Google detecta que a ação está respondendo conforme o esperado, ela retorna ao estado implantado.