Skip to content
Β 
Β 

Latest commit

Β 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Workshop: Streamlining Agentic AI with Confluent and Databricks

Duration: ~1.5 hours

Difficulty: Intermediate

Technical Requirements: Working knowledge of cloud platforms (AWS), SQL, and basic command-line operations

Workshop Type: This workshop is designed to work for both self-service and instructor-led scenarios.

πŸ“– Overview

This hands-on workshop demonstrates how to build a complete real-time AI-powered marketing pipeline for the hospitality industry. You will play the role of a data engineer at River Hotels, a fictitious hospitality company, to create an end-to-end data architecture proof-of-concept that transforms raw customer interactions into personalized marketing campaigns using cutting-edge streaming technologies.

Email to River Hotel Potential Customer

Watch this ~13 minute demo video to see the solution to a similar use case.

If you have any issues or feedback for this workshop, Please let us know in this quick 2-minute survey!

βœ… Prerequisites

Important

Cloud and Region Compatibility

This workshop is currently only compatible with AWS and requires the following services to be available in your chosen region:

  • Amazon EC2 (for Oracle database hosting)
  • Amazon S3 (for Delta Lake storage)
  • Amazon Bedrock (OPTIONAL - for AI model access)
  • Amazon VPC (for networking)

Recommended AWS regions:

  1. us-west-2 or us-east-2
  2. us-east-1

If you are going through this workshop with a presenter from Confluent, they should provide additional guidance/limitations for cloud regions as needed.

You must complete each of these in order to successfully go through this workshop:

Required Accounts

  • Confluent Cloud account with admin privileges - sign up for a free trial
  • Databricks account and existing workspace - paid or free edition account are strongly recommended. Free trial account sometimes experience data syncing issues with this workshop, so we recommend that you use paid or free edition accounts.
  • AWS account with permissions to create cloud resources (EC2, S3, VPC, IAM, Bedrock (optional))

Important

Payment Method or Promo Code Required for Confluent Cloud

You must either add a payment method or redeem a coupon code to be able to run this workshop.

Required Tools

Additional Setup Required

Instructions for these steps appear further into the workshop:

  • Databricks service principal with appropriate permissions
  • AWS Bedrock access enabled for Claude models in your chosen region

🏨 Use Case

River Hotels is at a critical juncture. Despite being a successful hospitality company with properties across multiple continents, they're slowly losing ground to more agile competitors who can respond to market opportunities in real-time. The executive leadership team has identified a fundamental problem: their data infrastructure is holding back their ability to compete effectively in today's fast-paced hospitality market.

⚠️ The Challenge

River Hotels' current batch-processing approach means that by the time sales and marketing teams get insights about customer behavior, booking patterns, and market opportunities, those insights are already stale. Competitors could be capturing customers who browse River Hotels' website but don't book immediately, while River Hotels' marketing team is still waiting for last week's data to become available.

As the lead data engineer, you've been called into an urgent cross-departmental meeting where each team has laid out their critical business needs:


πŸ’° The Sales Dilemma

"We're flying blind," says the Sales Director. "When a potential corporate client asks about our occupancy rates or customer satisfaction trends, I have to tell them I'll get back to them next week. By then, they've already signed with our competitor who had those numbers instantly available."


πŸš€ The Marketing Predicament

The Marketing Manager shares a similarly frustrating story: "Every week, we try to run a 'discount deal' campaign for an underperforming but highly-rated property. But our current process takes 2-3 days just to identify which hotel needs promotion and another 2 days to analyze, create, review, and publish messaging that resonates with potential guests. By the time we launch the campaign, it's been over a week and the opportunity is lost."


βš™οΈ The Engineering Conundrum

The Engineering Director is supportive but realistic: "Whatever solution we build needs to integrate with our existing Oracle database infrastructure and can't require a massive operational overhead. We're already stretched thin, and we need something built on proven, enterprise-grade technology that our small team can actually maintain."


πŸ’Ό The Business Imperative

The CEO has made it clear: "We're losing deals because we can't act on opportunities fast enough. Our competitors are using AI and real-time data to personalize customer experiences and optimize their operations. We need to catch up, and we need to do it quickly."


πŸŽ–οΈ Your Mission

Your task is to design and implement a proof-of-concept that transforms River Hotels from a data-lagging organization into a real-time, AI-powered competitor.

Solution Requirements

  1. πŸ“‘ Capture customer behavior as it happens
  2. ✨ Enrich data with meaningful insights
  3. πŸ€– Process intelligently with AI
  4. πŸ”“ Unlock teams to act on insights immediately

