Bailian CLI command reference for knowledge bases, documents, chunks, and retrieval/Q&A services.
Invoke the full Bailian knowledge-base surface from the terminal: retrieval/Q&A service calls, knowledge base lifecycle management, document and chunk management, and category/collection management.
See the RAG docs for feature-page usage.
A data-center file is the raw asset; once imported into a knowledge base it becomes a document. Deleting a file and deleting a document are independent operations.
Categories organize data-center files by business domain. Collections define where files are stored — platform-managed storage by default, or a custom OSS bucket.
A service (agent) is the entry point for
Knowledge-base capabilities are currently available only to China site (aliyun.com) accounts.
Retrieval and Q&A
search and chat call a published retrieval/Q&A service via --agent-id; the actual retrieval strategy (multi-index recall, ranking, reranking, etc.) is driven by the service's server-side configuration.
| Capability | Command | Notes | Common options |
|---|---|---|---|
| Semantic search | bl knowledge search | Call a retrieval service for semantic search | --query, --agent-id retrieval service ID |
| RAG Q&A | bl knowledge chat | Call a Q&A service for RAG Q&A, with streaming output | --message, --agent-id Q&A service ID |
| Direct retrieval (deprecated) | bl knowledge retrieve | Retrieve directly from a knowledge base; prefer search | --index-id knowledge base ID, --query |
Knowledge base management
| Capability | Command | Notes |
|---|---|---|
| Create knowledge base | bl knowledge create | Create a knowledge base and import data-center files or categories |
| List knowledge bases | bl knowledge list | List knowledge bases in the workspace |
| Knowledge base details | bl knowledge info | Show a knowledge base's indexing configuration |
| Update knowledge base | bl knowledge update | Update a knowledge base's name, description, or rerank threshold |
| Delete knowledge base | bl knowledge delete | Delete a knowledge base with all its documents and chunks (data-center files are unaffected) |
| Usage stats | bl knowledge stats | View a knowledge base's storage and QPS monitoring data |
Document and file management
A data-center file is the raw asset; once imported into a knowledge base it becomes a document. Deleting a file and deleting a document are independent operations.
| Capability | Command | Notes |
|---|---|---|
| Upload document | bl knowledge doc upload | Upload local files or directories to the data center, optionally importing into a knowledge base |
| OSS batch import | bl knowledge doc import-oss | Batch-import files from an authorized OSS bucket into the data center |
| List documents | bl knowledge doc list | View parse/index status of documents in a knowledge base |
| Import job status | bl knowledge doc status | Check a knowledge base import job's status |
| Tag documents | bl knowledge doc tag | Batch-update tags on data-center files |
| Delete document | bl knowledge doc delete | Delete documents and their chunks from a knowledge base |
| File details | bl knowledge file get | Show a data-center file's details (size, MD5, tags, timestamps) |
| List files | bl knowledge file list | List files in a data-center category |
| Delete file | bl knowledge file delete | Permanently delete a data-center file |
Chunk management
| Capability | Command | Notes |
|---|---|---|
| Add chunk | bl knowledge chunk add | Add a chunk directly to a knowledge base |
| List chunks | bl knowledge chunk list | List chunks in a knowledge base with content and status |
| Update chunk | bl knowledge chunk update | Update chunk content, or toggle its retrieval visibility |
| Delete chunk | bl knowledge chunk delete | Delete chunks from a knowledge base (irreversible) |
Category and collection management
Categories organize data-center files by business domain. Collections define where files are stored — platform-managed storage by default, or a custom OSS bucket.
| Capability | Command | Notes |
|---|---|---|
| Add category | bl knowledge category add | Create a data-center category, optionally as a sub-category |
| List categories | bl knowledge category list | List data-center categories |
| Delete category | bl knowledge category delete | Delete a data-center category |
| Create collection | bl knowledge collection create | Create a FILE data collection (managed storage, or a custom OSS bucket) |
| Collection details | bl knowledge collection get | Show a data collection's details |
Retrieval/Q&A service management
A service (agent) is the entry point for search and chat: create a service, bind a knowledge base, verify against the beta draft, then deploy to publish.
| Capability | Command | Notes |
|---|---|---|
| Create service | bl knowledge service create | Create a retrieval/Q&A service (initial status: draft/beta) |
| List services | bl knowledge service list | List retrieval/Q&A services in the workspace |
| Service details | bl knowledge service get | Show service details and per-version configuration |
| Update service | bl knowledge service update | Update service name, description, or the draft's model/parameter configuration |
| Deploy service | bl knowledge service deploy | Publish the beta draft as a new published version |
| Copy service | bl knowledge service copy | Copy a service into a new draft |
| Delete service | bl knowledge service delete | Delete a retrieval/Q&A service (soft delete) |