2千瓦CLI( 2kw.ai CLI)
命令行接口 2kw.ai (英语) ——由欧盟主办的AI集成平台. 运行 策略驱动的文档提取,路由 LLM 调用 OpenAI 兼容网关,转录音频,并管理提示,数据集,以及实验——从终端或内部代理工作流程.
安装三个等同的二进制 : 2kw, (中文(简体) ), backbone,以及 bb。 。 。 .
安装
# Latest stable release
npm install -g @2kw/ai
# Pre-release (dev channel)
npm install -g @2kw/ai@dev
CLI 更新版本时通知您 .
快速启动
# Authenticate — opens your browser, no API key needed (7-day free trial)
2kw auth login
# Define a schema and run an extraction
2kw schemas create -n "Invoice"
2kw extractions create --schema <id> -m gpt-4o --text "Invoice #123, Total: €500"
# Convert and transcribe
2kw convert file report.docx --format md
2kw transcribe call.mp3 --format srt
# Chat through the gateway
2kw ai chat -m gpt-4o --message "Draft a summary of this quarter's extraction volume"
所有命令都与 bb 用于快速访问——例如:. bb schemas list。 。 。 .
认证
通过浏览器签名( 建议) :
2kw auth login
这打开了您的浏览器, 要求您确认一个短代码, 并签名 CLI
在您的用户账户中——没有 API 密钥可以复制。 您的会期为7天
在继续使用CLI的同时,不活动并自我更新. 如果你是属于
您在登录时选择了多个组织, 并且可以随时切换
2kw context set-org - 不需要重新登记. 2kw auth logout 清除当地
证书并签名会话出服务器侧( 最佳效果) .
用于 CI 、 脚本或空接机, 可存储 Org API 密钥 (在设置下创建 ~ 在网络应用中的 API 密钥 ) :
2kw auth login --api-key sk_... # save a key directly
2kw auth login --manual # prompted setup (legacy flow)
明确 API 密钥总是优先于存储的浏览器会话 (最高优先):
| 方法 | 示例 |
|---|---|
| CLI 旗帜 | --api-key sk_... --base-url https://... |
| 环境变量 | AI_2KW_API_KEY, (中文(简体) ), AI_2KW_BASE_URL (遗产: BACKBONE_*(中文(简体) ) |
当地 .2kw 文件 | 当前目录中的 JSON 文件( legacy : .backbone(中文(简体) ) |
| 配置存储 | 设定通过 2kw auth login (浏览器会话或保存密钥) |
2kw auth status # Verify credentials (works for both auth types)
2kw auth logout # Clear credentials and send a server-side sign-out
说明: config get apiKey --json 返回被遮蔽的值——存储的机密
默认情况下不是绕行通过 stdout 。 需要原始密钥通过的脚本
--reveal (单位:千美元)config get apiKey --reveal)或使用 AI_2KW_API_KEY。 。 。 .
背景情况
kubectl 风格的环境在组织与环境之间切换:
2kw context list # List all contexts
2kw context use acme-corp # Switch active context
2kw context create staging --base-url https://api.staging.example # Create a context, sign in through the browser
2kw context create ci --api-key sk_... # Or store an API key instead
2kw config set memory true 使 API- key 上下文发送 X-Backbone-Memory: enabled 打开 ai respond 财务报告和审定财务报表 agents run 电话,它选择这些 进入代理内存; AI_2KW_MEMORY=true|false 超过每个外壳。 从浏览器- 日志( 会话) 上下文运行, 无论设置如何, 总是符合代理内存的条件, 所以 memory false 只影响 API- key 上下文.
图标
| 命令 | 说明 |
|---|---|
auth | 登录、 登录和检查认证状态 |
config | 获取、设置和列表配置值 |
context | 管理多个类群/环境的背景 |
schemas | 管理计划、版本、标签、验证和测试 |
prompts | 版本的即时管理、标签、汇编、测试 |
extractions | 创建提取( 文本、 文件、 图像)、 列表、 重运行、 估计符号) |
convert | 将 PDF、DOCX、XLSX、图像和20+格式转换为 Markdown/text/HTML/JSON |
ai | 通过OpenAI兼容网关聊天完成、答复(代理或直接模式)和模式上市 |
transcribe | 转录音频( FLAC, MP3, MP4, OGG, WAV, WebM) |
datasets | 为评价建立数据集和数据集版本 |
experiments | 对照数据集运行实验 |
evaluators | 管理评价模板 |
scores | 记录和检查质量分数 |
tracing | 检查请求跟踪和追踪设置 |
memory | 您的代理内存文件( 列表、 读取、 写入、 删除、 忘记); 成员总数和管理员的消除 |
providers | 管理 BYOK AI 提供者 |
analytics | 用法分析:操作、指使、质量、提供者、出错 |
billing | 检查订阅级别和使用限制 |
agents | 运行代理并回答暂停运行(批准和中继工具呼叫); 应用,导出和脚手架代理. Yaml; 管理版本、标签、批准和工具目录 |
skills | 导入并导出 SKILL.md 捆绑; 管理技能版本和标签 |
plugins | 安装插件寄存器、同步并检查其报告 |
conversations | 创建和管理对话框及其项目 |
knowledge | 管理知识库、文件、搜索和引用 |
files | 上传、下载和管理文件 |
installations | 管理地表装置、密钥、来源和配对 |
docs | 从终端浏览 API 文档 |
全球选项
| 旗帜 | 说明 |
|---|---|
--api-key <key> | 覆盖 API 密钥 |
--base-url <url> | 覆盖基础 URL( 默认为 2kw.ai 云 API) |
--json | 输出原始的 JSON 而不是格式化的表格——用于脚本和代理 |
--no-color | 禁用彩色输出 |
为什么是2kw.ai
- 欧盟数据居住情况 由Manfred Kunze Development GmbH(德国)运营的符合GDPR的内置模型和欧盟托管的模型
- 底分数 ——每一个取出的价值链接回溯到源文件的出处
- 一个平台 网关、取出、抄录和可观察性共用一个API和一个账单
相关
- 2kw.ai (英语) ——平台概况和定价
- 文档 完全命令和API 参考
@2kw/ai-mcp-server用于 Claude 代码、 Cursor 和 Windsurf 的 2kw.ai MCP 服务器
许可证
专有——见 自由主义 详细情况.