Systemdiagnosen

Google überwacht bereitgestellte Aktionen, um sicherzustellen, dass sie verfügbar sind und auf Nutzeranfragen reagieren.

Der Endpunkt jeder Aktion muss auf einen Standardwert und keinen Parameteraufruf reagieren. Dies unterstützt das Szenario, in dem der Nutzer darum bittet, mit einer Aktion zu sprechen, ohne zusätzliche Informationen anzugeben (z. B. „Ich möchte mit Aufrufname sprechen“).

Häufige Fragen

Muss ich etwas Bestimmtes implementieren, um die Systemdiagnosen zu unterstützen?

Nein. Systemdiagnosen für Aktionen funktionieren wie eine Standardanfrage, mit einer Aktion zu sprechen.

Wie oft wird der Status meiner Aktion geprüft?

Deine Aktion wird den ganzen Tag über überwacht.

Wie kann ich erkennen, dass eine Anfrage eine Systemdiagnose ist?

Wenn Sie Actions Builder als Entwicklungsplattform verwenden, erhalten Sie eine Systemdiagnoseanfrage ähnlich dem folgenden Snippet:

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

Wenn du diese Anfrage erhältst, solltest du mit dem Antwortcode 200 antworten. Andernfalls wird deine Aktion als fehlerhaft eingestuft. Das folgende Snippet ist ein Beispiel für eine richtig formatierte Antwort:

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

Wenn Sie Dialogflow als Entwicklungsplattform verwenden, fügt Google das Argument "is_health_check" hinzu und übergibt es an den Intent. Dieses Argument finden Sie im Objekt Input der Webhook-Anfrage:

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

Was passiert, wenn Google eine fehlerhafte Aktion erkennt? Wenn Google feststellt, dass die Aktion ausfällt, wird sie angehalten. Nutzer, die die fehlerhafte Aktion anfordern, hören Folgendes: "ACTION_NAME ist nicht verfügbar".

Wie werde ich benachrichtigt, wenn eine Aktion als fehlerhaft markiert wurde? Wenn Google eine fehlerhafte Aktion erkennt, senden wir eine Benachrichtigungs-E-Mail an den primären Entwickler, der mit dem Actions-Projekt verknüpft ist.

Was passiert, wenn meine Aktion mit Kontoverknüpfung als fehlerhaft markiert wird? Im Gegensatz zu anderen Aktionen werden Aktionen, die Kontoverknüpfungen verwenden, nicht gesperrt, nachdem Google sie als fehlerhaft erklärt. Nachdem du die E-Mail-Benachrichtigung erhalten hast, können Nutzer noch 7 Tage lang auf deine Aktion zugreifen. Wenn du das Problem mit der Kontoverknüpfung jedoch nach sieben Tagen noch nicht behoben hast, wird deine Aktion deaktiviert.

Wie kann ich den Status meiner Aktion prüfen? Den Status deiner Aktion kannst du in der Developer Console einsehen. Fehlerhafte Aktionen haben den Status Fehlerhaft. Fehlerfreie Aktionen werden als Bereitgestellt gekennzeichnet.

Wie wird eine Aktion in den bereitgestellten Status zurückgesetzt? Sie sollten Ihre Bereitstellung prüfen und alle Probleme beheben, die dazu führen können, dass die Aktion nicht auf einen Start-Intent reagiert.

Google überwacht den Zustand der Aktion weiterhin regelmäßig, während sie fehlerhaft ist. Wenn Google feststellt, dass die Aktion wie erwartet reagiert, wird sie in den Status „Bereitgestellt“ zurückgesetzt.