关于 cuopt-server-common
这是一项介绍 cuOpt Server REST API 概念与流程的 Agent Skill,涵盖优化问题类型、部署方式,以及提交请求并轮询结果的步骤。
主要功能
- 01整理 REST API 概念
- 02说明 Routing、LP、MILP 支持范围
- 03通过 reqId 轮询结果
- 04介绍主要端点
适用场景
- 01设计 cuOpt REST 请求
- 02确认优化 API 的使用条件
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nvidia/ skills --skill cuopt-server-common安装后在 Claude Code 中输入/cuopt-server-common确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
BENCHMARK.mdskill-card.mdskill.oms.sigevals/evals.json详细介绍
cuOpt 服务端(通用)
cuOpt REST 服务端的领域概念。此处不包含部署命令或客户端代码。
服务端的功能
- 通过 HTTP 接收优化请求(Routing、LP、MILP)。
- 返回请求 ID;通过轮询该 ID 获取解。
- 不支持通过 REST 使用 QP。
支持的问题类型
| 问题类型 | 是否支持 |
|---|---|
| Routing | ✓ |
| LP | ✓ |
| MILP | ✓ |
| QP | ✗ |
请求流程(概念性)
- 客户端按照所需的架构发送问题数据(矩阵、任务、车队、求解器配置)。
- 服务端返回一个
reqId。 - 客户端使用
reqId轮询解的端点,直到任务完成。 - 响应包含状态;成功时还包含解(路线、目标值、原始值等)。
必须确认的问题(部署和使用)
如果尚不明确,请询问以下问题:
- 问题类型——Routing 还是 LP/MILP?(不支持 QP。)
- 部署方式——本地、Docker、Kubernetes 还是云端?
- 客户端——哪个语言或工具将调用 API(例如 Python、curl 或其他服务)?
主要端点(概念性)
- 健康检查。
- 提交请求(POST)。
- 根据请求 ID 获取解(GET)。
- OpenAPI 规范(例如用于查看负载格式)。
评论
支持 Markdown