Skip to content
Skills Library
AI & agents · Tool integration

bailian-cli

/bailian-cli

阿里云百炼 / Aliyun Bailian / DashScope 资源管理与 `bl` CLI hub: 应用调用(bl app)、决策模型推理(bl decision)、模型目录/模型列表、用量/额度/配额、免费额度、 工作空间、MCP 市场、pipeline、文件上传、Batch 批量推理与 CSV 转换、同步 Batch Chat、console API、登录鉴权与配置、 Agent skill 安装/列表/更新/卸载(bl skill add|list|update|remove,百炼 skill registry)。 用户点名百炼 / DashScope / `bl`,或继续既有 `bl` 工作流时直接使用。 共享协议(consent / 版本预检 / 鉴权 / 错误上报)在 bailian-protocol;官方安装 `bl skill init`。 家族路由:生图/生视频/配音/语音合成/转写 → bailian-gen;精调/微调/训练/训练数据集 → bailian-finetune; agents.yaml 托管 Agent → bailian-managed-agent;Sandbox 实例与模版 → bailian-sandbox; 个人长期记忆与应用记忆资源 → bailian-memory;个人历史资料辅助任务、资料接入与知识库管理 → bailia

Repository
cli ↗
Licence
Apache-2.0
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
29
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

阿里云百炼 / Aliyun Bailian / DashScope 资源管理与 `bl` CLI hub: 应用调用(bl app)、决策模型推理(bl decision)、模型目录/模型列表、用量/额度/配额、免费额度、 工作空间、MCP 市场、pipeline、文件上传、Batch 批量推理与 CSV 转换、同步 Batch Chat、console API、登录鉴权与配置、 Agent skill 安装/列表/更新/卸载(bl skill add|list|update|remove,百炼 skill registry)。 用户点名百炼 / DashScope / `bl`,或继续既有 `bl` 工作流时直接使用。 共享协议(consent / 版本预检 / 鉴权 / 错误上报)在 bailian-protocol;官方安装 `bl skill init`。 家族路由:生图/生视频/配音/语音合成/转写 → bailian-gen;精调/微调/训练/训练数据集 → bailian-finetune; agents.yaml 托管 Agent → bailian-managed-agent;Sandbox 实例与模版 → bailian-sandbox; 个人长期记忆与应用记忆资源 → bailian-memory;个人历史资料辅助任务、资料接入与知识库管理 → bailia

Original author description

阿里云百炼 / Aliyun Bailian / DashScope 资源管理与 `bl` CLI hub: 应用调用(bl app)、决策模型推理(bl decision)、模型目录/模型列表、用量/额度/配额、免费额度、 工作空间、MCP 市场、pipeline、文件上传、Batch 批量推理与 CSV 转换、同步 Batch Chat、console API、登录鉴权与配置、 Agent skill 安装/列表/更新/卸载(bl skill add|list|update|remove,百炼 skill registry)。 用户点名百炼 / DashScope / `bl`,或继续既有 `bl` 工作流时直接使用。 共享协议(consent / 版本预检 / 鉴权 / 错误上报)在 bailian-protocol;官方安装 `bl skill init`。 家族路由:生图/生视频/配音/语音合成/转写 → bailian-gen;精调/微调/训练/训练数据集 → bailian-finetune; agents.yaml 托管 Agent → bailian-managed-agent;Sandbox 实例与模版 → bailian-sandbox; 个人长期记忆与应用记忆资源 → bailian-memory;个人历史资料辅助任务、资料接入与知识库管理 → bailia

How it works

  1. Command reference (authoritative)
  2. When to use which command
  3. Quick examples
  4. Agent workflows
  5. Routing reminders
Original SKILL.md headings · 140 lines, 1,846 words
SKILL.md preview
---
name: bailian-cli
metadata:
  version: "2.6.1"
  requires:
    bins: ["bl"]
