Skip to main content
This guide walks you through connecting your first data source and having a conversation with your data. By the end, you’ll have an agent answering real questions from your own databases and files.

​
What you’ll do

  1. Connect a data source to Wayak
  2. Ask the agent a question about your data
  3. Explore follow-up queries and drill into results

​
Step 1: Connect a data source

  1. Go to Data Sources in the Wayak dashboard
  2. Click Add data source and select your database type
  3. Enter your connection credentials (host, port, database, user, password)
  4. Click Test connection to verify
  5. Click Connect
Wayak reads your schema automatically. You’ll see your tables and columns listed once the connection is established.

​
Step 2: Ask your first question

Open the Wayak chat and type a question in plain language. The agent figures out which tables to query, builds the right query, and returns the answer. Try questions like:
  • “How many rows are in [your table name]?”
  • “What are the top 10 records by [a numeric column]?”
  • “Show me a breakdown of [column A] grouped by [column B]”
The agent responds with the answer and shows you the query it ran, so you can verify the logic.

​
Step 3: Go deeper

Once you get your first answer, keep going. The agent maintains context across the conversation, so you can:
  • Drill down — “Now filter that to just the last 30 days”
  • Compare — “How does that compare to the previous quarter?”
  • Pivot — “Break that down by region instead”
  • Export — “Give me that as a table I can copy”
Each follow-up builds on the previous answer. You’re having a conversation with your data, not writing one-off queries.

​
What’s next

You’ve connected data and started chatting. To get more accurate and consistent answers, define a semantic layer that teaches the agent your business logic.

Build a semantic layer

Teach the agent your metrics, terminology, and table relationships.