← All guides

10 min

Connect a database

Give a workflow Postgres, MySQL, or ClickHouse. It reads the schema, writes real SQL, and checks the results in its own sandbox.

5,000 free credits to start.

  1. 01

    Create a read-only role first

    Before you touch Helios, create a database role that can read the schemas a task needs and nothing else. Your database enforces the rule, which is where that decision belongs.

  2. 02

    Add the connection

    From Settings, then Integrations, add a Postgres, MySQL, or ClickHouse connection with a host, port, database, and credentials. The connection string is encrypted and decrypted only when a run needs it.

  3. 03

    Reach a private database through an SSH tunnel

    When the database sits on a private network, add an SSH tunnel on the connection. Runs connect through the bastion you name. Nothing is exposed to the public internet.

  4. 04

    Ask a question you already know the answer to

    Start a chat, attach the database, and ask something you can check. The agent reads tables, columns, types, and keys, writes the SQL, runs it, and explains the result. Compare it with the answer you knew.

  5. 05

    Read the SQL it wrote

    Every run records the queries the agent ran and the rows they returned. When a number looks wrong, the query that produced it is in the transcript.

  6. 06

    Reuse the prompt as a workflow

    Create a workflow with the same prompt and add a schedule. Put stable facts about the schema in the prompt so every run starts with them.

Try it in your workspace.

Start free, connect a tool, and write the first prompt in plain words.