Verificações de integridade

O Google monitora as ações implantadas para verificar se estão disponíveis e respondendo a solicitações de usuários.

O endpoint de cada ação precisa responder a um padrão, sem parâmetro invocação. Isso se baseia no cenário em que o usuário pede para falar com uma ação sem fornecer nenhuma informação adicional (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 vão funcionar 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 estiver usando o Actions Builder como sua 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, ela será considerada não íntegra. O snippet a seguir é um exemplo de resposta formatada corretamente:

  {"prompt":{"override":true,"firstSimple":{"speech":"ok","text":""}}}

Se você usa o Dialogflow como plataforma de desenvolvimento, o Google adiciona uma "is_health_check" e o transmite para a intent. Esse argumento é encontrado na tabela Entrada da solicitação do webhook:

{
  ...
  "originalDetectIntentRequest": {
    ...
    "payload": {
      ...
      "inputs": [{
        ...
        "arguments": [{
          "name": "is_health_check",
          "boolValue": true,
          "textValue": "1"
        }]
      }],
      ...
    }
  }
}
  

O que acontece se o Google detectar 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 é indisponí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 para o desenvolvedor principal associado ao projeto do Actions.

O que vai 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, aquelas que usam a vinculação de contas não são suspensas após O Google as declara não íntegras. Os usuários ainda podem acessar sua Ação por 7 dias depois de receber o e-mail de notificação. No entanto, se você não corrigiu o após sete dias, sua Ação vai ser removida.

Como posso verificar o status de integridade da minha Ação? Verifique seu console para desenvolvedores e confira o status da sua ação. Insalubre As ações terão o status Não íntegro. As ações íntegras serão marcadas como Implantado.

Qual é o processo para retornar uma ação ao estado implantado? Analise sua implantação e resolva quaisquer problemas que possam estar causando a ação falhar ao responder a uma intent de inicialização.

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