Ü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, AWS 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.

Eine IAM Beispielrolle mit allen erforderlichen Berechtigungen für Ihr spezifisches 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. Holen Sie sich das ARN von Ihrem Amazon Q in Connect-Assistenten (auch als Domain bezeichnet). Nachdem Sie einen Assistenten erstellt haben, können Sie ihn über die Amazon Connect Connect-Konsole abrufen oder indem Sie den aufrufen GetAssistantAPI. ARN Es ARN folgt diesem Format:

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

  2. Anruf PutDeliverySource: Verwenden Sie diese CloudWatch API Option, um eine Lieferquelle für den Assistenten zu erstellen. Übergeben Sie das 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. Anruf PutDeliveryDestination: Verwenden Sie diese CloudWatch API Option, 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 eine ARN der Zieloptionen für den Speicherort Ihrer Protokolle angeben. Sie können outputFormat eines der folgenden Protokolle wählen:json,,plain, w3craw,parquet.

    Das folgende Beispiel zeigt, wie Protokolle 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. Anruf CreateDelivery: Verwenden Sie diese CloudWatch API Option, um die Lieferquelle mit dem Lieferziel zu verknüpfen, das Sie in den vorherigen Schritten erstellt haben. Bei diesem API Vorgang wird die Lieferquelle dem Endziel zugeordnet.

    {
    "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 Aufrufe im Zusammenhang mit der CloudWatch Logs-Zustellung gibt. API Durch Kontingente wird festgelegt, wie oft Sie eine Ressource aufrufen API 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 gängige Abfragen, um alle für eine bestimmte Sitzung generierten Protokolle zurückzugeben.

  • filter session_name = "SessionName"

  • filter session_id = "SessionId"