Skip to content
Discover Logo Discover Docs

Quick Start

Welcome to Discover. This guide walks you through the full flow — from logging in to running your first query using a Coordinator Agent.

  1. Log In

    Open Discover in your browser and sign in with your credentials.

    → See Logging In for SSO and username/password login options.

  2. Configure your LLM

    Discover needs a language model before you can create any agents.

    1. In the left sidebar, hover over User Settings and click Model Providers.
    2. Select your LLM provider (e.g. Gemini) and enter your API key.
    3. Click Add Model, then click Set Default Model and choose the default models for chat and embedding.

    → Full instructions: Model Providers

  3. Add a Knowledge Base (optional)

    If your agents need to search documents, API definitions, or any reference material, set up a Knowledge Base before creating agents.

    1. Click Knowledge Base in the left sidebar and click Create Knowledge Base.
    2. Upload your documents and parse them.

    → Full instructions: Creating Knowledge Bases

  4. Create an Agent

    Choose the agent type that fits your data source:

    Database Agent — connects to a relational database (PostgreSQL, MySQL, MariaDB) and answers questions by generating SQL.

    1. Click Agent in the left sidebar, then click New Agent.
    2. Give it a name and select Database Agent.
    3. Enter your database connection details and click Test Connection.
    4. Click Fetch DDL to load your schema, select the relevant tables, and enrich descriptions.
    5. (Optional) Add domain knowledge — business rules or metric definitions the agent should know.
    6. Click Create Agent.

    → Full instructions: Database Agent · Fetching Schema

    API Agent — connects to a REST API and answers questions by generating API payloads.

    1. Click Agent in the left sidebar, then click New Agent.
    2. Give it a name and select API Agent.
    3. Fill in the API URL, method, headers, and field definitions.
    4. Click Create Agent.

    → Full instructions: API Agent

  5. Create a Coordinator Agent

    A Coordinator Agent sits in front of your sub-agents and routes queries intelligently. You need at least one sub-agent (your Database Agent from the step above) before creating one.

    1. On the Agent page, click New Agent, give it a name, and select Coordinator Agent.
    2. Select your Database Agent as a sub-agent.
    3. Review the auto-generated prompts and click Create Agent.

    → Full instructions: Coordinator Agent

  6. Run Your First Query

    1. Open your Coordinator Agent and click Run.
    2. Type a question in plain English, for example:

      “What were total sales last month?”

    3. The Coordinator Agent routes the question to your Database Agent, which generates and executes the SQL, then returns the answer.

What’s Next

Section titled “What’s Next”

Now that you have a working setup, explore what else Discover can do: