Feat: Updating CCAI Block with https://github.com/GoogleCloudPlatform…

…/gcc-conversational_ai_analytics (#6)

* chore(release): CCAI Insights Block v2.0

CHANGELOG - CCAI Insights block v2.0
v2.0 (2024-12-12)

NEW
Compatible with BQ Schema v4 and higher
Added Agent Operations dashboard
Added _agent_filter view

CHANGES
Refined insights model (adapted for BQ schema v4 and higer, more descriptive fields and functions)
BQ schema v4 and higher incorporate more data (Export your data to BigQuery for custom analysis or visualization in Looker)

README.md

@@ -1,16 +1,44 @@
 # Block CCAI Insights
 
-The Insights block allows you to export data from the CCAI Insights solution and analyze it in Looker. The flexibility of the data model gives you the ability to integrate Insights data with other first party data to unlock deep business insights.
+The Insights block allows you to export data from the CCAI Insights solution and
+analyze it in Looker. The flexibility of the data model gives you the ability to
+integrate Insights data with other first party data to unlock deep business
+insights. Before utilizing this block, you will need to follow the instructions
+for exporting the CCAI Insights data.
 
-Before utilizing this block, you will need to follow the instructions for exporting the [CCAI Insights data.](https://cloud.google.com/contact-center/insights/docs/export)
+## Instructions
 
-**Note:** you will need to set the job to run on a schedule with appropriate filters or integrate with Cloud Data Fusion. Do not utilize the Export button in the Insights interface as there are currently limits on the number of records able to be exported as well as no ability to append data in the target table.
+1. Copy each of files from the dashboards, models and views folders into a new
+   LookML Project.
+2. Copy the manifest.lkml file into the LookML project.
+3. Update the db_connection_name constant in the manifest file with your db
+   connection name.
+4. Update the insights_table constant in the manifest file with your Insight
+   export's dataset.table name.
 
-**Included in the Block:**
+**Note:** This Looker block is compatible with [BQ Schema
+*v4](https://cloud.google.com/contact-center/insights/docs/bigquery-all-schemas)
+*and higher
 
-+ Data Model: translates the CCAI Insights export schema and allows for customization of metrics.
-+ One Explore: user-friendly point and click interface for performing ad-hoc queries.
-+ Call Center Performance: Executive dashboard displaying high-level metrics intended for call center management.
-+ Agent Performance: Performance metrics for an individual agent, linked from the Agent ID dimension.
+## Included in the Block:
+
++ Data Model: translates the CCAI Insights export schema and allows for
+  customization of metrics.
++ One Explore: user-friendly point and click interface for performing ad-hoc
+  queries.
++ Call Center Performance: Executive dashboard displaying high-level metrics
+  intended for call center management.
++ Agent Performance: Performance metrics for an individual agent, linked from
+  the Agent ID dimension.
 + Agent Operations: Performance metrics for agents in aggregate.
-+ Conversation Lookup Dashboard: Detailed transcript and sentiment analysis for an individual conversation, linked from the Conversation Name dimension.
++ Conversation Lookup Dashboard: Detailed transcript and sentiment analysis for
+  an individual conversation, linked from the Conversation Name dimension.
+
+## Troubleshooting
+
+Common LookML Error: "Ensure the database connection is working and the modeled
+syntax is appropriate to the connections SQL dialect. Query execution failed: -
+Name agents not found insight insights_data at [13:32]" The Insights BQ export
+schema is still on v3 whereas the field "agents" is a nested field in v4+
+schemas. You may need to request to allowlist your instance to a later version
+and recreate the BQ export.