searchcli-volcengine-ai-search

Configure Volcengine AI Search datasets, applications, and retrieval workflows via CLI.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/devtools-skills --skill searchcli-volcengine-ai-search-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: searchcli-volcengine-ai-search
Source: https://github.com/reason-machines/devtools-skills/tree/main/skills/searchcli-volcengine-ai-search
Command: npx skills add https://github.com/reason-machines/devtools-skills --skill searchcli-volcengine-ai-search-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Integrating AI-powered search, recommendation, and conversational retrieval into applications requires managing datasets, schemas, and search applications across Volcengine services, which involves many manual configuration steps and error-prone API calls. ## Core Features & Use Cases - Item & Dataset Onboarding: Profile JSON data, generate provisioning plans, and create datasets and search applications with dry-run previews and confirmation gates. - Search, Recommendation & Chat: Run item search, user-based recommendations, and RAG-style conversational retrieval against configured applications. - Automated Search Tuning: Generate evaluation queries, run text-similarity evaluations, and produce relevance reports using LLM-based judging. - Use Case: An engineer building product search for an e-commerce catalog profiles a products.json file, applies a provisioning plan with runtime trials, then tunes ranking weights using generated evaluation queries. ## Quick Start Ask the agent to install SearchCLI, authenticate with Volcengine credentials, and onboard a local items.json file into a new search application.

Frequently Asked Questions about searchcli-volcengine-ai-search

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

FAQPage Schema
How do I set up Volcengine AI Search with SearchCLI?▼

Clone the SearchCLI repository, run the install script, then authenticate with vs auth login or import VIKING_AK and VIKING_SK environment variables using vs auth import-env. Verify setup with vs doctor --json.

How to onboard item data into a Volcengine search application?▼

Profile your JSON data with vs item profile, generate a plan with vs item plan, review it using vs item apply --dry-run, then execute with --confirm-review and --wait-ready flags for verified provisioning.

Does SearchCLI support video dataset provisioning?▼

Yes, but you must pass --type video explicitly to item profile and plan commands. Use a full dataset-create.json payload with DataFieldConfig instead of schema-only creation to avoid MissingParameter.DefaultFieldStrategy errors.

Why does dataset creation fail with MissingParameter.DefaultFieldStrategy?▼

This error occurs when creating video datasets with only a schema file. Use the dataset-create.json artifact from the plan, which includes both Schema and DataFieldConfig with default field mappings.

How do I tune search quality with SearchCLI?▼

Configure an LLM with vs llm login, generate evaluation queries with vs search tune query-generate, create a tuning plan, run the evaluation, and produce a report with vs search tune report.

What are the requirements for running SearchCLI?▼

SearchCLI requires Node.js 20 or newer, Git, and Volcengine AK/SK credentials with AI Search access. LLM-based tuning additionally requires a base URL, API key, and model configuration.