Verificações de integridade

O Google monitora as ações implantadas para verificar se 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 é compatível com o 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 da ação funcionam como uma solicitação padrão para se comunicar com uma ação.

Com que frequência a integridade da minha ação é verificada?

Sua ação pode ser monitorada ao longo do dia.

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 plataforma de desenvolvimento, o Google adicionará um argumento "is_health_check" e o transmitirá para a intent. Esse argumento é encontrado no objeto Entrada 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 solicitam a ação não íntegra ouvirão "ACTION_NAME não está disponível".

Como vou receber uma notificação 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 do Actions.

O que vai acontecer se minha ação que usa 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 podem acessar a ação por sete dias depois de 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, a ação será removida.

Como posso verificar o status de integridade da minha ação? Confira seu Play Console e o status da ação. As ações não íntegras terão o status Não íntegra. Ações íntegras serão marcadas como Implantada.

Qual é o processo para retornar uma ação ao estado implantado? Analise a implantação e resolva todos os problemas que podem causar falhas na resposta da ação a uma intent de inicialização.

O Google vai continuar monitorando a integridade da ação periodicamente enquanto ela não estiver íntegra. Quando o Google detecta que a ação está respondendo conforme o esperado, a ação retorna ao estado implantado.