description: >-
  阿里云百炼 / Aliyun Bailian / DashScope 资源管理与 `bl` CLI hub:
  应用调用(bl app)、决策模型推理(bl decision)、模型目录/模型列表、用量/额度/配额、免费额度、
  工作空间、MCP 市场、pipeline、文件上传、Batch 批量推理与 CSV 转换、同步 Batch Chat、console API、登录鉴权与配置、
  Agent skill 安装/列表/更新/卸载(bl skill add|list|update|remove,百炼 skill registry)。
  用户点名百炼 / DashScope / `bl`,或继续既有 `bl` 工作流时直接使用。
  共享协议(consent / 版本预检 / 鉴权 / 错误上报)在 bailian-protocol;官方安装 `bl skill init`。
  家族路由:生图/生视频/配音/语音合成/转写 → bailian-gen;精调/微调/训练/训练数据集 → bailian-finetune;
  agents.yaml 托管 Agent → bailian-managed-agent;Sandbox 实例与模版 → bailian-sandbox;
  个人长期记忆与应用记忆资源 → bailian-memory;个人历史资料辅助任务、资料接入与知识库管理 → bailian-knowledge;
  联网搜索的模型路由(Token Plan 自带搜索 vs MCP 搜索 + 兜底)→ bailian-web-search。
  不要用于普通问答、编程、写作、翻译、摘要、泛搜索,或图片理解等宿主自己能做的任务(普通问答、编程、写作、翻译、摘要、泛搜索不触发)。
  未命名用量/额度问题:先问用户使用哪个产品,再运行 `bl usage` / `bl quota` 查询。
---

# 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), Call attribution (every Agent `bl` command), 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.**

