Verwendung
- Installationsbefehl kopieren und das Quellpaket vor der Installation in der eigenen Agentenumgebung prüfen.
- Benötigte Werkzeuge, Zugangsdaten und Hosts im Original prüfen.
- Eingabe und gewünschtes Ergebnis beschreiben und die Ausgabe mit den Quellen abgleichen.
npx skills add https://github.com/modelstudioai/cli --skill bailian-cliVor dem Start
- Die Installation umfasst weder Modellabo noch API-Kontingent oder Dateizugriffsrechte.
- Sterne und Installationen zeigen Aktivität, keine unabhängige Qualitäts- oder Sicherheitsprüfung.
Aus dem Quell-Repository gerendert; Überschriften, Beispiele, Code, Tabellen, Links und Bilder bleiben erhalten.
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 (bash or PowerShell). One sample for this skill (BAILIAN_SKILL_NAME=bailian-cli; replace codex with this host). When copying commands into a reusable script / template / task definition, switch to the protocol `script` template (never keep `agent`); the sample below is for this-turn inline execution only. Strip attribution when handing a command to the user to paste.
BAILIAN_CALLER_TYPE=agent BAILIAN_CALLER_NAME=codex BAILIAN_SKILL_NAME=bailian-cli BAILIAN_SKILL_VERSION=<metadata.version> bl text chat --message "Write a poem about spring"Family hub — This skill owns Bailian resource commands and the hubreference/(apps, usage, auth, config, …). Shared protocol → `../bailian-protocol/SKILL.md` (install the full family withbl skill init). Soft hand-offs by skill name (Read if installed; elsebl … --help/ promptbl 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 tobailian-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` — hub quick index, global flags, links by group
- `reference/<group>.md` — per hub top-level command (e.g. `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 ownsreference/search.mdflags; must route via this skill beforebl search web)
Auto-generated from the CLI source at build time (pnpm --filter bailian-cli run generate:reference). Before running an unfamiliar command:
- Open the owning skill's
reference/index.md(if that skill is installed) → Quick index (or By group) to locate the command. - Open the matching
reference/<group>.mdfor Usage, Flags, and Examples. - Run
bl <command> --helpfor 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` 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 | ||||
| Explicit ParseX parsing / structured field extraction | bl parsex parse submit / result; bl parsex extract submit / result | Workspace + API key; submit returns biz_id, result --follow waits. HTTP(S) source URLs; extraction can reuse a parsed document. See reference/parsex.md. | ||||
| Bailian agent / workflow | bl flow-agent call | Needs --app-id | ||||
| Find app by name | bl flow-agent list then bl flow-agent call | Console auth; --type workflow lists workflows | ||||
| Create / update / publish / delete / copy an app | bl flow-agent create / update / publish / delete / copy / get / versions | Console auth; agent config via --model/--instructions/--config-json; delete needs --yes; see `reference/flow-agent.md` | ||||
| Workflow canvas read / save / publish / export | bl flow-agent workflow get / save / publish / export | Console auth; save replaces the whole draft canvas; see `reference/flow-agent.md` | ||||
| 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 | ||||
| Resolve a Console file key / error-report URL | bl file url | Console auth; use the returned business file key, not a file ID or upload URI. Resolves only; no download or fixed expiry. Existing URLs need no resolution. | ||||
| 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` | ||||
| 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` | ||||
| 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` | ||||
| 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` | ||||
| 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 (mode-aware routing) | → skill bailian-web-search | Default model mode vs explicit --mode mcp + fallback; fallback: bl search web --help |
Flags, usage, and examples: see hub `reference/` 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
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 flow-agent list --output json
bl flow-agent call --app-id <code> --prompt "Hello"
bl flow-agent create --name "My agent" --model qwen3-max
bl usage stats
bl model list --model qwenMore examples per command: see reference/<group>.md (e.g. `reference/text.md`, `reference/flow-agent.md`).
Agent workflows
Find and call an app
bl flow-agent list --name <keyword> --output json- Pick
code(app ID); handleuser_prompt_paramsvia--biz-params '{"key":"value"}' bl flow-agent call --app-id <code> --prompt "..."
Create and configure an app
bl flow-agent create --name <name> [--type workflow] --output json→ returnsapp_code- Agent:
bl flow-agent update --app-id <code> --model <model> --instructions "..."(reads the draft, merges, writes) bl flow-agent publish --app-id <code>to release;bl flow-agent get --app-id <code>to inspect- Workflow canvas:
bl flow-agent workflow get --app-id <code> --output-file canvas.json→ edit →bl flow-agent workflow save --app-id <code> --config-file canvas.json→bl flow-agent workflow publish --app-id <code>
bl app call/bl app listare deprecated aliases ofbl flow-agent call/bl flow-agent list; the rest of the app group moved toflow-agent.
Batch 文件工作流
- 文件推理统一使用异步任务。读取
reference/batch.md的数据样例;CSV 用bl batch convert构造,已有标准 Batch JSONL 可直接使用。 batch create --dry-run完整校验;确认模型、数据上传和费用后创建任务。create 上传/提交后返回任务 ID,不等待完成。- 用返回的 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` (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 frombailian-protocol). Fine-tuning / datasets / deployments →bailian-finetune. agents.yaml IaC →bailian-managed-agent. Soft hand-off: Read sibling skill if installed; elsebl … --helpor promptbl skill init. Image understanding the host agent can do → host-first; usebl vision/bl omnionly 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(routing: defaultbl search webmodel mode for every identity; explicit--mode mcpfor regular keys; MCP failure → fall back once). Generic web research the host can do stays host-first — do not bounce it throughbl. - Answer ordinary reasoning, coding, writing, translation, summarization, and generic research with the host agent's native capabilities; do not bounce them through
bl text chatorbl 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 quotaonly after the user picks Bailian or Bailian context is already established. - Personal recall, new long-term personal facts, and "remember this" requests → read
bailian-memoryif 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 tobailian-memory. bl file uploadandbl pipeline runare steps inside a Bailian workflow; do not use them to capture generic "upload this file" or "run a pipeline" requests.- For
risk: highcommands orrequires_confirmation, follow the shared protocol; never add--yesautomatically. bl managed-agent apply/destroyhave an additional domain rule: runplanfirst and show the diff before asking for confirmation.- When a matched
blcommand accepts a file URL, pass local paths directly; never require the user to host the file first. - Console login → use
bl auth login --consolefor China; add--console-site internationalfor the international site. It may create an ordinary API Key. Token Plan and other subscription plans must usebl auth login --api-key <key>. See `../bailian-protocol/assets/setup.md`.