Aliyun Model Studio CLI (bl)

CRITICAL — Before executing, MUST read the shared protocol in ../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):

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 (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 — 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 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 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.

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 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/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 (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 (routing: default bl search web model mode for every identity; explicit --mode mcp for regular keys; 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.