mirror of https://github.com/modelstudioai/cli.git synced 2026-09-14 19:49:23 +08:00

Files

T

zeyu.fz ca69316446 feat(cli): 新增 knowledge search 和 knowledge chat 命令支持

- 在 CLI 命令中添加 knowledgeSearch 和 knowledgeChat 两个新命令
- 新增 knowledge 搜索命令，支持多模态图像检索及对话历史上下文传递
- 新增 knowledge 问答命令，支持多轮消息流式回答及多模态输入
- 在核心客户端库（core）中添加对应的 API 端点和类型定义
- 知识库检索接口 retrieve 标注为弃用，推荐使用 search 命令替代
- 更新 kscli 主程序入口，接入新命令并兼容旧命令
- 补充 e2e 测试覆盖 knowledge search 和 knowledge chat 的各类边界与流程
- 更新文档及命令示例，实现使用说明同步最新功能
- 增加测试配置，改善 E2E 测试环境与超时设置

2026-06-26 15:52:44 +08:00

3.1 KiB

Raw Permalink Blame History

Knowledge Studio CLI

阿里云 Model Studio 轻量级 RAG 命令行工具 — 专注知识库检索。

Knowledge Studio 控制台 · English · API 文档

这是什么？

kscli 是阿里云 Model Studio (DashScope) 平台的知识库检索专用命令行工具，专为 RAG（检索增强生成）场景打造。

安装

npm install -g knowledge-studio-cli

需要 Node.js >= 22.12。

快速开始

# 检索知识库
kscli search \
  --query "什么是 Model Studio？" \
  --agent-id <your-agent-id> \
  --workspace-id <your-workspace-id>

# 知识库问答
kscli chat \
  --message "什么是RAG？" \
  --agent-id <your-agent-id> \
  --workspace-id <your-workspace-id>

命令列表

命令	说明
`search`	知识库语义检索（RAG）
`chat`	知识库问答（流式输出）
`retrieve`	查询知识库（已弃用，请使用 `search`）
`config show`	显示当前配置
`config set`	设置配置项
`update`	自更新到最新版本

认证方式

推荐使用 DashScope API Key 进行认证。前往 DashScope 控制台获取。

# 方式一：环境变量
export DASHSCOPE_API_KEY=sk-xxxxx

# 方式二：登录命令（持久化到 ~/.bailian/config.json）
kscli config set --key api_key --value sk-xxxxx

# 方式三：命令行参数
kscli search --api-key sk-xxxxx --query "..." --agent-id <id> --workspace-id <id>

配置

# 查看当前配置
kscli config show

# 设置默认值
kscli config set --key base_url --value https://dashscope-us.aliyuncs.com
kscli config set --key timeout --value 600

# 自更新
kscli update

配置文件位置：~/.bailian/config.json

资源	地址
Knowledge Studio 控制台	https://rag.console.aliyun.com/
DashScope API 文档	https://help.aliyun.com/zh/model-studio/
获取 API Key	https://bailian.console.aliyun.com/?tab=app#/api-key

参与贡献

欢迎提 Issue、Feature Request 和 PR。开发环境搭建与贡献流程请见 CONTRIBUTING.zh.md。

许可证

Apache 2.0

3.1 KiB Raw Permalink Blame History Unescape Escape