用途:zep CLI 用于通过命令行检查或操作 ZeP(Ze Experiments Platform)中的实验、运行、数据集、抓取器、后端、存储和 API 令牌,避免抓取网页界面。
主要能力:支持本地凭据登录与“Sign in with Zerg”SSO;可创建、列出、吊销带作用域的自动化令牌;可查看集成 API 能力(版本、作用域、资源);可列出实验、运行、数据集、后端,并提交运行。
使用方式:默认在 /Users/idanbeck/zerg-ze/ze 下运行,可用 poetry run zep ... 或已安装到 PATH 时直接 zep ...。配置位于 ~/.zep/config.json,环境变量 ZEP_API_URL、ZEP_TOKEN、ZEP_API_KEY、ZEP_WORKSPACE_ID、ZEP_CONFIG_PATH 可覆盖文件配置。默认 API 地址为 http://localhost:8080,可用 zep config set-api-url <url> 设置。认证示例:zep auth login you@example.com、zep auth whoami;SSO 示例:zep auth login you@zergai.com --sso。创建令牌示例:zep auth token create --name agent --workspace 1 --scopes experiment:read,run:read,dataset:read,run:write --expires-in-days 30,原始 zep_... 令牌仅打印一次,建议用 export ZEP_TOKEN=zep_xxxxxxxx 保存。常用命令包括 zep discovery、zep experiments list、zep runs list、zep runs submit <experiment> --backend modal、zep datasets list、zep backends list。可用 --workspace <id> 或 ZEP_WORKSPACE_ID 指定工作区。
作用域:格式为 <resource>:<action>,如 run:read、experiment:write;:write 隐含 :read,具体以 zep discovery 为准,令牌作用域不能超过创建者自身权限。
限制与安全:除非用户要求,不要提交运行、取消或删除;任何变更命令前先显示目标工作区;不要把原始 zep_... 令牌输出到日志或聊天;自动化应使用窄作用域的 zep_ 令牌,而非操作员会话令牌。