Itô Compute
使用规范的 Itô 计算 CLI 或 MCP 服务器。ECC 不实现并行客户端、本地模拟、预留、工作负载运行器或推理服务器。ECC 本身不执行任何浏览器自动化。
安装本地规范包
ito-compute-cli 目前未发布。请从其规范仓库构建,而不是使用 npx、npm exec 或未经验证的包:
git clone https://github.com/Ito-Markets/ito-cloud-runtime.git
cd ito-cloud-runtime/cli/ito-compute-cli
npm ci
npm run check
将 ECC_ITO_CLI_EXECUTABLE 设置为构建后的显式绝对入口:
/absolute/path/to/ito-cloud-runtime/cli/ito-compute-cli/dist/bin/ito.js
ECC 永远不会通过 PATH 发现此承载凭据的客户端。ecc ito login 执行设备授权,并且永远不会继承 ITO_API_KEY。仅用于验证的 auth、以及 find 和 status 会在配置时直接转发 ITO_API_KEY;不需要 ITO_AUTH_MODE=legacy。切勿将密钥或令牌放入参数、跟踪文件、MCP 结果、日志或聊天中。
CLI 工作流程
-
在首次操作之前运行
ecc ito login。ECC 将此委托给规范 CLI 的设备授权,该授权默认会打开 Itô 验证页面,并在 macOS Keychain 中持久化设备令牌。使用ecc ito login --no-browser可抑制页面跳转。ECC 本身不执行浏览器自动化。如果发起代理无法完成已登录的浏览器步骤,请将确切的命令交给用户;审批完成后,返回原始任务并继续使用ecc ito auth。设备令牌默认使用 macOS Keychain。文件令牌回退是显式的,其目录和令牌文件必须保持仅所有者可访问(0700 和 0600)。 -
运行
ecc ito auth以验证现有凭据;它从不启动登录,并且拒绝--no-browser。 -
在
ecc ito find之前,获得明确的买方授权以提交 RFQ。- 需要
gpu、count、整数days、max-rate、nodes、gpus-per-node、storage-tb、start-window、form-factor、contract-type、fabric、region以及 split-fill 决策。 - 需要
count == nodes * gpus-per-node;切勿推导拓扑。 - 仅当买方明确接受任意 fabric 或 region 时使用
any。 - 省略的
--allow-split表示 false。
- 需要
-
运行实时 RFQ 命令:
ecc ito find \ --gpu h200 \ --count 8 \ --nodes 1 \ --gpus-per-node 8 \ --days 30 \ --storage-tb 1 \ --start-window 2099-08-15 \ --max-rate 3.00 \ --form-factor bare_metal \ --contract-type reservation \ --fabric infiniband \ --region us-east-1 -
运行
ecc ito status以检查 RFQ 和采购订单。在出现模棱两可的传输失败后,在重复find之前先检查状态。 -
当报价准备好且买方明确批准时,接受它:
ecc ito accept rfq_<ticket-id>这会将工单路由给人工审核的 desk。它不会移动资金或预留容量。未经明确买方授权,请勿接受。
-
当用户明确要求吊销此设备时,运行
ecc ito logout。当远程吊销失败时,规范 CLI 会保留本地凭据以便操作员重试;切勿手动删除令牌作为替代。
库存价格仅供参考。RFQ 并非预留容量。仅当规范结果包含非空的 firm quote 时,才将费率视为固定。
实时节点认证
ecc ito evals 将规范 CLI 的窄实时适配器暴露给单独安装的 sixtytwo-cli==0.3.33。它不通过 ECC 暴露本地 fixture 执行。
在调用它之前需要满足以下所有条件:
- 操作员授权联系指定节点;
ITO_ENABLE_SIXTYTWO_LIVE=1;--live-sixtytwo;- 一个显式的节点列表;以及
- 一个包含
sixtytwo.yaml的现有绝对配置目录。
ecc ito evals \
--cluster clu_prod_example \
--live-sixtytwo \
--nodes gpu-01,gpu-02 \
--config-dir /absolute/path/to/qualification-config
规范适配器只能对显式节点运行固定版本检查和 sixtytwo test --full。它不能租赁、启动、恢复、修复、重置、购买或订购资源。ECC 不会将 ITO_API_KEY 或模型/云凭据转发到节点认证。
MCP 工作流程
构建规范包,然后使用绝对路径配置 stdio 服务器:
{
"mcpServers": {
"ito-compute": {
"command": "node",
"args": [
"/absolute/path/to/ito-cloud-runtime/cli/ito-compute-cli/dist/bin/ito-mcp.js"
]
}
}
}
服务器仅暴露:
ito_authito_findito_statusito_accept
ito_auth 验证现有凭据;它不启动设备登录。使用 ito_auth,收集明确的买方授权和所有硬约束,调用 ito_find,然后在需要时轮询 ito_status。当报价准备好且买方明确批准时,使用工单 ID 调用 ito_accept。Desk 报价通常仅供参考且无约束力,直到 desk 确认;结果中包含 quote_class。
租赁或购买语义
find 提交 RFQ 并可能返回 firm quote,但它不会租赁、购买、预留、配置或移动资金。accept 将报价路由到 desk 进行人工审核;它不移动资金或预留容量。status 是只读的,尽管提供商端点可能协调现有采购订单。ECC 帮助中的被动仪表板链接是单独的用户操作 Web 路由;不要将其打开或操作用作缺失 CLI 功能的替代方案。
不支持的操作
支持的客户端表面无法锁定报价、预留容量、执行工作负载或提供推理服务。accept 是一个 desk 交接,而不是购买。MCP 服务器不暴露认证功能;请使用上面显式的 CLI 命令。不要发明额外的工具或购买路径。当本地 CLI 缺失或实时操作失败时,不要使用浏览器或 fixture 替代。报告缺失的功能并停止。