Controlli di integrità

Google monitora le Azioni implementate per verificare che siano disponibili e per rispondere alle richieste dagli utenti.

L'endpoint di ogni azione è necessario per rispondere a un valore predefinito, nessun parametro invocazione. Ciò supporta lo scenario in cui l'utente chiede di parlare con un'azione senza fornire informazioni aggiuntive (ad esempio, "Voglio parlare con nome di chiamata").

Domande comuni

Devo implementare qualcosa di specifico per supportare i controlli di integrità?

No. I controlli di integrità delle azioni funzioneranno come una richiesta standard di comunicare con un'azione.

Con quale frequenza viene controllato lo stato della mia Azione?

L'Azione può essere monitorata nel corso della giornata.

Come faccio a rilevare che una richiesta è un controllo di integrità?

Se utilizzi Actions Builder come piattaforma di sviluppo, ricevi un richiesta di controllo di integrità simile allo snippet seguente:

{
  "handler": {
    "name": "actions.handler.HEALTH_CHECK"
  },
  "intent": {
    "name": "actions.intent.HEALTH_CHECK"
  },
  "session": {
    "id": "actions.session.HEALTH_CHECK"
  },
  "user": {
    "locale":"en-US"
  },
  "device": {
    "capabilities": []
  }
}
  

Quando ricevi questa richiesta, devi rispondere con un codice di risposta 200. in caso contrario, l'azione è considerata in stato non integro. Il seguente snippet è Ecco un esempio di risposta formattata correttamente:

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

Se utilizzi Dialogflow come piattaforma di sviluppo, Google aggiunge una "is_health_check" e lo passa all'intent. Questo argomento è presente nella sezione Input oggetto della richiesta webhook:

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

Che cosa succede se Google rileva un'azione non integro? Se Google rileva che l'azione sta subendo un'interruzione, l'azione viene sospeso. Gli utenti che richiedono l'azione non stabile sentiranno "ACTION_NAME è non disponibile".

Come faccio a ricevere una notifica se un'azione è contrassegnata come non integro? Quando Google rileva un'azione non stabile, invia un'email di notifica al sviluppatore principale associato al progetto Actions.

Che cosa succede se la mia Azione che utilizza il collegamento dell'account è contrassegnata come non stabile? A differenza delle altre Azioni, le Azioni che utilizzano il collegamento dell'account non vengono sospese dopo Google li dichiara non integri. Gli utenti possono continuare ad accedere all'azione per sette giorni dopo aver ricevuto l'email di notifica. Tuttavia, se non hai corretto il problema problema di collegamento dell'account dopo 7 giorni, l'azione verrà rimossa.

Come faccio a controllare lo stato di integrità della mia Azione? Puoi controllare la console per gli sviluppatori e controllare lo stato dell'azione. Insalubre Lo stato delle azioni sarà Non integro. Le azioni corrette verranno contrassegnate come Deployment eseguito.

Qual è la procedura per restituire un'azione allo stato di cui è stato eseguito il deployment? Devi esaminare il deployment e risolvere gli eventuali problemi che potrebbero causare l'Azione non risponda a un intento di lancio.

Google continuerà a monitorare periodicamente lo stato dell'Azione durante la sua non è integro. Quando Google rileva che l'Azione risponde come previsto, la richiesta L'azione tornerà allo stato implementato.