query-builder

Construct Vespa YQL queries and rank profiles for search and ranking.

14|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/vespaai-playground/skills --skill query-builder-vespaai-playground
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: query-builder
Source: https://github.com/vespaai-playground/skills/tree/main/query-builder
Command: npx skills add https://github.com/vespaai-playground/skills --skill query-builder-vespaai-playground

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Construct Vespa YQL queries and rank profiles to enable advanced search and ranking.

Core Features & Use Cases

  • YQL syntax and operators for text matching, grouping, and ranking
  • Support for tensor inputs and ML model integration in rank profiles
  • Examples and quick-start guidance for common search scenarios (e.g., ANN, predicate filters, time-based grouping)

Quick Start

Create a basic YQL query to retrieve all articles and order by a rank score.

Frequently Asked Questions about query-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write Vespa YQL queries for text matching and ranking?

Vespa YQL queries use a SQL-like syntax with operators for text matching, grouping, and ranking. You construct queries by combining selection operators with rank profiles to retrieve and order documents by relevance scores.

What is a Vespa rank profile and how does it work with ML models?

A Vespa rank profile defines scoring expressions that evaluate document relevance during ranking. Rank profiles support tensor inputs and ML model integration, enabling dynamic ranking calculations based on query-time features and document attributes.

Can I use nearestNeighbor search and tensor inputs in YQL?

Yes, Vespa YQL supports the nearestNeighbor operator for approximate nearest neighbor search and accepts query tensors as inputs. These integration points allow you to perform vector similarity searches within the YQL query structure.

How do I add predicate filters and time-based grouping to a Vespa query?

Vespa YQL supports predicate filters through its operator set and time-based grouping through the grouping syntax. You combine these features within a single query to filter results and aggregate documents by time intervals.

What's the best way to control query timing in Vespa YQL?

Vespa YQL provides query timing controls that let you manage execution deadlines and timeouts within your search requests. These controls ensure queries return results within specified time constraints for responsive applications.

Does Vespa YQL support the full operator set for advanced search scenarios?

Yes, Vespa YQL supports the full YQL operator set, including userQuery integration, grouping syntax, and tensor-based inputs. This enables complex search scenarios combining text matching, filtering, and ML-driven dynamic ranking.