**Call attribution:** Examples below and in `reference/` stay bare `bl …`. When running a command, wrap it with [`bailian-protocol` → Call attribution](../bailian-protocol/SKILL.md#call-attribution-mandatory-for-every-agent-bl-command) (bash or PowerShell). One sample for this skill (`BAILIAN_SKILL_NAME=bailian-cli`; replace `codex` with this host):

```bash
BAILIAN_CALLER_TYPE=agent BAILIAN_CALLER_NAME=codex BAILIAN_SKILL_NAME=bailian-cli BAILIAN_SKILL_VERSION=2.5.0 bl text chat --message "Write a poem about spring"
```

> **Family hub** — This skill owns Bailian resource commands and the hub `reference/` (apps, 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-sandbox` (Sandbox lifecycle) · `bailian-web-search` (web search routing) · `bailian-knowledge` (personal documents in everyday tasks and knowledge workflows).
> Tasks that need the user’s own historical documents belong to `bailian-knowledge`; ordinary writing does not itself select a cloud provider.
> 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/<group>.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-sandbox` → `sandbox` (fallback: `bl sandbox --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/<group>.md` for **Usage**, **Flags**, and **Examples**.
3. Run `bl <command> --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 / Sandbox, soft hand-off to the domain skill.

| User intent                                         | Command                                                                                                        | Notes                                                                                                                              |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Explicit Bailian model chat / text execution        | `bl text chat`                                                                                                 | Default `qwen3.8-max`                                                                                                              |
| 百炼异步文件批量推理 / CSV 转换                     | `bl batch convert` / `create` / `list` / `get` / `cancel` / `download`                                         | CSV → JSONL → 异步任务 → 原始结果,可额外导出 CSV;格式样例见 `reference/batch.md`                                                 |
| 百炼单次同步 Batch Chat                             | `bl text chat --batch`                                                                                         | 等待单次响应,不创建任务 ID;messages-file 是同一请求的对话上下文,边界见 `reference/text.md`                                      |
| Typed decision model inference                      | `bl decision`                                                                                                  | Workspace endpoint; returns `choice` / `noul` / `score` values and probabilities, not generated text                               |
| Bailian agent / workflow                            | `bl app call`                                                                                                  | Needs `--app-id`                                                                                                                   |
| Find app by name                                    | `bl app list` then `bl app call`                                                                               | Console auth                                                                                                                       |
| Personal memory / Bailian memory resources          | → skill `bailian-memory`                                                                                       | User-enabled personal memory; explicit resource operations use `bl memory --help` as fallback.                                     |
| Personal documents / Bailian knowledge workflows    | Read skill `bailian-knowledge`                                                                                 | If missing: `bl knowledge --help` or `bl skill init`                                                                               |
| 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`                                                                                                | No auth (public catalog); `--model <family>` for detail, `--enrich` for input params                                               |
| Find a model by keyword / modality                  | `bl model search`                                                                                              | Weighted ranking; `--input-modality` / `--output-modality`; offline models hidden by default                                       |
| SDK sample code for calling a model                 | `bl model code`                                                                                                | `--sdk openai\|dashscope`, `--lang`; text output is the snippet alone, safe to redirect                                            |
| 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`                                                                               | —                                                                                                                                  |
| Register or remove a Bailian MCP in an Agent        | `bl mcp connect` / `disconnect`                                                                                | Codex, Claude Code, Cursor, Qoder, Qoder Work, QwenWork, Qwen Code, Gemini, OpenCode, OpenClaw, DeepSeek Harness, ZCode, WorkBuddy |
| 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                                                                         |
| Token Plan harness entitlement quota                | `bl token-plan harness-quota`                                                                                  | Console auth; issued quota usage + still-issuing harnesses                                                                         |
| Bailian Coding Plan quota usage                     | `bl usage coding-plan`                                                                                         | Console auth; class 2 — ask which product first if unnamed                                                                         |
| Model monitoring (calls, latency, errors, delivery) | `bl monitor overview` / `models` / `metrics` / `errors` / `delivery *`                                         | Console auth; see [`reference/monitor.md`](reference/monitor.md)                                                                   |
| Model call logs / traces                            | `bl log audit *` / `bl log inference *` / `bl log status` / `bl log trace *`                                   | Console auth; audit and inference logs have separate APIs and switches; see [`reference/log.md`](reference/log.md)                 |
| Model alert rules / templates / history             | `bl alert list` / `create` / `update` / `delete` / `enable` / `disable` / `history` / `metrics` / `template *` | Console auth; contacts are managed in the CloudMonitor console; see [`reference/alert.md`](reference/alert.md)                     |
| 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`                                                                           |
| Training 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`                                                   |
| Bailian Sandbox instance / template lifecycle       | → skill `bailian-sandbox`                                                                                      | Fallback: `bl sandbox --help`                                                                                                      |
| 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 <command> --help` — do not guess flags. Domain command details live in the owning skill's `reference/`. Examples in `reference/` stay bare; wrap with Call attribution when running.

---

## Quick examples

```bash
bl text chat --message "Write a poem about spring in Chinese"
bl decision --workspace-id <id> --state "Is this requesting a refund?" --questions '{"refund":{"type":"noul"}}'
bl app list --output json
bl app call --app-id <code> --prompt "Hello"
bl usage stats
bl model list --model qwen
```

More examples per command: see `reference/<group>.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 <keyword> --output json`
2. Pick `code` (app ID); handle `user_prompt_params` via `--biz-params '{"key":"value"}'`
3. `bl app call --app-id <code> --prompt "..."`

### Batch 文件工作流

1. 文件推理统一使用异步任务。读取 `reference/batch.md` 的数据样例;CSV 用 `bl batch convert` 构造,已有标准 Batch JSONL 可直接使用。
2. `batch create --dry-run` 完整校验;确认模型、数据上传和费用后创建任务。create 上传/提交后返回任务 ID,不等待完成。
3. 用返回的 ID 执行 `batch get --follow` 等待终态,再 `batch download --csv` 下载。Ctrl-C 仅结束本地等待;JSONL 为保真产物,CSV 为有损展示。下载部分失败保留原文件,确认目标后按提示用 `--force` 恢复。

单次同步推理使用 `text chat --batch`,通过 message 或 messages-file 提供同一请求的对话上下文,不用于独立请求文件;命令等待该次响应,不创建任务 ID。Batch 不适用于 Token Plan;显式 Batch/自定义代理使用现有解析凭证,不推断 Key 类型。端点、请求超时及互斥参数见 `reference/text.md`。

### Command metadata for agents

Use the owning skill's [`reference/index.md`](reference/index.md) (or sibling skill reference trees), the matching `reference/<group>.md`,
and `bl <command> --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.
- Personal recall, new long-term personal facts, and "remember this" requests → read `bailian-memory` if installed to check enablement, including first-use onboarding. Once enabled, use it for authorized personal recall/extraction; installation alone does not authorize cloud uploads. If unavailable or declined, respect the user’s host-memory choice. Explicit Bailian memory resource operations also route to `bailian-memory`.
- `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.
- For `risk: high` commands or `requires_confirmation`, follow the shared protocol; never add `--yes` automatically.
- `bl managed-agent apply` / `destroy` have an additional domain rule: run `plan` first and show the diff before asking for confirmation.
- When a matched `bl` command accepts a file URL, pass local paths directly; never require the user to host the file first.
- Console login → use `bl auth login --console` for China; add `--console-site international` for the international site. It may create an ordinary API Key. Token Plan and other subscription plans must use `bl auth login --api-key <key>`. See [`../bailian-protocol/assets/setup.md`](../bailian-protocol/assets/setup.md#authentication).
Files in this package (29)
  • README.md 1 KB
  • README.zh.md 1 KB
  • SKILL.md 20 KB
  • reference/advisor.md 3 KB
  • reference/agents.md 7 KB
  • reference/alert.md 32 KB
  • reference/app.md 4 KB
  • reference/auth.md 9 KB
  • reference/batch.md 17 KB
  • reference/config.md 9 KB
  • reference/console.md 2 KB
  • reference/decision.md 5 KB
  • reference/file.md 2 KB
  • reference/index.md 31 KB
  • reference/log.md 33 KB
  • reference/mcp.md 13 KB
  • reference/model.md 10 KB
  • reference/monitor.md 20 KB
  • reference/permission.md 9 KB
  • reference/pipeline.md 3 KB
  • reference/plugin.md 4 KB
  • reference/quota.md 9 KB
  • reference/search.md 2 KB
  • reference/skill.md 6 KB
  • reference/text.md 5 KB
  • reference/token-plan.md 12 KB
  • reference/update.md 1 KB
  • reference/usage.md 11 KB
  • reference/workspace.md 3 KB

Versions

The database has no other skills named bailian-cli.

Database snapshot: 13.11.2026 · package version 1e64bddae40c (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100bailian-protocol
    阿里云百炼 `bl` 家族共享执行协议(consent 确认、版本预检、鉴权/安装、错误上报、本地文件与输出约定)。 不是面向用户意图的业务入口;当任一 bailian-* 业务 skill(bailian-cli / bailian-gen / bailian-finetune / bailian-managed-agent / bailian-sandbox / bailian-memory / bailian-knowledge / bailian-web-search)执行前需要公共上下文,或用户首次安装/鉴权/`bl` 报错需上报时读取本…
  • 100bailian-sandbox
    阿里云百炼 Sandbox 沙箱实例与模版生命周期管理入口:用户要创建、查询、连接、暂停、恢复或释放百炼沙箱, 或查看内置基础镜像、上传模版挂载文件、创建、更新、查询、删除沙箱模版、查看模版构建状态时,使用 `bl sandbox`。 用户要访问已创建实例、打开 WebShell、连接 browser-use 浏览器自动化或 VNC 实时画面时,先获取连接信息,再连接数据面。 不用于宿主执行沙箱设置、E2B 官方云资源或通用文件传输。 agents.yaml 托管 Agent / Session / Environment 管理交给…
  • 100bailian-web-search
    阿里云百炼联网搜索(web search)入口:为联网搜索 / 网页搜索 / 查最新资讯做路径分发。 先识别当前连接身份:Token Plan(profile `token-plan` 或 base_url host 为 `token-plan.<region>.maas.aliyuncs.com`)→ 模型自带搜索 (`bl text chat --api responses --tool '{"type":"web_search"}'`);其他 / 默认 → Bailian MCP(`bl search web`);仅在 MCP…
  • 100dashscope
    DashScope (Alibaba Cloud Bailian / 阿里云百炼) integration — image generation (qwen-image-2.0-pro), text-to-speech (qwen3-tts-flash), and ASR with word-level timestamps (qwen3-asr-flash-filetrans). Use when generating images via Qwen-Image, narrating via Qwen-TTS, or transcribing…
  • 100dashscope
    DashScope (Alibaba Cloud Bailian / 阿里云百炼) integration — image generation (qwen-image-2.0-pro), text-to-speech (qwen3-tts-flash), and ASR with word-level timestamps (qwen3-asr-flash-filetrans). Use when generating images via Qwen-Image, narrating via Qwen-TTS, or transcribing…
  • 100dashscope
    DashScope (Alibaba Cloud Bailian / 阿里云百炼) integration — image generation (qwen-image-2.0-pro), text-to-speech (qwen3-tts-flash), and ASR with word-level timestamps (qwen3-asr-flash-filetrans). Use when generating images via Qwen-Image, narrating via Qwen-TTS, or transcribing…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.