Überwachen Sie Amazon Q in Connect mithilfe von CloudWatch Protokollen - Amazon Connect
Erforderliche IAM-BerechtigungenEnable logging (Protokollierung aktivieren)Unterstützte ProtokolltypenSuchen Sie nach CloudWatch ProtokollkontingentenBeispiele für AssistentenprotokolleBeispiele für häufig vorkommende Abfragen zu Protokollen des Debug-Assistenten

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Überwachen Sie Amazon Q in Connect mithilfe von CloudWatch Protokollen

Um Einblick in die Empfehlungen zu erhalten, die Amazon Q in Connect Ihren Agenten in Echtzeit gibt, und darüber, welche Kundenabsichten es durch natürliches Sprachverständnis erkennt, können Sie CloudWatch Logs abfragen. CloudWatch Mithilfe von Protokollen erhalten Sie einen Überblick über den gesamten Kontaktverlauf: Konversation, Auslöser, Absichten und Empfehlungen. Sie können diese Informationen auch zum Debuggen verwenden oder sie Ihnen zur Verfügung stellen, Support wenn Sie sich an sie wenden, um Hilfe zu erhalten.

In diesem Thema wird erklärt, wie die Protokollierung für Amazon Q in Connect aktiviert wird.

Erforderliche IAM-Berechtigungen

Bevor Sie die Protokollierung für einen Amazon Q in Connect-Assistenten aktivieren, überprüfen Sie, ob Sie über die folgenden AWS Identity and Access Management Berechtigungen verfügen. Sie sind für das Benutzerkonto erforderlich, das an der Amazon Connect Connect-Konsole angemeldet ist:

  • wisdom:AllowVendedLogDeliveryForResource: Erforderlich, um die Übermittlung von Protokollen für die Assistentenressource zu ermöglichen.

Ein Beispiel für eine IAM-Rolle mit allen erforderlichen Berechtigungen für Ihr spezielles Protokollierungsziel finden Sie unter Protokollierung, für die zusätzliche Berechtigungen erforderlich sind [V2]. Dieses Thema enthält Beispiele für verschiedene Protokollierungsziele, z. B. an Logs gesendete CloudWatch Logs und Logs, die an Amazon S3 gesendet werden. Die Beispiele zeigen, wie Sie Aktualisierungen Ihrer spezifischen Logging-Zielressource zulassen können.

Protokollierung für Amazon Q in Connect aktivieren

Um die Protokollierung für Amazon Q in Connect zu aktivieren, verwenden Sie die CloudWatch API. Führen Sie folgende Schritte aus.

  1. Rufen Sie den ARN Ihres Amazon Q in Connect-Assistenten ab (auch als Domain bezeichnet). Nachdem Sie einen Assistenten erstellt haben, können Sie seinen ARN von der Amazon Connect Connect-Konsole oder durch Aufrufen der GetAssistantAPI abrufen. Der ARN folgt diesem Format:

    arn:aws:wisdom:your-region:your-account-id:assistant/assistant-id

  2. Anruf PutDeliverySource: Verwenden Sie diese CloudWatch API, um eine Lieferquelle für den Assistenten zu erstellen. Übergeben Sie den ARN des Assistenten alsresourceArn. Geben Sie für EVENT_LOGS anlogType, dass Protokolle von Ihrem Assistenten gesammelt werden sollen.

    {
    "logType": "EVENT_LOGS",
    "name": "your-assistant-delivery-source",
    "resourceArn": "arn:aws:wisdom:your-region:your-account-id:assistant/assistant_id
}

  3. Aufruf PutDeliveryDestination: Verwenden Sie diese CloudWatch API, um zu konfigurieren, wo die Protokolle gespeichert werden sollen. Sie können CloudWatch Logs, Amazon S3 oder Amazon Data Firehose als Ziel für das Speichern von Protokollen wählen. Sie müssen den ARN einer der Zieloptionen angeben, wo Ihre Protokolle gespeichert werden sollen. Sie können outputFormat eines der folgenden Protokolle wählen:json,,plain, w3craw,parquet.

    Das folgende Beispiel zeigt, wie Logs so konfiguriert werden, dass sie in einer Amazon CloudWatch Logs-Gruppe und im JSON-Format gespeichert werden.

    {
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:logs:your-region:your-account-id:log-group:your-log-group-name:*"
    },
    "name": "string",
    "outputFormat": "json",
    "tags": {
        "key": "value"
    }
}

  4. Aufruf CreateDelivery: Verwenden Sie diese CloudWatch API, um die Lieferquelle mit dem Lieferziel zu verknüpfen, das Sie in den vorherigen Schritten erstellt haben. Dieser API-Vorgang verknüpft die Lieferquelle mit dem Endziel.

    {
    "deliveryDestinationArn": "string",
    "deliverySourceName": "string",
    "tags": {
        "string": "string"
    }
}

Unterstützte Protokolltypen

Amazon Q in Connect unterstützt den folgenden Protokolltyp:

  • EVENT_LOGS: Protokolle, die das Ereignis eines Amazon Q im Connect-Assistenten während Anrufen und Chats verfolgen.

Suchen Sie nach CloudWatch Protokollkontingenten

Wir empfehlen, die Endpunkte und Kontingente von Amazon CloudWatch Logs zu überprüfen, um festzustellen, ob es Kontingente für API-Aufrufe im Zusammenhang mit der CloudWatch Logs-Lieferung gibt. Kontingente legen fest, wie oft Sie eine API aufrufen oder eine Ressource erstellen können. Eine Überschreitung des Limits führt zu einem ServiceQuotaExceededException Fehler.

Beispiele für Assistentenprotokolle

Im Folgenden finden Sie ein Beispiel für ein Ereignisprotokoll. Je nach Ereignistyp sind möglicherweise mehr Felder sichtbar.

{
    "assistant_id": "AssistantId",
    "event_timestamp": 1729530173612,
    "event_type": "TRANSCRIPT_CREATE_SESSION" | "TRANSCRIPT_INTENT_TRIGGERING_REFERENCE" | "TRANSCRIPT_RECOMMENDATION" | "TRANSCRIPT_UTTERANCE" | "TRANSCRIPT_TRIGGER_DETECTION_MODEL_INVOCATION" | "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION",
    "session_id": "SessionId",
    "session_name": "SessionName",
    "recommendation": "Recommendation",
    "intent": "Intent",
    "prompt": "Prompt",
    "utterance": "Utterance"
}

Je nach Ereignistyp sind möglicherweise mehr Felder sichtbar. Beispielsweise enthält ein Chat- oder Sprachereignis Informationen zur Äußerung. Ein Ereignis, das eine Empfehlung generiert hat, enthält Informationen zur Absicht, zum Auslöser oder zur Empfehlung selbst.

Beispiele für häufig vorkommende Abfragen zu Protokollen des Debug-Assistenten

Sie können mithilfe von Abfragen mit Protokollen interagieren. Sie können beispielsweise alle Ereignisse innerhalb einer Sitzung abfragen, indem Sie SESSION_NAME

Im Folgenden finden Sie zwei häufig verwendete Abfragen, um alle für eine bestimmte Sitzung generierten Protokolle zurückzugeben.

  • filter session_name = "SessionName"

  • filter session_id = "SessionId"