使用 CLI

moi-cli 用于在终端或脚本中操作 AI Studio 资源。使用前,请先前往 MOI-CLI 下载 获取对应平台的预编译二进制程序。

全部命令和任务见 CLI

1. 配置服务地址和凭据

访问凭据中创建个人访问令牌,再运行:

moi-cli config set-endpoint "https://api.moi.matrixorigin.cn/v5"
moi-cli config set-api-key "<个人访问令牌>"

服务地址使用 https://api.moi.matrixorigin.cn/v5。命令行参数可能进入终端历史;只在受保护的本地环境中执行凭据配置。

2. 获取并设置工作区 ID

AI Studio CLI 的功能需要在工作区中使用。调用工作流、知识库、数据或智能体等功能前,先选择目标工作区并设置工作区 ID。

moi-cli -o workspace list
export WORKSPACE_ID='<列表中的工作区 ID>'
moi-cli config set-workspace "$WORKSPACE_ID"

从列表中选择目标工作区 ID 并保存;也可以在控制台中复制工作区 ID。工作区列表成功返回表示服务地址和个人访问令牌可用;后续操作工作区资源的命令使用这里设置的工作区 ID。

3. 调用示例

本示例调用“查看工作流列表”功能。使用第 2 步设置的工作区 ID,列出当前身份可以读取的工作流:

moi-cli -o workflow list --workspace-id "$WORKSPACE_ID"

命令成功后输出 JSON 格式的工作流列表。需要检查当前配置时,运行 moi-cli config show;输出中的 api_key 应以遮蔽形式显示。

下一步

最后更新于