O Google monitora as ações implantadas para verificar se elas estão disponíveis e respondendo às solicitações dos usuários.
O endpoint de cada ação é necessário para responder a uma invocação de parâmetro padrão. Isso é compatível com o cenário em que o usuário pede para falar com uma ação sem fornecer outras informações (por exemplo, "Quero falar com nome da invocação").
Perguntas frequentes
Preciso implementar algo específico para apoiar as verificações de integridade?
Não. As verificações de integridade da ação funcionam como uma solicitação padrão para se comunicar com uma ação.
Com que frequência a integridade da Ação é verificada?
Sua Ação poderá ser monitorada ao longo do dia.
Como posso detectar que uma solicitação é uma verificação de integridade?
Se estiver usando o Actions Builder como plataforma de desenvolvimento, você 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, você deve responder 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 resposta formatada corretamente:
{"prompt":{"override":true,"firstSimple":{"speech":"ok","text":""}}}
Se você estiver usando o Dialogflow como plataforma de desenvolvimento, o Google adicionará um argumento "is_health_check" e o transmitirá para a 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 vai acontecer se o Google detectar uma ação não íntegra? Se o Google detectar que a ação está passando por uma interrupção temporária, ela será suspensa. Os usuários que solicitarem a ação não íntegra ouvirão "ACTION_NAME não está disponível".
Como vou saber 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 para o desenvolvedor principal associado ao projeto.
O que vai acontecer se uma ação que usa a vinculação de contas for marcada como não íntegra? Ao contrário de outras ações, aquelas que usam vinculação de conta 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 o recebimento do 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 da minha Ação? Você pode verificar o Play Console e ver o status da sua Ação. As ações não íntegras terão o status Não íntegro. As ações íntegras serão marcadas como Deployed.
Qual é o processo para retornar uma ação ao estado implantado? Revise a implantação e resolva quaisquer problemas que possam estar fazendo com que a ação não responda a uma intent de inicialização.
O Google continuará monitorando a integridade da Ação periodicamente enquanto ela não está íntegra. Quando o Google detecta que a ação está respondendo conforme o esperado, ela retorna ao estado implantado.