Skip to content
GitLab

akili discovery

Discover data products across the platform. These commands help you find products by keyword search with filters, ask natural language questions that are translated to SQL, and explore products through random sampling.

Full-text search for data products with optional filters.

Arguments:

ArgumentTypeRequiredDescription
querystringyesSearch query text

Flags:

FlagShortDefaultDescription
--namespaceFilter results by namespace
--domainFilter results by domain
--min-qualityMinimum quality score (0-100)

Examples:

Terminal window
# Search for products
akili discovery search "order summary"
# Search with namespace filter
akili discovery search "revenue" --namespace finance
# Search with quality filter
akili discovery search "orders" --min-quality 80
# Combined filters
akili discovery search "daily" --namespace sales --domain commerce --min-quality 90
# As JSON
akili discovery search "orders" --json

Ask a natural language question that is translated to SQL and executed against the product metadata. Returns the generated SQL, row count, and results.

Arguments:

ArgumentTypeRequiredDescription
questionstringyesQuestion in plain English

Examples:

Terminal window
# Ask a natural language question
akili discovery query "Which products had the most failures last week?"
# As JSON for programmatic access
akili discovery query "How many products are in the finance namespace?" --json

Get a random sample of products from the platform. Useful for exploration and onboarding.

Flags:

FlagShortDefaultDescription
--limit5Number of products to return

Examples:

Terminal window
# Get 5 random products (default)
akili discovery sample
# Get 10 random products
akili discovery sample --limit 10
# As JSON
akili discovery sample --json