🎯 Success Metrics

  1. πŸ’« Data Freshness - Moving from week-old batch data to insights that are less than one hour old
  2. ⏱️ Operational Efficiency - Reducing manual data analysis from days to minutes through enriched datasets and automation
  3. πŸ† Competitive Advantage - Responding to market opportunities in real-time rather than after the fact

πŸ› οΈ What You'll Build

By the end of this workshop, you will have constructed a sophisticated data pipeline that:

  1. Captures Real-Time Customer Behavior: Set up Oracle XStream CDC to capture customer and hotel data changes, plus generate realistic clickstream, booking, and review data using ShadowTraffic
  2. Processes Streaming Data with AI: Use Apache Flink SQL to identify high-value prospects (customers who clicked but didn't book) and enrich their profiles with hotel reviews summarized by Large Language Models
  3. Streams to Delta Lake: Leverage Confluent Tableflow to automatically sync processed data streams as Delta tables in AWS S3
  4. Generates AI-Driven Insights: Use Databricks Genie to analyze booking patterns, customer preferences, and hotel performance metrics
  5. Creates Personalized Campaigns: Deploy AI agents in Databricks that identify underperforming hotels with good customer satisfaction, generate targeted social media content based on customer review analysis, and create lists of potential customers for marketing outreach

πŸŽ“ Key Learning Outcomes

  • Infrastructure as Code: Deploy complex multi-cloud resources (AWS, Confluent Cloud, Databricks) using Terraform
  • Change Data Capture: Implement Oracle XStream for real-time database change streaming
  • Stream Processing: Build sophisticated Flink SQL queries for real-time data enrichment and AI model integration
  • Data Lake Integration: Use Tableflow to seamlessly bridge streaming data and analytics platforms
  • AI-Powered Analytics: Apply generative AI for both data summarization and marketing content creation
  • Event-Driven Architecture: Design systems that react to customer behavior in real-time

πŸ›οΈ Architecture Overview

At a high level, the solution you build is represented by this diagram:

Architecture Diagram

πŸ—„ Datasets

There are five normalized interrelated datasets that you will be streaming to Confluent Cloud:

  1. Customers: Master customer profiles containing contact information and demographics. These records serve as the foundation for customer behavior analysis across all other data streams.

  2. Hotels: Comprehensive hotel property data including amenities, descriptions, locations, and capacity details.

  3. Clickstream: Real-time website interaction events capturing customer browsing behavior, page views, and hotel searches.

  4. Hotel Reviews: Customer feedback with ratings (1-5 stars) and detailed review text, linked to specific bookings.

  5. Bookings: Reservation transaction data linking customers to hotels with check-in/check-out dates, pricing, and guest counts.

πŸ”— Data Entity Relationship

This diagram depicts how these datasets relate to each other:

erDiagram
    CUSTOMER {
        string CUSTOMER_ID PK
        string EMAIL UK
        string FIRST_NAME
        string LAST_NAME
        string BIRTH_DATE
        long CREATED_AT
    }

    HOTEL {
        string HOTEL_ID PK
        string NAME
        string AMENITIES
        string DESCRIPTION
        string CITY
        string COUNTRY
        int ROOM_CAPACITY
        long CREATED_AT
    }

    BOOKING {
        string BOOKING_ID PK
        string CUSTOMER_EMAIL FK
        string HOTEL_ID FK
        long CHECK_IN
        long CHECK_OUT
        int OCCUPANTS
        int PRICE
        long CREATED_AT
    }

    CLICKSTREAM {
        string ACTIVITY_ID PK
        string CUSTOMER_EMAIL FK
        string HOTEL_ID FK
        string ACTION
        int EVENT_DURATION
        string URL
        long CREATED_AT
    }

    REVIEW {
        string REVIEW_ID PK
        string BOOKING_ID FK
        int REVIEW_RATING
        string REVIEW_TEXT
        long CREATED_AT
    }

    %% Relationships
    CUSTOMER ||--o{ BOOKING : "makes"
    CUSTOMER ||--o{ CLICKSTREAM : "generates"
    HOTEL ||--o{ BOOKING : "receives"
    HOTEL ||--o{ CLICKSTREAM : "viewed_in"
    BOOKING ||--o{ REVIEW : "has"
Loading

🧩 Key Components

  1. Data Sources

    • ShadowTraffic: Realistic synthetic data generation of:
      • Customer and Hotel data, which is sent to an Oracle database
      • Bookings, Reviews, and Clickstream events, which are all produced to Kafka topics
  2. Ingestion Layer

    • Oracle XStream CDC Connector: Real-time change data capture from Oracle
    • Kafka Producers: Stream synthetic data directly from ShadowTraffic to Confluent Cloud topics
  3. Processing Layer

    • Apache Flink SQL: Real-time stream processing and data enrichment
    • (Optional) AWS Bedrock Integration: AI-powered review summarization using Claude models
    • Stream Analytics: Identification of high-value prospects and customer behavior analysis
  4. Integration Layer

    • Confluent Tableflow: Automated streaming data to Delta Lake format
    • AWS S3: Delta Lake storage for processed data streams
  5. Analytics Layer

    • Databricks SQL: Advanced analytics and querying capabilities
    • Databricks Genie: Natural language interface for business intelligence
    • AI Agents: Intelligent hotel selection, review analysis, and customer targeting for automated marketing campaigns

πŸ”¬ Workshop Labs

This workshop is organized into seven sequential labs listed below.

Each lab builds upon the previous one, so start with LAB 1 and continue sequentially until completion.

Duration: ~10 minutes

Configure cloud platform accounts and credentials:

  • Repository Setup: Clone workshop repository and prepare workspace
  • Confluent Cloud Configuration: Set up environment and API keys
  • Databricks Account Setup: Configure service principal and workspace access
  • AWS CLI Authentication: Establish AWS credentials and permissions

Duration: ~10 minutes

Deploy the infrastructure foundation using Terraform:

  • Multi-Cloud Infrastructure Deployment: Provision AWS, Confluent Cloud, and Databricks resources
  • Infrastructure Validation: Verify resource creation and connectivity
  • Platform Integration: Establish secure connections between cloud platforms

Duration: ~15 minutes

Connect systems and enable data streaming:

  • Unity Catalog Integration: Configure Confluent Tableflow with Databricks Unity Catalog
  • Oracle Data Streaming: Set up Oracle XStream CDC connector for real-time database changes

Duration: ~10 minutes

Generate realistic customer behavior data:

  • Realistic Data Generation: Deploy ShadowTraffic for authentic hospitality industry data patterns
  • Topic Validation: Verify Oracle CDC and ShadowTraffic data streaming to Kafka topics
  • Tableflow Integration: Enable automated Delta Lake synchronization for clickstream data

Duration: ~15 minutes

Transform raw data streams into intelligent, enriched data products:

  • Stream Processing: Build Flink SQL queries for real-time data enrichment and denormalization
  • Data Product Creation: Create snapshot tables and interval joins for reliable CDC processing
  • Delta Lake Sync: Configure Tableflow for automated streaming to Delta Lake tables

Duration: ~25 minutes

Generate actionable insights and AI-powered marketing campaigns:

  • Delta Lake Analytics Integration: Connect streaming Delta tables from Tableflow to Databricks
  • AI-Powered Business Intelligence: Use Databricks Genie for natural language insights
  • Intelligent Marketing Automation: Deploy AI agents for hotel promotion and customer targeting
  • End-to-End Pipeline Validation: Complete real-time journey from customer behavior to AI-generated marketing content

Duration: ~5 minutes

Responsible cleanup of all provisioned cloud resources:

  • Manual Cleanup: UI-created resources (connectors, integrations)
  • Automated Cleanup: Terraform destroy for infrastructure resources
  • Cost Optimization: Ensure no resources are left running

Additional Resources

πŸ› οΈ Technical Stack

Core Technologies

  • Terraform: Infrastructure as Code for multi-cloud deployment
  • Oracle XStream: Change data capture for real-time data streaming
  • Apache Kafka: Distributed streaming platform via Confluent Cloud
  • Apache Flink: Stream processing and real-time analytics
  • Delta Lake: Open-source storage framework for data lakes

Cloud Platforms

  • Confluent Cloud: Fully managed Apache Kafka service
  • AWS: Primary cloud provider (EC2, S3, VPC, Bedrock)
  • Databricks: Unified analytics platform for big data and ML

AI/ML Services

Tools

  • Docker: Containerization for Oracle database and ShadowTraffic
  • Git: Version control
  • AWS CLI: AWS command-line interface
  • ShadowTraffic: Realistic synthetic data generation

🏁 Conclusion

Congratulations, you have completed this hands-on workshop to Streamline Agentic AI with Confluent and Databricks!

Important

Your Feedback Helps!

Please help us improve this workshop by leaving your feedback in this quick 2-minute survey!

Thanks!

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages