CLI 命令行
combo-cli 是面向运维 / 管理员 / 数据工程师的命令行工具,覆盖管理台和 API 不太方便做的批量、脚本化、调试场景。
pip install combo-cli
# 或:从私有化交付包里
pip install /path/to/combo_cli-*.whl
combo-cli config init
# 交互式输入 base URL + API Key
配置文件默认在 ~/.combo/config.yaml。
combo-cli auth login # 登录
combo-cli auth whoami # 当前身份
combo-cli config show # 查看当前配置
combo-cli config set base-url ... # 改 base URL
combo-cli agent list
combo-cli agent create --name "代码审查" --scenario code-review
combo-cli agent show <agent_id>
combo-cli agent delete <agent_id>
combo-cli session list --agent <agent_id>
combo-cli session show <session_id>
combo-cli session archive <session_id>
combo-cli session export <session_id> -o session.json # 导出会话
combo-cli chat \
--session <session_id> \
--question "审查 https://gerrit.../c/12345"
# 流式
combo-cli chat --stream --session <session_id> --question "..."
# 从文件输入
combo-cli chat --session <session_id> --input-file question.md
combo-cli kb list
combo-cli kb create --name "ABZ 项目规范"
combo-cli kb show <kb_id>
# 批量导入
combo-cli doc upload --kb <kb_id> ./docs/*.pdf
combo-cli doc upload --kb <kb_id> --recursive ./docs/
combo-cli doc list --kb <kb_id>
# 解析进度
combo-cli doc wait --kb <kb_id>
# 重新解析
combo-cli doc reparse <doc_id> --parser patent
combo-cli skill list
combo-cli skill show <skill_id>
# 从 SKILL.md 发布自定义技能
combo-cli skill publish ./my-skill/
# 激活到 Session
combo-cli skill activate <skill_id> --session <session_id>
combo-cli cron list
combo-cli cron create --name "每日代码审查" \
--expr "0 9 * * *" \
--agent <agent_id> \
--prompt "审查昨天的所有 PR"
combo-cli cron delete <cron_id>
combo-cli trigger list
combo-cli trigger create --from ./trigger.yaml
combo-cli trigger test <trigger_id> --event-file ./event.json # 干跑
combo-cli tenant list
combo-cli tenant create --name "Corp A" --quota "tokens=10M/month"
combo-cli user list --tenant <tenant_id>
combo-cli user create --tenant <tenant_id> --email "alice@corp-a.com"
combo-cli user disable <user_id>
combo-cli credential list
combo-cli credential add \
--name "DNG-Production" \
--type oauth2 \
--config ./dng-config.yaml
combo-cli credential rotate <credential_id>
combo-cli credential revoke <credential_id>
combo-cli import requirements \
--kb <kb_id> \
--source req.csv \
--mapping req-mapping.yaml
req-mapping.yaml 示例:
columns:
id: "REQ_ID"
title: "Title"
description: "Description"
type: "Req_Type"
asil: "ASIL"
relations:
satisfies: "Satisfies" # 另一列指向父级 ID
combo-cli session export \
--tenant <tenant_id> \
--since "2026-01-01" \
--output-dir ./exports/
# 从租户 A 导出
combo-cli export --tenant <tenant_a> -o a-data/
# 导入到租户 B
combo-cli import --tenant <tenant_b> -i a-data/ --mapping-file map.yaml
combo-cli debug ledger <session_id>
# 输出:按 Round 打印每步 action / result / confidence
combo-cli debug replay <session_id> --from-round 5
combo-cli debug hooks <session_id>
combo-cli debug trace <trace_id> --format jaeger > trace.json
combo-cli health # 系统健康
combo-cli health --verbose # 详细(含依赖服务状态)
combo-cli stats usage --tenant <tenant_id> --last 7d
combo-cli stats cost --tenant <tenant_id> --breakdown model
combo-cli maintenance gc # 手动触发垃圾回收
combo-cli maintenance reindex --kb <kb_id>
所有命令都可以用环境变量替代参数:
export COMBO_BASE_URL=https://api.combo.example.com
export COMBO_API_KEY=ragflow-...
export COMBO_TENANT=t_corp_a
combo-cli agent list
combo-cli completion bash >> ~/.bashrc
combo-cli completion zsh >> ~/.zshrc
combo-cli completion fish > ~/.config/fish/completions/combo-cli.fish
Q:命令执行后提示权限不足?
A:检查当前身份(combo-cli auth whoami)的角色是否有该操作权限。管理员操作需要管理员身份。
Q:批量导入几万条失败一半?
A:加 --on-error continue 让它跳过错误继续;结束时会输出错误清单到 errors.log。
Q:能不能把 CLI 集成到 CI?
A:可以。用 COMBO_API_KEY 环境变量注入,--format json 让输出易于机器解析。