Back to Details

bailian-managed-agent

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Bailian managed agent IaC (
bl managed-agent
)

百炼托管Agent IaC（
bl managed-agent
）

CRITICAL — Before executing, MUST read the shared protocol in 
../bailian-protocol/SKILL.md
: Version & updates (pre-flight checklist) and CLI errors: report an issue. Command details are authoritative in 
reference/managed-agent.md
 and 
bl managed-agent --help
— do not guess flags. If that protocol file is missing, stop and run 
npx skills add modelstudioai/cli --all -g
; do not guess auth/consent.
重要提示 — 执行前必须阅读
../bailian-protocol/SKILL.md
中的共享协议：版本与更新（执行前检查清单）以及CLI错误：提交问题。命令详情以
reference/managed-agent.md
和
bl managed-agent --help
为准——请勿猜测参数。若该协议文件缺失，请停止操作并执行
npx skills add modelstudioai/cli --all -g
；请勿猜测认证/授权方式。

Safety guardrail (the most important rule)

安全防护规则（最重要的规则）

apply
/ 
destroy
mutate remote resources and only execute when 
--yes
is passed:
  1. Always run 
    bl managed-agent plan
    first and show the diff to the user.
  2. Only after explicit user confirmation, retry 
    apply
    / 
    destroy
    with 
    --yes
    .
  3. Never add 
    --yes
    on your own initiative before the user has confirmed.
apply
/
destroy
会修改远端资源，仅在携带
--yes
参数时才会执行：
  1. 始终先执行
    bl managed-agent plan
    并向用户展示变更差异。
  2. 仅在用户明确确认后，重新执行带
    --yes
    参数的
    apply
    /
    destroy
    。
  3. 在用户确认前，切勿主动添加
    --yes
    参数。

IaC lifecycle

IaC生命周期

1. Init      bl managed-agent init          # scaffold agents.yaml
2. Validate  bl managed-agent validate      # offline, no network calls
3. Preview   bl managed-agent plan          # show the pending change diff
4. Apply     bl managed-agent apply --yes   # only after user confirmation
5. Destroy   bl managed-agent destroy --yes # only after user confirmation
1. 初始化      bl managed-agent init          # 生成agents.yaml脚手架
2. 校验        bl managed-agent validate      # 离线操作，无需网络调用
3. 预览        bl managed-agent plan          # 展示待执行的变更差异
4. 应用变更    bl managed-agent apply --yes   # 仅在用户确认后执行
5. 销毁资源    bl managed-agent destroy --yes # 仅在用户确认后执行

Session interaction (chat with a deployed managed agent)

会话交互（与已部署的托管Agent对话）

IntentCommand
Create + send + stream in one step
bl managed-agent session run
Send a message to an existing session
bl managed-agent session send
Create / inspect / list sessions
bl managed-agent session create
/ 
get
/ 
list
List session event history
bl managed-agent session events
Delete a session
bl managed-agent session delete
意图命令
一步完成创建、发送消息与流式响应
bl managed-agent session run
向现有会话发送消息
bl managed-agent session send
创建/查看/列出会话
bl managed-agent session create
/ 
get
/ 
list
列出会话事件历史
bl managed-agent session events
删除会话
bl managed-agent session delete

Local state management

本地状态管理

IntentCommand
Inspect tracked resources
bl managed-agent state list
/ 
show
Adopt an existing remote resource to state
bl managed-agent state import
Untrack only (do not destroy remotely)
bl managed-agent state rm
  • Always make the difference clear to the user: 
    state rm
    only edits the local state file, while 
    destroy
    deletes the remote resource.
Flags, usage, and examples: see 
reference/
 or 
bl <command> --help
— do not guess flags.
意图命令
查看已跟踪的资源
bl managed-agent state list
/ 
show
将现有远端资源纳入本地状态跟踪
bl managed-agent state import
取消跟踪（不销毁远端资源）
bl managed-agent state rm
  • 务必向用户明确区分：
    state rm
    仅编辑本地状态文件，而
    destroy
    会删除远端资源。
参数、用法及示例：请查看
reference/
或
bl <command> --help
——请勿猜测参数。

Common hand-offs

常见转接说明

软 hand-off（按 skill 名；已安装则 Read，否则 
--help
/ 提示 
npx skills add modelstudioai/cli --all -g
）：
  • Call an already published Bailian app/assistant → 
    bailian-app-call
    , or skill 
    bailian-cli
    (
    bl app list
    / 
    call
    ; fallback: 
    bl app --help
    ).
  • Choosing the model referenced in agents.yaml → 
    bailian-model-recommend
    .
  • Deployment quota / billing questions → skill 
    bailian-cli
    (fallback: 
    bl quota
    / 
    bl usage --help
    ).
软转接（按Skill名称；若已安装则读取相关内容，否则执行
--help
或提示用户执行
npx skills add modelstudioai/cli --all -g
）：
  • 调用已发布的百炼应用/智能体 → 使用
    bailian-app-call
    ，或Skill 
    bailian-cli
    （
    bl app list
    /
    call
    ；备选方案：
    bl app --help
    ）。
  • 选择agents.yaml中引用的模型 → 使用
    bailian-model-recommend
    。
  • 部署配额/计费相关问题 → 使用Skill 
    bailian-cli
    （备选方案：
    bl quota
    /
    bl usage --help
    ）。

references

参考资料

  • bailian-protocol — shared protocol (install via 
    --all -g
    )
  • reference/ — command details
  • bailian-protocol — 共享协议（通过
    --all -g
    安装）
  • reference/ — 命令详情