Add docs for cedardb cloud and the agents feature by lukasvogel · Pull Request #237 · cedardb/docs

lukasvogel · 2026-11-12T10:15:21Z

No description provided.

ChrisWint · 2026-11-12T12:55:30Z

There are already docs for cedardb cloud, of course not agent specific but we should not duplicate that

Split the CedarDB Cloud page into Get Started, Manage Projects, Monitoring and Backups, and redirect its old address.

Lukasdoe · 2026-11-12T13:59:44Z

+## Sign up
+
+1. Open the [CedarDB Cloud sign-up page](https://app.cedardb.cloud/signup/).
+2. Enter your details and confirm your email address.


maybe add a note that says that people should double check spam 🙈

Lukasdoe · 2026-11-12T14:01:27Z

+Before your first project starts, also for the trial, you add a payment card.
+CedarDB Cloud verifies it before it creates the project.


Suggested change

Before your first project starts, also for the trial, you add a payment card.

CedarDB Cloud verifies it before it creates the project.

Before your first project starts, also for the trial, you add a payment card.

CedarDB Cloud verifies it before it creates the project. We never charge your card before the end of the trial.

Lukasdoe · 2026-11-12T14:02:31Z

+
+{{% /steps %}}
+
+CedarDB Cloud then creates the project and starts its instance.


Suggested change

CedarDB Cloud then creates the project and starts its instance.

CedarDB Cloud then creates the project and starts your database instance.

Lukasdoe · 2026-11-12T14:03:22Z

+
+The **Connection** card on the project's **Overview** tab shows the connection string once the project runs.
+
+![The Connection card on a project's Overview tab](/images/cloud/connection.png)


maybe increase font size here, this is rather hard to read from afar.

Lukasdoe · 2026-11-12T14:15:47Z

+
+Open the project in CedarDB Cloud and go to its **Agents** tab.
+Select **Switch on**.
+After a moment, the status reads **Agents are on**.


Suggested change

After a moment, the status reads **Agents are on**.

The status changes to **Agents are on** when your instance is ready for agent access.

Lukasdoe · 2026-11-12T14:16:15Z

+
+To let agents read everything at once, select **Let it read all tables**.
+
+![The Agents tab with table access per database and schema](/images/cloud/agents_tab.png)


This is also a bit hard to read, maybe larger font size would help?

Lukasdoe · 2026-11-12T14:16:32Z

+
+```text
+https://api.app.cedardb.cloud/mcp
+```


This can be inlined

bandle · 2026-11-12T14:40:57Z

+
+Every project starts with the user `cedar` and the database `postgres` on port `5432`.
+Connect with `psql` and run a first query:
+


Do you want to mention that users can also regenerate there password here?

Maybe even that we create two users on startup to allow the sql executor and the connection string to run independantly and serve the user with fresh data.

i saw that you had some of the info in project. I think it makes more sense there to keep getting started brief.

bandle · 2026-11-12T14:45:02Z

+  It loses access to every project.
+  To use it again, connect it again.
+
+**Your AI clients** also shows when each client connected and when it last queried.


Revoking the access also rerolls the account password. so in case the agent fiddled with those settings and you are not sure, shutting down (or restarting) brings the access rights to a defined state.

Furthermore the agent never sees the database PW (altough it can set a new one). If you want to add a security angle.

mproebstl · 2026-11-12T13:34:53Z

+You don't have to install, patch, or size anything yourself: create a project, connect with any PostgreSQL-compatible client, and start querying.
+
+* [Get Started](./get_started) — sign up, create a project, and connect to it
+* [Manage Projects](./manage_projects) — start, stop, reset the password, and delete a project


Not for this PR, just that I thought of it now: do we want to have the — in the docs? I think we have them already, but maybe we want to eliminate them? what do you think?

mproebstl · 2026-11-12T13:51:18Z

+1. Open the [CedarDB Cloud sign-up page](https://app.cedardb.cloud/signup/).
+2. Enter your details and confirm your email address.
+3. Sign in at [app.cedardb.cloud](https://app.cedardb.cloud).


Does the user have to open a new site for logging in? do we not redirect with the email confirmation? Somehow it feels a bit weird to me to link the page again

mproebstl · 2026-11-12T13:52:28Z

+2. Enter your details and confirm your email address.
+3. Sign in at [app.cedardb.cloud](https://app.cedardb.cloud).
+
+Your account comes with an organization.


This sentence is weird, maybe better:

Suggested change

Your account comes with an organization.

Your account represents your organization.

or I do not understand the meaning

mproebstl · 2026-11-12T13:53:44Z

+
+Your account comes with an organization.
+It groups your projects and holds your billing details and limits.
+Each database you run lives in its own project, with its own storage, connection details, and backups.


Do we want to specify this really on the website? Thinking if we at somepoint want multi tenancy we would need to remove this.

mproebstl · 2026-11-12T14:02:03Z

+Your organization's first project can run as a free trial for 30 days.
+The trial runs on a Cloud I2 instance with up to 64 GiB of storage.
+
+Before your first project starts, also for the trial, you add a payment card.


Suggested change

Before your first project starts, also for the trial, you add a payment card.

Before your first project starts, also for the trial, you need to add a payment card.

mproebstl · 2026-11-12T14:46:34Z

+If the newest backup failed, the tab says so above the backup history.
+Select **Show error** next to the failed backup to see why.


there is now new line before the select displayed. I think we should have one

mproebstl · 2026-11-12T14:48:06Z

+
+### Confirm the restore
+
+Type the project's name to confirm, then select **Restore backup**.


As a future feature, I think it would be nice to create a new instance from a backup.

mproebstl · 2026-11-12T14:50:08Z

+Build a dashboard of daily revenue per region for the last 90 days, with a filter by product category.
+```
+
+## Switch agents on for a project


Suggested change

## Switch agents on for a project

## Switch agents `on` for a project

mproebstl · 2026-11-12T14:51:06Z

+
+To let agents read everything at once, select **Let it read all tables**.
+
+![The Agents tab with table access per database and schema](/images/cloud/agents_tab.png)


I think it would be nice to see the side bar to be able to know where this is by looking at the screenshot

mproebstl · 2026-11-12T15:02:03Z

+
+### Explore and answer questions
+
+Agents find their way around an unfamiliar schema and answer questions that would take several queries to answer by hand.


Do agents not also send several queries? I think this sentence is misleading. Maybe:

Suggested change

Agents find their way around an unfamiliar schema and answer questions that would take several queries to answer by hand.

Agents find their way around an unfamiliar schema and answer questions that would be cumbersome to answer by hand as they need multiple queries.

lukasvogel requested review from a team November 12, 2026 10:15

lukasvogel added 2 commits November 12, 2026 14:09

restructure the CedarDB Cloud docs into a section

55ae525

Split the CedarDB Cloud page into Get Started, Manage Projects, Monitoring and Backups, and redirect its old address.

document AI agents in CedarDB Cloud

5f9810a

lukasvogel force-pushed the vogel/ai-agents branch from 2b17a84 to 5f9810a Compare November 12, 2026 13:14

pfent assigned ChrisWint Nov 12, 2026

Lukasdoe reviewed Nov 12, 2026

View reviewed changes

bandle reviewed Nov 12, 2026

View reviewed changes

mproebstl reviewed Nov 12, 2026

View reviewed changes

		Before your first project starts, also for the trial, you add a payment card.
		CedarDB Cloud verifies it before it creates the project.


		{{% /steps %}}

		CedarDB Cloud then creates the project and starts its instance.


		The Connection card on the project's Overview tab shows the connection string once the project runs.

		![The Connection card on a project's Overview tab](/images/cloud/connection.png)

	After a moment, the status reads Agents are on.
	The status changes to Agents are on when your instance is ready for agent access.


		To let agents read everything at once, select Let it read all tables.

		![The Agents tab with table access per database and schema](/images/cloud/agents_tab.png)


		Every project starts with the user `cedar` and the database `postgres` on port `5432`.
		Connect with `psql` and run a first query:

	Your account comes with an organization.
	Your account represents your organization.

		If the newest backup failed, the tab says so above the backup history.
		Select Show error next to the failed backup to see why.


		### Confirm the restore

		Type the project's name to confirm, then select Restore backup.

	## Switch agents on for a project
	## Switch agents `on` for a project


		### Explore and answer questions

		Agents find their way around an unfamiliar schema and answer questions that would take several queries to answer by hand.

Conversation

lukasvogel commented Nov 12, 2026

Uh oh!

ChrisWint commented Nov 12, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants