wehub-resource-sync
84 lines
2.0 KiB
Markdown
84 lines
2.0 KiB
Markdown
# 命令行工具
|
||
|
||
`yuxi-cli` 是 Yuxi 的命令行客户端，适合在本地脚本或终端中管理远程实例、登录账号、上传知识库文件，以及运行部分智能体任务。
|
||
|
||
## 安装
|
||
|
||
推荐使用 `uv` 或 `pipx` 安装：
|
||
|
||
```bash
|
||
uv tool install yuxi-cli
|
||
```
|
||
|
||
也可以临时运行：
|
||
|
||
```bash
|
||
uvx --from yuxi-cli yuxi --help
|
||
```
|
||
|
||
安装后可通过 `yuxi --version` 查看当前版本。
|
||
|
||
## 配置远程实例
|
||
|
||
先添加一个 Yuxi 实例地址，再设为当前默认 remote：
|
||
|
||
```bash
|
||
yuxi remote add local http://localhost:5173
|
||
yuxi remote use local
|
||
yuxi remote ping
|
||
```
|
||
|
||
配置会保存在 `~/.yuxi/config.toml`。如果需要同时管理多个实例，可以继续添加其他 remote，并通过 `yuxi remote use <name>` 切换。
|
||
|
||
## 登录
|
||
|
||
默认使用浏览器授权登录：
|
||
|
||
```bash
|
||
yuxi login --browser
|
||
```
|
||
|
||
如果已经在 Yuxi 中创建了 API Key，也可以直接导入：
|
||
|
||
```bash
|
||
yuxi login --api-key yxkey_xxx
|
||
```
|
||
|
||
常用账号状态命令：
|
||
|
||
```bash
|
||
yuxi whoami
|
||
yuxi status
|
||
yuxi logout
|
||
```
|
||
|
||
## 上传知识库文件
|
||
|
||
上传目录时，如果不指定 `--kb-id`，CLI 会拉取当前 remote 中可用的知识库并在终端中选择：
|
||
|
||
```bash
|
||
yuxi kb upload ./docs
|
||
```
|
||
|
||
默认会选择常见文本和 Office 文档类型，可在预览阶段调整文件类型；也可以通过参数直接指定：
|
||
|
||
```bash
|
||
yuxi kb upload ./docs --kb-id kb_xxx --concurrency 4
|
||
yuxi kb upload ./docs --include-ext md,html,docx
|
||
```
|
||
|
||
CLI 会让每个并发单元完成单个文件的上传和文档记录添加，`--concurrency` 默认 10，允许范围 1-300，用于控制同时处理的文件数。上传会保留目录中的相对路径，便于在知识库文件列表中按原目录结构查看。
|
||
|
||
## 运行智能体评估
|
||
|
||
如果实例已配置 Langfuse 数据集，可以用 CLI 触发智能体评估：
|
||
|
||
```bash
|
||
yuxi agent eval \
|
||
--dataset-name demo-dataset \
|
||
--agent-slug default-agent \
|
||
--experiment-name cli-demo
|
||
```
|
||
|
||
该命令会读取 Langfuse 数据集输入，调用 Yuxi 智能体运行，并把结果回传到对应实验中。
|