Skip to content

Commit 2ad5786

Browse files
wierdvanderhaaramotl
authored andcommitted
Chatbot: Add notebook for DIS2025 workshop
1 parent 75be61c commit 2ad5786

File tree

2 files changed

+1905
-0
lines changed

2 files changed

+1905
-0
lines changed
Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
# Timeseries QA with LLMs
2+
3+
*Combine Telemetry Data and Manuals for Smarter Diagnostics.*
4+
5+
---
6+
7+
## Summary
8+
9+
In this hands-on workshop, participants will build an AI-powered assistant that can answer questions using a combination of **timeseries telemetry data** and **structured machine manuals**.
10+
11+
Using **CrateDB** as a scalable time-series database and **OpenAI's large language models**, attendees will walk through how to:
12+
- Simulate telemetry data
13+
- Store and query with SQL
14+
- Convert natural language into structured SQL queries
15+
- Integrate external context (like manuals)
16+
- Generate explanations and visualizations based on live data
17+
18+
This workshop combines **Table-Augmented Generation (TAG)** with best practices in prompt design, data enrichment, and telemetry monitoring — creating an interactive diagnostics assistant from scratch.
19+
20+
By the end of the session, participants will have a working QA system capable of answering both technical and operational questions in natural language, using real telemetry data and contextual documentation.
21+
22+
---
23+
24+
## Key Takeaways
25+
26+
- Understand how to build a **TAG (Table-Augmented Generation)** assistant using structured data and manuals
27+
- Learn how to simulate, store, and analyze **timeseries data** in **CrateDB**
28+
- Master prompt engineering techniques to guide LLMs in generating accurate SQL queries
29+
- Combine telemetry results with structured documentation (manuals) to generate full-context answers
30+
- Create **visualizations** from natural-language queries using **Matplotlib and Plotly**
31+
- Explore how LLMs can reason across structured (CrateDB) and unstructured (manuals) sources
32+
33+
---
34+
35+
## Requirements from Attendees
36+
37+
- **Laptop + Charger** (for running Jupyter notebooks)
38+
- **Python Basics** (e.g. working with pandas, functions, etc.)
39+
- **Basic SQL Knowledge** (SELECT, WHERE, GROUP BY…)
40+
- **OpenAI API Key** (required for accessing GPT)
41+
42+
---
43+
44+
## Maturity Level
45+
46+
**Intermediate**
47+
This workshop is ideal for developers, data engineers, solution architects, and tech leads who have some experience with Python and data querying. No deep ML background is needed — the focus is practical application.
48+
49+
---
50+
51+
## Type of Workshop
52+
53+
**Hands-On Lab**
54+
Participants will interactively build, run, and modify a full-stack LLM-powered assistant. Exercises are incremental, exploratory, and designed for real-world relevance.
55+
56+
---
57+
58+
## Try It Out
59+
60+
You can explore the full interactive notebook in two ways:
61+
62+
### ▶️ Run It Directly in Google Colab
63+
Click below to launch the notebook in a ready-to-use Colab environment (no setup needed):
64+
65+
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/crate/cratedb-examples/blob/main/topic/chatbot/table-augmented-generation/workshop/telemetry-diagnostics-assistant.ipynb)
66+
67+
### 📓 View the Notebook on GitHub
68+
[🧠 Timeseries QA Notebook (Jupyter)](https://github.com/crate/cratedb-examples/blob/main/topic/chatbot/table-augmented-generation/workshop/telemetry-diagnostics-assistant.ipynb)

0 commit comments

Comments
 (0)