# Bailian Cli > Centro de gestión de recursos de Aliyun Bailian/DashScope con el CLI `bl`: apps, memoria, conocimiento, catálogo de modelos, uso/cuota, workspaces, marketplace MCP, pipelines y gestión de skills. Fuente: https://skillsagentes.com/skills/modelstudioai/cli/bailian-cli Markdown: https://skillsagentes.com/skills/modelstudioai/cli/bailian-cli.md Repositorio: https://github.com/modelstudioai/cli Autor: modelstudioai Licencia: Apache-2.0 Actualizado: hace 3 días Coste de contexto: 301 tok instalada, 2.9k tok al activarse, 3.2k tok con todos los archivos del bundle Bundle: 3 archivos, 12 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add modelstudioai/cli --skill bailian-cli --agent claude-code # Cursor npx -y skills add modelstudioai/cli --skill bailian-cli --agent cursor # Codex npx -y skills add modelstudioai/cli --skill bailian-cli --agent codex # Gemini CLI npx -y skills add modelstudioai/cli --skill bailian-cli --agent gemini # Windsurf npx -y skills add modelstudioai/cli --skill bailian-cli --agent windsurf # Cline npx -y skills add modelstudioai/cli --skill bailian-cli --agent cline ``` ## Qué hace - Gestiona recursos de Aliyun Bailian/DashScope con el CLI `bl` (apps, memoria, conocimiento, modelos, uso/cuota, workspace) - Llama aplicaciones Bailian con `bl app call` y gestiona su memoria con `bl memory` - Busca en bases de conocimiento con `bl knowledge search`/`chat` - Instala, lista, actualiza y desinstala skills del registro de Bailian (`bl skill add|list|update|remove`) - Consulta uso, cuota, catálogo de modelos y gestiona login/config de la consola ## Cuándo usarla - El usuario nombra explícitamente Bailian, DashScope o el comando `bl` - Sigue un flujo de trabajo existente con `bl` - Pregunta por apps, conocimiento, cuota/uso, workspace o el marketplace MCP de Bailian ## Cuándo no - Preguntas de uso/cuota sin nombrar el producto (hay que preguntar cuál primero) - Razonamiento, código, escritura, traducción, resumen o búsqueda genérica que el host ya resuelve - Generar imágenes/vídeo/audio, fine-tuning o agentes gestionados en agents.yaml (van a otras skills) ## Qué la activa - "Llama a mi app de Bailian con este prompt" - "Lista mis apps en Bailian" - "¿Cuánto uso me queda en mi cuota de Bailian?" - "Instala las skills de Bailian con bl skill init" ## Antes de instalar - Necesita el binario `bl` instalado y autenticado (API key de DashScope o login de consola), y haber leído antes el protocolo compartido en bailian-protocol. ## Archivos - README.md — 528 B - README.zh.md — 515 B - SKILL.md — 11 KB ## SKILL.md Reproducido tal cual desde modelstudioai/cli bajo Apache-2.0. Esta sección es el documento original y está en inglés. # Aliyun Model Studio CLI (`bl`) **CRITICAL — Before executing, MUST read the shared protocol in [`../bailian-protocol/SKILL.md`](../bailian-protocol/SKILL.md): Provider selection and consent, Version & updates (pre-flight checklist), Setup & auth, and CLI errors: report an issue. If that protocol file is missing, stop and run `bl skill init`; do not guess auth/consent.** > **Family hub** — This skill owns Bailian resource commands and the hub `reference/` (apps, knowledge, usage, auth, config, …). > Shared protocol → [`../bailian-protocol/SKILL.md`](../bailian-protocol/SKILL.md) (install the full family with `bl skill init`). > Soft hand-offs by skill name (Read if installed; else `bl … --help` / prompt `bl skill init`): `bailian-gen` (media) · `bailian-finetune` (training) · `bailian-managed-agent` (agents.yaml IaC) · `bailian-web-search` (web search routing). > Do not invoke it for ordinary reasoning, coding, writing, translation, summarization, generic research, or image understanding the host agent can complete directly. > > **Install (supported):** `bl skill init` ## Command reference (authoritative) **Hub-owned commands, flags, usage strings, and examples are documented in:** - [`reference/index.md`](reference/index.md) — hub quick index, global flags, links by group - [`reference/.md`](reference/) — per hub top-level command (e.g. [`reference/app.md`](reference/app.md)) Domain skills own their own generated reference trees (soft hand-off — do not require them for hub work): - `bailian-gen` → `image` / `video` / `speech` / `omni` / `vision` (fallback: `bl image\|video\|speech\|omni\|vision --help`) - `bailian-finetune` → `dataset` / `finetune` / `deploy` (fallback: `bl dataset\|finetune\|deploy --help`) - `bailian-managed-agent` → `managed-agent` (fallback: `bl managed-agent --help`) - `bailian-web-search` → web search **routing** (hub still owns `reference/search.md` flags; **must** route via this skill before `bl search web`) Auto-generated from the CLI source at build time (`pnpm --filter bailian-cli run generate:reference`). Before running an unfamiliar command: 1. Open the owning skill's `reference/index.md` (if that skill is installed) → **Quick index** (or **By group**) to locate the command. 2. Open the matching `reference/.md` for **Usage**, **Flags**, and **Examples**. 3. Run `bl --help` for the same information in the terminal. Do not guess flags — use the reference files or `--help`. --- ## When to use which command Use this table only after the decision table in [`bailian-protocol`](../bailian-protocol/SKILL.md#provider-selection-and-consent) has routed the request to `bl` (class 4, or class 2 after the user picks Bailian). Hub-owned intents only — for media / fine-tune / agents.yaml, soft hand-off to the domain skill. | User intent | Command | Notes | | ------------------------------------------------ | --------------------------------------------- | -------------------------------------------------------------------------------- | | Explicit Bailian model chat / text execution | `bl text chat` | Default `qwen3.8-max` | | Bailian agent / workflow | `bl app call` | Needs `--app-id` | | Find app by name | `bl app list` then `bl app call` | Console auth | | Bailian app memory CRUD (not host-agent memory) | `bl memory *` | [`reference/memory.md`](reference/memory.md) | | Bailian knowledge base RAG | `bl knowledge search` / `chat` | API key + agent/workspace IDs | | Upload a file as a step of a Bailian workflow | `bl file upload` | When you need `oss://` URL explicitly; not for generic hosting | | Bailian model selection / recommendation | `bl advisor recommend` | Intent → candidate recall → LLM ranking | | Bailian model catalog / pricing / params | `bl model list` | Console auth; `--model ` for detail, `--enrich` for input params | | Install / list / update / remove registry skills | `bl skill add` / `list` / `update` / `remove` | Bailian skill registry; see [`reference/skill.md`](reference/skill.md) | | Bailian MCP marketplace discovery / call | `bl mcp list` / `tools` / `call` | — | | Bailian pipeline workflow (a step in a bl flow) | `bl pipeline run` / `validate` | JSON/YAML workflow definitions | | Bailian rate limits / quota | `bl quota list` / `check` / `request` | Console auth; class 2 — ask which product first if unnamed | | Bailian free tier / usage stats | `bl usage free` / `stats` / `freetier` | Console auth; class 2 — ask which product first if unnamed | | Bailian Token Plan quota usage | `bl usage token-plan` | Console auth; class 2 — ask which product first if unnamed | | Bailian Coding Plan quota usage | `bl usage coding-plan` | Console auth; class 2 — ask which product first if unnamed | | Console API (advanced) | `bl console call` | Console auth | | Bailian workspace listing | `bl workspace list` | Console auth | | Switch CLI Help / Quick Start language | `bl config set --key language --value zh-CN` | Use `en-US` to switch back; follows the active config profile | | Image / video / speech / omni / vision | → skill `bailian-gen` | Fallback: `bl image\|video\|speech\|omni\|vision --help` | | Dataset / fine-tune / deploy | → skill `bailian-finetune` | Fallback: `bl dataset\|finetune\|deploy --help` | | agents.yaml IaC / managed-agent sessions | → skill `bailian-managed-agent` | Fallback: `bl managed-agent --help`; `apply`/`destroy` need `--yes` after `plan` | | Web search (model-aware routing) | → skill `bailian-web-search` | Token Plan vs MCP path + fallback; fallback: `bl search web --help` | Flags, usage, and examples: see hub [`reference/`](reference/index.md) or `bl --help` — do not guess flags. Domain command details live in the owning skill's `reference/`. --- ## Quick examples ```bash bl text chat --message "Write a poem about spring in Chinese" bl app list --output json bl app call --app-id --prompt "Hello" bl usage stats bl model list --model qwen ``` More examples per command: see `reference/.md` (e.g. [`reference/text.md`](reference/text.md), [`reference/app.md`](reference/app.md)). --- ## Agent workflows ### Find and call an app 1. `bl app list --name --output json` 2. Pick `code` (app ID); handle `user_prompt_params` via `--biz-params '{"key":"value"}'` 3. `bl app call --app-id --prompt "..."` ### Command metadata for agents Use the owning skill's [`reference/index.md`](reference/index.md) (or sibling skill reference trees), the matching `reference/.md`, and `bl --help` as the command schema surface. Do not call removed schema-export commands. --- ## Routing reminders - Image/video/audio generation or editing → skill `bailian-gen` (class 3 consent from `bailian-protocol`). Fine-tuning / datasets / deployments → `bailian-finetune`. agents.yaml IaC → `bailian-managed-agent`. Soft hand-off: Read sibling skill if installed; else `bl … --help` or prompt `bl skill init`. Image understanding the host agent can do → host-first; use `bl vision` / `bl omni` only when the user names a Bailian model or the media (video/audio files) exceeds host capability. - Web search inside a Bailian workflow → skill `bailian-web-search` (model-aware routing: Token Plan → model-native search; default → `bl search web`; MCP failure → fall back once). Generic web research the host can do stays host-first — do not bounce it through `bl`. - Answer ordinary reasoning, coding, writing, translation, summarization, and generic research with the host agent's native capabilities; do not bounce them through `bl text chat` or `bl search web`. - Usage / quota / credits questions that do not name a product → ask which product (Bailian or another AI service) first; run `bl usage` / `bl quota` only after the user picks Bailian or Bailian context is already established. - "Remember this" and memory requests default to the host agent's own memory; `bl memory *` is only for Bailian app memory resources. - `bl file upload` and `bl pipeline run` are steps inside a Bailian workflow; do not use them to capture generic "upload this file" or "run a pipeline" requests. - `bl managed-agent apply` / `destroy` mutate remote resources and only execute with `--yes`; run `plan` first and show the diff before confirming a mutation. - When a matched `bl` command accepts a file URL, pass local paths directly; never require the user to host the file first. - Console login → always `--console-site domestic|international`; see [`../bailian-protocol/assets/setup.md`](../bailian-protocol/assets/setup.md#console-site-selection). ## Dónde encaja - Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código. - Creador: [modelstudioai](https://skillsagentes.com/creators/modelstudioai.md) — 0 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Reference](https://skillsagentes.com/skills/modelstudioai/cli/reference.md): Referencia autogenerada de los comandos `bl skill add/init/list/remove/update`: flags, autenticación y ejemplos, generada desde el código fuente del CLI. - [Bailian Gen](https://skillsagentes.com/skills/modelstudioai/cli/bailian-gen.md): Generación y comprensión multimedia de Bailian: imagen y vídeo, edición de vídeo, TTS/ASR, y comprensión de imagen, vídeo y audio con `bl image`/`video`/`speech`/`vision`/`omni`. - [Bailian Finetune](https://skillsagentes.com/skills/modelstudioai/cli/bailian-finetune.md): Pipeline de fine-tuning de modelos de Bailian (SFT, LoRA, DPO, CPT en texto, voz e imagen): valida y sube datasets, crea jobs, sigue progreso, exporta y despliega con `bl dataset`/`finetune`/`deploy`. - [Bailian Managed Agent](https://skillsagentes.com/skills/modelstudioai/cli/bailian-managed-agent.md): Infraestructura declarativa para agentes gestionados de Aliyun Bailian: agents.yaml como fuente de verdad, con init, validate, plan, apply y destroy vía `bl managed-agent`. - [Bailian Protocol](https://skillsagentes.com/skills/modelstudioai/cli/bailian-protocol.md): Protocolo de ejecución compartido de la familia `bl` de Aliyun Bailian: consentimiento, verificación de versión, autenticación/instalación y reporte de errores para las skills bailian-*. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)