用途：通过声明式基础设施（IaC）管理阿里云百炼托管 Agent 及其相关资源，并提供面向 API 的查询与运行时命令。执行前必须先阅读共享协议 ../bailian-protocol/SKILL.md；若缺失则停止并运行 bl skill init，不要猜测认证或授权。
主要能力：IaC 生命周期为 init（生成 agents.yaml）、validate（离线校验）、plan（预览变更差异）、apply --yes、destroy --yes。目录项目支持 project init/validate/build/publish、project workbench、playground --agent <id>，以及 project version enable/disable/status/list/preview/restore。单资源定向创建包括 agent、environment、skill、vault、vault credential、deployment create，均先构造 YAML 声明再走定向 Plan/Apply。API 类命令覆盖 agent/environment/skill/vault/deployment 的查询，session 的 create/get/list/send/run/events/archive/delete/debug/export，以及 file 的 upload/list/get/search/download/delete。
使用方式：apply、destroy 及单资源 create --yes 会改动远端持久资源，必须先运行 plan 并向用户展示差异，仅在用户明确确认后才加 --yes，不得自行添加。session archive|delete、file delete、deployment run|pause|unpause 也需先 --dry-run 再确认。凭据通过 --secret-env 传入变量名而非明文，YAML 只保存 ${VAR} 引用；Build 会把明文密钥移入项目根 .env，该文件不加密、不进入版本快照，需自行备份并加入 Git 忽略。
适用场景：需要以代码方式声明和管理百炼托管 Agent、Deployment、Skill、Vault、Environment，或与已部署 Agent 进行会话交互、查询运行历史时。
限制：公开 Managed Agents API 没有模型 Catalog 和 MCP OAuth Login，CLI 不注册对应命令；Cursor 为不透明字符串，只能回传 next_page；下载必须指定 --output-file，默认不覆盖；session export 仅导出诊断元数据。具体 flags 与示例以 reference/ 或命令 --help 为准，不要猜测。