排查 Dialogflow 运行时集成问题

如果您已启用 Dialogflow 运行时集成,但 CX Insights 控制台未显示在 Dialogflow 中创建的对话,请按以下步骤进行问题排查。

  • 请确保您已满足所有功能前提条件
  • 检查您使用的是项目级安全设置还是代理级安全设置。V2 安全设置适用于整个项目,且仅在全球区域可用。其他所有区域将使用代理专用或对话配置文件专用安全设置。

  • 运行以下 curl 命令,列出 Dialogflow 或 Agent Assist 项目中的所有可用安全设置。

    curl -H "Content-Type: application/json" \
        -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
        -H "x-goog-user-project: PROJECT" \
       'https://LOCATION-dialogflow.googleapis.com/v3/projects/PROJECT/locations/LOCATION/securitySettings'
  • 如需修改现有的安全设置,请从列表命令的响应中获取设置 ID。例如,projects/ccai-fishfood/locations/us-east1/securitySettings/729a8e06dfed549fSECURITY_SETTINGS=729a8e06dfed549f

  • 运行以下 curl 命令以更新 Dialogflow SecuritySettings。将 enable_insights_export 设置为 true

    curl -H "Content-Type: application/json" \
        -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
        -H "x-goog-user-project: PROJECT" \
        -X PATCH https://LOCATION-dialogflow.googleapis.com/v3/projects/PROJECT/locations/LOCATION/securitySettings/SECURITY_SETTINGS?update_mask=insights_export_settings \
        --data '{"insights_export_settings": {"enable_insights_export": true}}'
  • 使用以下命令创建启用了 CX Insights 的安全设置。

    curl -H "Content-Type: application/json" \
        -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
        -H "x-goog-user-project: PROJECT" \
        -X POST https://LOCATION-dialogflow.googleapis.com/v3/projects/PROJECT/locations/LOCATION/securitySettings\
        --data '{ "display_name": "Insights export enabled", "insights_export_settings": {"enable_insights_export": true}}'
  • 如果您想保存录音以供日后播放,请运行以下 curl 命令来设置 Cloud Storage 存储桶的名称和音频文件的格式。

    curl -H "Content-Type: application/json"\
        -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
        -H "x-goog-user-project: PROJECT" \
        -X PATCH https://LOCATION-dialogflow.googleapis.com/v3/projects/PROJECT/locations/LOCATION/securitySettings/SECURITY_SETTINGS?update_mask=audio_export_settings\
        --data '{"audio_export_settings":{"gcs_bucket": "BUCKET","audio_format": "FORMAT"}}'
  • 如果使用 Agent Assist,请在对话配置文件页面中将安全设置附加到所有对话配置文件:

  • 如果使用 Dialogflow,请前往代理设置页面,然后在安全标签页中附加安全设置。针对每个虚拟客服重复执行此步骤。

  • 确保在启用运行时集成后,已进行了一些 Dialogflow 对话。Dialogflow 运行时集成不会反向应用于对话。
  • 如果使用 AnalyzeContent,请确保对话已关闭。
  • 确保 Customer Experience Insights 服务代理具有从 Dialogflow 中提取对话的权限
  • 查看 Cloud Monitoring Metrics Explorer,了解与集成相关的具体指标。查找资源类型 Customer Experience Insights 环境和指标 Contact Center AI 运行时的通知。此指标显示了 Dialogflow 是否在对话发生时实际通知了 CX Insights。
  • 检查日志浏览器,找出问题所在。
  • 如果上述步骤均无法解决您的问题,请与您的 Google 代表联系。您可以直接向他们发送支持请求和反馈。
curl -H "Content-Type: application/json"\
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)"\
     -H "x-goog-user-project: PROJECT"\
    'https://LOCATION-dialogflow.googleapis.com/v3/projects/PROJECT/locations/LOCATION/securitySettings'
curl -H "Content-Type: application/json"\
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)"\
     -H "x-goog-user-project: PROJECT"\
    'https://LOCATION-dialogflow.googleapis.com/v3/projects/PROJECT/locations/LOCATION/agents/AGENT-ID'
curl -H "Content-Type: application/json"\
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)"\
     -H "x-goog-user-project: PROJECT"\
    'https://LOCATION-dialogflow.googleapis.com/v2/projects/PROJECT/locations/LOCATION/conversationProfiles'