Published 2026-09-21 · Tested 2026-08-19
TileDB
FTileDB received 7 PASS votes and passed 0 of five agent surface checks. The clearest finding came from the find the exact limits task.
Three AI models, GPT 5.6 Sol, Claude Opus 5, and DeepSeek v4 Flash, each read TileDB’s public documentation independently and attempted five first-hour developer jobs: create the first array, find the exact limits, recover from a TileDB error, authenticate TileDB Cloud, use the Python SDK.
No accounts, API calls, or code execution were used. Every verdict came from public pages and every published quotation passed a live verification check. Preflight substitutions: T3: TileDB error handling replaced HTTP 429 because it is the documented common recovery path. T4: API-token authentication replaced webhooks because the public docs expose no general TileDB product-webhook interface.
Freshness
How rechecks work- Category
- Databases & analytics
- Tested
- Quotes verified
- Surface rechecked
No change since the test.
5 of 5 quoted passages still appear on the live pages.
23.8% · 19/80 · AI Agent Readiness Score · reading 30 pts · surface 50 pts
Agent surface checks · 0/50
The Reading Test
| Task | GPT 5.6 Sol | Opus 5 | DeepSeek v4F | Consensus |
|---|---|---|---|---|
| Create the first array | PASS | PASS | PASS | PASS |
| Find the exact limits | FAIL | FAIL | PARTIAL | FAIL |
| Recover from a TileDB error | FAIL | PARTIAL | PARTIAL | PARTIAL |
| Authenticate TileDB Cloud | PARTIAL | PARTIAL | PASS | PARTIAL |
| Use the Python SDK | PASS | PASS | PASS | PASS |
docs platform: Quarto 1.6.42 (unscored) · verified 2026-08-19
What to fix first
These 8 fixes could add up to 61 points to the AI Agent Readiness Score. The list ranks each fix by the points it would add. How the ranking works
- 1 +10 points llms.txt check failed
Found: HTTP 200 returned an application HTML shell, not plausible llms content.
Fix: Publish llms.txt at the docs root as plain text, with a title, a one-line summary, and a link to every page.
Evidence: cloud.tiledb.com/
academy/ llms.txt (opens in a new tab) - 2 +10 points llms-full.txt check failed
Found: HTTP 200 returned an application HTML shell, not full documentation text.
Fix: Publish llms-full.txt at the docs root with the full text of every docs page in one plain-text file.
Evidence: cloud.tiledb.com/
academy/ llms-full.txt (opens in a new tab) - 3 +10 points Markdown mirror check failed
Found: The .md URL and content negotiation returned HTML, not Markdown.
Fix: Serve every docs page as Markdown at its URL plus .md, and return the same Markdown for Accept: text/markdown.
Evidence: cloud.tiledb.com/
academy/ home/ index.md (opens in a new tab) - 4 +10 points MCP server check failed
Found: Initialize returned a CSRF error or HTTP 405, not a valid MCP response.
Fix: Run a public MCP server for the docs that answers a JSON-RPC initialize call and offers a docs search tool.
- 5 +10 points Docs AI check failed
Found: The live Academy exposes standard search but no public assistant control.
Fix: Add an assistant to the docs site that answers questions from the docs and links to its sources.
- 6
Found: The Credits page defers unit charges to a Pricing page that omits them, and no page states API quotas.
Fix: Publish the per-unit consumption charges in the docs, and state the API quotas or that none apply.
Evidence: documentation.cloud.tiledb.com/
academy/ accounts/ individual/ profile/ credits (opens in a new tab) - 7
Found: The catching-errors tutorial prints TileDBError and stops, with no diagnostics, correction, or retry steps.
Fix: Add steps to the catching-errors tutorial that read the error, correct the operation, and retry it.
- 8
Found: The Basic TileDB Cloud tutorial expects a preset TILEDB_REST_TOKEN and shows no step to set it outside TileDB Cloud.
Fix: In the Basic TileDB Cloud tutorial, add an external-client example that sets a copied token and opens a Cloud array.
What the docs get right
- Create the first array: 3 PASS votes. The supplied URL returned an app shell; its live Academy mirror provides installation and the complete dense-array flow.
- Use the Python SDK: 3 PASS votes. The stable API documents Array.create and tiledb.open, which match the methods and modes used by the current quickstart.
- 0 of 5 agent surface checks. Present: . Missing: llms.txt, llms-full.txt, markdown mirrors, an MCP server, docs AI.
Create the first array
PASSPASS consensus from 3 PASS.
The supplied URL returned an app shell; its live Academy mirror provides installation and the complete dense-array flow. A single page carries the whole path, install via conda install -c conda-forge tiledb-py or pip install tiledb, then Dim/Domain/Attr/ArraySchema with sparse=False, tiledb.Array.create(), A[:] = data under tiledb.open(..., "w"), and A[:]["a"] to read back, with no step left to inference, though only after the agent discovers that the canonical academy host serves none of it. The Arrays Quickstart documents pip and conda installation, then walks through dimensions, domain, attribute, schema, array creation, write, and read in a single unambiguous code path.
Find the exact limits
FAILFAIL consensus from 1 PARTIAL, 2 FAIL.
It documents $100 for six months but omits storage rates and API quotas; the pricing link shows deployment pricing. Free-tier credits, validity and expiry are stated precisely ($100 for 6 months, remaining credits retracted on downgrade), but the Pricing page this sentence defers to contains no consumption charge, no usage calculator and no occurrence of 'credit', 'slicing' or 'egress', it prices seats and vCPUs instead, while a sweep of all 423 sitemap pages returned zero hits for 'rate limit', 'quota', 'per GB' or 'per TB'. Free-tier credits ($100, 6 months) and expiry are clearly documented, but the per-unit compute and storage rates promised on the credits page are not published on the pricing page, which only shows annual organization pricing. No API rate limits are documented anywhere.
Recover from a TileDB error
PARTIALPARTIAL consensus from 2 PARTIAL, 1 FAIL.
The error page catches and prints TileDBError, but it provides no correction or retry sequence. The tutorial catches tiledb.libtiledb.TileDBError and prints it but stops there, so correcting and retrying required cross-referencing the Configuration page for rest.retry_http_codes/rest.retry_count and the API Usage page for .retry(), and no page in the corpus documents an error code list or the word 'diagnostic'. Configuration-based retry for HTTP 429 is documented (add 429 to rest.retry_http_codes, configure retry_count, delay, and factor). However, no documentation shows the runtime pattern of catching tiledb.TileDBError, extracting diagnostics, correcting the operation, and retrying it. Only preventive configuration is covered.
Authenticate TileDB Cloud
PARTIALPARTIAL consensus from 1 PASS, 2 PARTIAL.
The token page omits token-copy instructions, while separate tutorials assume TILEDB_REST_TOKEN already contains the generated value. Token creation and expiry are documented cleanly under Accounts, but the Arrays Cloud tutorial runs only inside TileDB Cloud and reads an auto-injected TILEDB_REST_TOKEN, so the external-client path had to be recovered from the Tables section, which authenticates with a different call (tiledb.cloud.login(token=token)) than the Arrays page (tiledb.Config({"rest.token": ...}) plus tiledb.default_ctx). The Get Started page links to the API tokens page (UI creation of scoped, expiring tokens) and the Basic TileDB Cloud tutorial shows end-to-end configuration: tiledb.Config with rest.token, tiledb.default_ctx, and tiledb:// URI access.
Use the Python SDK
PASSPASS consensus from 3 PASS.
The stable API documents Array.create and tiledb.open, which match the methods and modes used by the current quickstart. The API Reference page links TileDB-Inc/TileDB-Py to a reference built from TileDB-Py 0.36 against a PyPI latest of 0.36.1, carrying a runnable minimum example under from_numpy and full entries for every symbol the quickstart uses (Dim, Domain, Attr, ArraySchema, Array.create, open), with no contradiction between the two. The API Reference page links to the official TileDB-Py docs and the Arrays Quickstart provides a complete dense-array example that matches the pattern shown in the Basic Dense tutorial.
The receipt
You can find the latest consumption charge for each computational unit, along with a usage calculator, on our Pricing page.
It documents $100 for six months but omits storage rates and API quotas; the pricing link shows deployment pricing.
Agent surface notes
Initialize returned a CSRF error or HTTP 405, not a valid MCP response.
The live Academy exposes standard search but no public assistant control.
Show the score
Paste this into a readme:
[](https://docsforagents.com/reports/tiledb-docs-ai-agent-readiness/) Method note
This is a reading test of public documentation, not an execution test. No accounts were created and no API calls were run. The AI Agent Readiness Score counts fifteen reading votes at PASS 2, PARTIAL 1, and FAIL 0, for 30 possible points. Five agent surface checks add 10 points each. The total is 80. Consensus chips show each row majority and do not affect scoring. The panel split on 3 of five tasks. Quotes shown here were re-fetched and confirmed verbatim on 2026-08-19.
Put another docs site through the battery.
Nominate a docs site