# Send Zero TiDB(Deprecated) to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "zero",
    "name": "Zero TiDB(Deprecated)",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Bosn/zero",
    "canonicalUrl": "https://clawhub.ai/Bosn/zero",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/zero",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zero",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "zero",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T14:53:50.522Z",
      "expiresAt": "2026-05-11T14:53:50.522Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zero",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zero",
        "contentDisposition": "attachment; filename=\"zero-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "zero"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/zero"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/zero",
    "downloadUrl": "https://openagent3.xyz/downloads/zero",
    "agentUrl": "https://openagent3.xyz/skills/zero/agent",
    "manifestUrl": "https://openagent3.xyz/skills/zero/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/zero/agent.md"
  }
}
```
## Documentation

### Create Disposable TiDB Cloud Zero Databases (Technical Preview)

Browser UI Note: There is no browser-based SQL editor on this site. To run SQL, use API + CLI, or sign in to TiDB Cloud Console (login required).

Use this guide to create disposable TiDB Cloud Zero databases for agent workflows.

### Deterministic SQL Smoke Test (API + CLI)

# 1) Provision instance
curl -s -X POST https://zero.tidbapi.com/v1alpha1/instances \\
  -H "Content-Type: application/json" \\
  -d '{"tag":"sql-smoke-test"}' \\
  | tee tidb-zero.json

# 2) Extract connection string
jq -r '.instance.connectionString // .connectionString' tidb-zero.json

# 3) Run SQL query (replace <connectionString> with step 2 output)
mysql "<connectionString>" -e "SELECT 1 AS health_check, 2 AS example_value;"

Expected output includes one row with health_check=1 and example_value=2.

### Endpoint

Method: POST
URL: https://zero.tidbapi.com/v1alpha1/instances
Content-Type: application/json
Technical Preview: Current API path is /v1alpha1/instances, and this path may change in later releases.

### Request Body

Optional: tag (caller identifier used for tracing and grouping runs).

{
  "tag": "support-bot"
}

### Quick Start

curl -X POST https://zero.tidbapi.com/v1alpha1/instances \\
  -H "Content-Type: application/json" \\
  -d '{
    "tag": "agent-run"
  }'

### Response

The API returns connection details and expiration time.

Current response shape: top-level instance.
instance.connection fields: host, port, username, password.
Use these fields: instance.connectionString for direct URI connection, and instance.expiresAt for expiration.
Agent note: After provisioning succeeds, save the instance details to a local file (for example, tidb-cloud-zero.json) and remind the user to store the file securely because it contains sensitive credentials.
Planned update: we will provide claimUrl in a later version. Users will be able to sign in to TiDB Cloud and claim the temporary database before instance.expiresAt, converting it into a formal TiDB Cloud Starter database.

{
  "instance": {
    "connection": {
      "host": "<HOST>",
      "port": 4000,
      "username": "<USERNAME>",
      "password": "<PASSWORD>"
    },
    "connectionString": "mysql://<USERNAME>:<PASSWORD>@<HOST>:4000",
    "expiresAt": "<ISO_TIMESTAMP>"
  }
}

### Use the Connection String

After you receive the response, use instance.connectionString to connect with a MySQL-compatible client or driver.

### Guided Quick Experience

After provisioning succeeds, you should ask the user:

Do you want me to create a sample table and insert demo data so you can query immediately?

If the user says yes, run a small bootstrap SQL flow like this:

CREATE TABLE IF NOT EXISTS quickstart_notes (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  title VARCHAR(100) NOT NULL,
  content TEXT NOT NULL,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

INSERT INTO quickstart_notes (title, content) VALUES
  ('welcome', 'TiDB Cloud Zero quickstart row'),
  ('query-demo', 'Run SELECT * FROM quickstart_notes; to verify data');

SELECT * FROM quickstart_notes ORDER BY id;

### Connect via CLI

mysql --connect-timeout=10 --protocol=TCP -h '<HOST>' -P 4000 -u '<USERNAME>' -p'<PASSWORD>'

### Connect in Node.js (mysql2)

import mysql from "mysql2/promise";

const response = await createDatabase(); // your API call result
const connectionUrl = new URL(response.instance.connectionString);
connectionUrl.pathname = "/<DATABASE>";
connectionUrl.searchParams.set("ssl", JSON.stringify({ rejectUnauthorized: true }));

const connection = await mysql.createConnection(connectionUrl.toString());
const [rows] = await connection.query("SELECT NOW() AS now_time");
console.log(rows);
await connection.end();

### Resources

TiDB SQL skill: https://skills.sh/pingcap/agent-rules/tidb-sql
PyTiDB skill: https://skills.sh/pingcap/agent-rules/pytidb (Use this skill to connect to TiDB from Python via pytidb, define tables, and build search / AI features.)
TiDB Cloud docs: https://docs.pingcap.com/tidbcloud/
TiDB Cloud website: https://tidbcloud.com/
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Bosn
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T14:53:50.522Z
- Expires at: 2026-05-11T14:53:50.522Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/zero)
- [Send to Agent page](https://openagent3.xyz/skills/zero/agent)
- [JSON manifest](https://openagent3.xyz/skills/zero/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/zero/agent.md)
- [Download page](https://openagent3.xyz/downloads/zero)